svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
mount_nfs(8)
mount_nfs(8) System Administration Commands mount_nfs(8)
NAME
mount_nfs - mount remote NFS resources
SYNOPSIS
mount [-F nfs] [generic_options] [-o specific_options] [-O] resource
mount [-F nfs] [generic_options] [-o specific_options] [-O] mount_point
mount [-F nfs] [generic_options] [-o specific_options]
[-O] resource mount_point
DESCRIPTION
The mount utility attaches a named resource to the file system hierar‐
chy at the pathname location mount_point, which must already exist. If
mount_point has any contents prior to the mount operation, the contents
remain hidden until the resource is once again unmounted.
mount_nfs starts the lockd(8) and statd(8) daemons if they are not al‐
ready running.
If the resource is listed in the /etc/vfstab file, the command line can
specify either resource or mount_point, and mount consults /etc/vfstab
for more information. If the -F option is omitted, mount takes the file
system type from /etc/vfstab.
If the resource is not listed in the /etc/vfstab file, then the command
line must specify both the resource and the mount_point.
host can be an IPv4 or IPv6 address string. As IPv6 addresses already
contain colons, enclose host in a pair of square brackets when specify‐
ing an IPv6 address string. Otherwise the first occurrence of a colon
can be interpreted as the separator between the host name and path, for
example, [1080::8:800:200C:417A]:tmp/file. See inet(4P) and inet6(4P).
host:pathname
Where host is the name of the NFS server host, and pathname is the
path name of the directory on the server being mounted. The path
name is interpreted according to the server's path name parsing
rules and is not necessarily slash-separated, though on most
servers, this is the case.
nfs://host[:port]/pathname
This is an NFS URL and follows the standard convention for NFS URLs
as described in NFS URL Scheme, RFC 2224. See the discussion of
URLs and the public option under NFS FILE SYSTEMS for a more de‐
tailed discussion.
host:pathname nfs://host[:port]/pathname
host:pathname is a comma-separated list of host:pathname.
See the discussion of replicated file systems and failover under
NFS FILE SYSTEMS for a more detailed discussion.
hostlist pathname
hostlist is a comma-separated list of hosts.
See the discussion of replicated file systems and failover under
NFS FILE SYSTEMS for a more detailed discussion.
The mount command maintains a table of mounted file systems in
/etc/mnttab, described in mnttab(5).
mount_nfs supports both NFSv3 and NFSv4 mounts. The default NFS version
is NFSv4.
SMF Management
The NFS client service is managed by the Service Management Facility
(SMF) under the following service identifier:
svc:/network/nfs/client:default
Note -
The nfs/client service does not need to be enabled for manual mounts
or when using autofs maps. The sole purpose of the nfs/client service
is to mount the NFS filesystems that are listed in /etc/vfstab with
the "mount at boot" field set to "yes".
See the smf(7) man page for more information about SMF. Use the svcs(1)
command to query the status of the service. Administrative actions such
as enabling, disabling, or restarting the service can be performed by
using the svcadm(8) command.
OPTIONS
See mount(8) for the list of supported generic_options. See
share_nfs(8) for a description of server options.
-o specific_options
Set file system specific options according to a comma-separated
list with no intervening spaces.
acdirmax=n
Hold cached attributes for no more than n seconds after direc‐
tory update. The default value is 60.
acdirmin=n
Hold cached attributes for at least n seconds after directory
update. The default value is 30.
acl | noacl
If noacl is specified, then NFS client will not issue ACL-re‐
lated RPCs using the NFS_ACL protocol. The default value is de‐
termined by the client_nfs23_acl property, which can be changed
using sharectl(8). This option is relevant only for NFSv3 or
NFSv2 mounts; it is silently ignored for NFSv4. The noacl op‐
tion should only be used when no files in the specified re‐
source have an ACL.
acregmax=n
Hold cached attributes for no more than n seconds after file
modification. The default value is 60.
acregmin=n
Hold cached attributes for at least n seconds after file modi‐
fication. The default value is 3.
actimeo=n
Set min and max times for regular files and directories to n
seconds. See "File Attributes," below, for a description of the
effect of setting this option to 0.
See "Specifying Values for Attribute Cache Duration Options,"
below, for a description of how acdirmax, acdirmin, acregmax,
acregmin, and actimeo are parsed on a mount command line.
bg | fg
If the first attempt fails, retry in the background, or, in the
foreground. The default is fg.
forcedirectio | noforcedirectio
If forcedirectio is specified, then for the duration of the
mount, forced direct I/O is used. If the filesystem is mounted
using forcedirectio, data is transferred directly between
client and server, with no buffering on the client. If the
filesystem is mounted using noforcedirectio, data is buffered
on the client. forcedirectio is a performance option that is of
benefit only in large sequential data transfers. The default
behavior is noforcedirectio.
grpid
By default, the GID associated with a newly created file obeys
the System V semantics; that is, the GID is set to the effec‐
tive GID of the calling process. This behavior can be overrid‐
den on a per-directory basis by setting the set-GID bit of the
parent directory; in this case, the GID of a newly created file
is set to the GID of the parent directory (see open(2) and
mkdir(2)). Files created on file systems that are mounted with
the grpid option obeys BSD semantics independent of whether the
set-GID bit of the parent directory is set; that is, the GID is
unconditionally inherited from that of the parent directory.
hard | soft
Continue to retry requests until the server responds (hard) or
give up and return an error (soft). The default value is hard.
Note that NFSv4 clients do not support soft mounts. If a user
specifies soft option for NFSv4 mount, this mount option is
silently ignored.
intr | nointr
Allow (do not allow) keyboard interrupts to kill a process that
is hung while waiting for a response on a hard-mounted file
system. The default is intr, which makes it possible for
clients to interrupt applications that can be waiting for a re‐
mote mount.
llock
Use local locking (no lock manager). Note that this is a pri‐
vate interface.
noac
Suppress data and attribute caching. The data caching that is
suppressed is the write-behind. The local page cache is still
maintained, but data copied into it is immediately written to
the server.
nocto
Do not perform the normal close-to-open consistency. When a
file is closed, all modified data associated with the file is
flushed to the server and not held on the client. When a file
is opened the client sends a request to the server to validate
the client's local caches. This behavior ensures a file's con‐
sistency across multiple NFS clients. When nocto is in effect,
the client does not perform the flush on close and the request
for validation, allowing the possibility of differences among
copies of the same file as stored on multiple clients.
This option can be used where it can be guaranteed that ac‐
cesses to a specified file system are made from only one client
and only that client. Under such a condition, the effect of
nocto can be a slight performance gain.
nommaplockcheck
Bypass the memory mapping/locking check. Normally, the client
checks for combinations of mmap(2) and fcntl(2) calls that
could lead to file corruption. The nommaplockcheck option dis‐
ables those checks. It should only be used when it can be guar‐
anteed that mapped-file I/O, which involves whole pages whether
or not the entire page is locked, will not conflict with byte-
range locks held by other clients.
noresvport
Use randomized, non-privileged ports to contact NFS servers. By
default, mounts will use privileged ports (port numbers below
1024), counting down from 1023. With this mount option set, use
ports 1024 and above picked at random. This can help avoid re‐
connection delays and issues in virtualized environments.
port=n
The server IP port number. The default is NFS_PORT. If the port
option is specified, and if the resource includes one or more
NFS URLs, and if any of the URLs include a port number, then
the port number in the option and in the URL must be the same.
posix
Request POSIX.1 semantics for the file system. Requires a mount
version 2 mountd(8) on the server. See standards(7) for infor‐
mation regarding POSIX.
proto=netid | rdma
By default, the transport protocol that the NFS mount uses is
the first available RDMA transport supported both by the client
and the server. If no RDMA transport is found, then it attempts
to use a TCP transport or, failing that, a UDP transport, as
ordered in the /etc/netconfig file. If it does not find a con‐
nection oriented transport, it uses the first available connec‐
tionless transport.
Use this option to override the default behavior.
proto is set to the value of netid or rdma. netid is the value
of the network_id field entry in the /etc/netconfig file.
The UDP protocol is not supported for NFS version 4. If you
specify a UDP protocol with the proto option, NFS version 4 is
not used.
The RDMA transport is only supported in global zones and kernel
zones. It is not supported within non-global zones.
public
The public option forces the use of the public file handle when
connecting to the NFS server. The resource specified might not
have an NFS URL. See the discussion of URLs and the public op‐
tion under NFS FILE SYSTEMS for a more detailed discussion.
quota | noquota
Enable or prevent quota(8) to check whether the user is over
quota on this file system; if the file system has quota enabled
on the server, quota(8) checks a file system only if the quota
mount option is also set on the NFS client.
remount
Remounts a read-only file system as read-write (using the rw
option). This option cannot be used with other -o options, and
this option works only on currently mounted read-only file sys‐
tems.
retrans=n
Set the number of NFS retransmissions to n. The default value
is 5. For connection-oriented transports, this option has no
effect because it is assumed that the transport performs re‐
transmissions on behalf of NFS.
retry=n
The number of times to retry the mount operation. The default
for the mount command is 10000.
The default for the automounter is 0, in other words, do not
retry. You might find it useful to increase this value on heav‐
ily loaded servers, where automounter traffic is dropped, caus‐
ing unnecessary server not responding errors.
rsize=n
Set the read buffer size to a maximum of n bytes. The default
value is 1048576 when using connection-oriented transports with
version 3 or version 4 of the NFS protocol, and 32768 when us‐
ing connection-less transports. The default can be negotiated
down if the server prefers a smaller transfer size. "Read" op‐
erations may not necessarily use the maximum buffer size. When
using version 2, the default value is 32768 for all transports.
If a value lower than a system-defined minimum is specified, it
is replaced by the minimum value (currently 1024). However, a
server will be able to negotiate a transfer size that is
smaller than the minimum.
sec=mode
Set the security mode for NFS transactions. If sec= is not
specified, then the default action is to use AUTH_SYS over NFS
version 2 mounts, use a user-configured default auth over NFS
version 3 mounts, or to negotiate a mode over version 4 mounts.
The preferred mode for NFS version 3 mounts is the default mode
specified in /etc/nfssec.conf (see nfssec.conf(5)) on the
client. If there is no default configured in this file or if
the server does not export using the client's default mode,
then the client picks the first mode that it supports in the
array of modes returned by the server. These alternatives are
limited to the security flavors listed in /etc/nfssec.conf.
NFS version 4 mounts negotiate a security mode when the server
returns an array of security modes. The client attempts the
mount with each security mode, in order, until one is success‐
ful.
Only one mode can be specified with the sec= option. See nf‐
ssec(7) for the available mode options.
timeo=n
Sets the NFS timeout to n tenths of a second. This value is
primarily useful for connectionless transports, where manual
tuning may be useful to improve performance. The default value
is 11 tenths of a second for connectionless transports.
This value has no effect when using an RDMA transport.
For connection-oriented transports, the default value is 600
tenths of a second. There is usually no need to change this
value because the underlying transport will manage its own re‐
transmissions. One exception is replicated file systems, where
a smaller timeout can improve failover performance.
vers=NFS version number
Specifies the version of the NFS protocol to use for mounting.
The valid versions for this option are 2, 3, 4, 4.0, and 4.1.
If you do not specify this option, the version used between the
client and the server is the highest version available on both
the systems. If the NFS server does not support the client's
default maximum, the next lower version is considered until a
matching version is found.
The default maximum version for a client is 4 which can result
in either 4.0 or 4.1 mounts depending on the server. This value
can be changed by setting the client_versmax property. For more
information see the sharectl(8) man page.
wsize=n
Sets the write buffer size to a maximum of n bytes. The default
value is 1048576 when using connection-oriented transports with
version 3 or version 4 of the NFS protocol, and 32768 when us‐
ing connection-less transports. The default can be negotiated
down if the server prefers a smaller transfer size. "Write" op‐
erations may not necessarily use the maximum buffer size. When
using version 2, the default value is 32768 for all transports.
If a value lower than a system-defined minimum is specified, it
is replaced by the minimum value (currently 1024). However, a
server will be able to negotiate a transfer size that is
smaller than the minimum.
xattr | noxattr
Allows or disallows the creation and manipulation of extended
attributes. The default is xattr. See fsattr(7) for a descrip‐
tion of extended attributes.
-O
Overlays mount. Allows the file system to be mounted over an exist‐
ing mount point, making the underlying file system inaccessible. If
a mount is attempted on a pre-existing mount point without setting
this flag, the mount fails, producing the error "device busy."
idmap
By default, this option is not used during the mount. If the idmap
mount option is not used, AUTH_SYS authentication is based on the
equality between the client supplied UID/GID in the RPC credential
and UID/GID stored in NFS server. In effect, it disables the nf‐
smapid functionality, which can make migration from legacy NFSv2/v3
systems to NFSv4 easier. NFS clients will automatically detect the
servers which do not support numeric string uids and gids and auto‐
matically fall back to user@domain format.
You can turn off this behavior, that is, turning off numeric
strings uids and gids support, by using the mount option idmap.
NFS FILE SYSTEMS
Hard versus Soft
File systems that are mounted read-write or that contain executable
files should always be mounted with the hard option. Applications
using soft mounted file systems can incur unexpected I/O errors,
file corruption, and unexpected program core dumps. The soft option
is not recommended.
Authenticated requests
The server can require authenticated NFS requests from the client.
See nfssec(7).
URLs and the public option
If the public option is specified, or if the resource includes an
NFS URL, mount attempts to connect to the server using the public
file handle lookup protocol. See WebNFS Client Specification, RFC
2054. If the server supports the public file handle, the attempt is
successful; mount does not need to contact the server's rpcbind(8)
daemon to get the port number of the mount server and contact the
mountd(8) daemon to get the initial file handle of pathname. If the
NFS client and server are separated by a firewall that allows all
outbound connections through specific ports, such as NFS_PORT, then
NFS operations are enabled through the firewall. The public option
and the NFS URL can be specified independently or together. They
interact as specified in the following matrix:
tab() box; lw(1.65i) |lw(1.92i) |lw(1.92i) lw(1.65i) |lw(1.92i)
|lw(1.92i) host:pathnameNFS URL _ public optionT{ Force public
file handle and fail mount if not supported. T}T{ Force public
file handle and fail mount if not supported. T} _ Use Native
paths.Use Canonical paths. _ defaultUse MOUNT protocol.T{ Try pub‐
lic file handle with Canonical paths. If not supported, fail back
to MOUNT protocol. T}
A Native path is a path name that is interpreted according to con‐
ventions used on the native operating system of the NFS server. A
Canonical path is a path name that is interpreted according to the
URL rules. See Uniform Resource Locators (URL), RFC 1738. See "Ex‐
amples," below, for uses of Native and Canonical paths.
Replicated file systems and failover
resource can list multiple read−only file systems to be used to
provide data. These file systems should contain equivalent direc‐
tory structures and identical files. The file systems can be speci‐
fied either with a comma−separated list of host:/pathname entries
and/or NFS URL entries, or with a comma −separated list of hosts,
if all file system names are the same. If multiple file systems are
named and the first server in the list is down, failover uses the
next alternate server to access files. If the read−only option is
not chosen, replication is disabled. File access, for NFS versions
2 and 3, is blocked on the original if NFS locks are active for
that file.
File Attributes
To improve NFS read performance, files and file attributes are cached.
File modification times get updated whenever a write occurs. However,
file access times can be temporarily out-of-date until the cache gets
refreshed.
The attribute cache retains file attributes on the client. Attributes
for a file are assigned a time to be flushed. If the file is modified
before the flush time, then the flush time is extended by the time
since the last modification (under the assumption that files that
changed recently are likely to change soon). There is a minimum and
maximum flush time extension for regular files and for directories.
Setting actimeo=n sets flush time to n seconds for both regular files
and directories.
Setting actimeo=0 disables attribute caching on the client. This means
that every reference to attributes is satisfied directly from the
server though file data is still cached. While this guarantees that the
client always has the latest file attributes from the server, it has an
adverse effect on performance through additional latency, network load,
and server load.
Setting the noac option also disables attribute caching, but has the
further effect of disabling client write caching. While this guarantees
that data written by an application is written directly to a server,
where it can be viewed immediately by other clients, it has a signifi‐
cant adverse effect on client write performance. Data written into mem‐
ory-mapped file pages (mmap(2)) are not written directly to this
server.
Specifying Values for Attribute Cache Duration Options
The attribute cache duration options are acdirmax, acdirmin, acregmax,
acregmin, and actimeo, as described under OPTIONS. A value specified
for actimeo sets the values of all attribute cache duration options ex‐
cept for any of these options specified following actimeo on a mount
command line. For example, consider the following command:
example# mount -o acdirmax=10,actimeo=1000 server:/path /localpath
Because actimeo is the last duration option in the command line, its
value (1000) becomes the setting for all of the duration options, in‐
cluding acdirmax. Now consider:
example# mount -o actimeo=1000,acdirmax=10 server:/path /localpath
Because the acdirmax option follows actimeo on the command line, it is
assigned the value specified (10). The remaining duration options are
set to the value of actimeo (1000).
EXAMPLES
Example 1 Mounting an NFS File System
To mount an NFS file system:
# mount serv:/usr/src /usr/src
This is an example of the use of a native path.
Example 2 Mounting An NFS File System Read-Only With No suid Privileges
To mount an NFS file system read-only with no suid privileges:
# mount -r -o nosuid serv:/usr/src /usr/src
Example 3 Mounting An NFS File System Over Version 2, with the UDP
Transport
To mount an NFS file system over version 2, with the UDP transport:
# mount -o vers=2,proto=udp serv:/usr/src /usr/src
Example 4 Mounting an NFS File System Using An NFS URL
To mount an NFS file system using an NFS URL (a canonical path):
# mount nfs://serv/usr/man /usr/man
Example 5 Mounting An NFS File System Forcing Use Of The Public File
Handle
To mount an NFS file system and force the use of the public file handle
and an NFS URL (a canonical path) that has a non 7-bit ASCII escape se‐
quence:
# mount -o public nfs://serv/usr/%A0abc /mnt/test
Example 6 Mounting an NFS File System Using a Native Path
To mount an NFS file system using a native path (where the server uses
colons (:) as the component separator) and the public file handle:
# mount -o public serv:C:doc:new /usr/doc
Example 7 Mounting a Replicated Set of NFS File Systems with the Same
Pathnames
To mount a replicated set of NFS file systems with the same pathnames:
# mount serv−a,serv−b,serv−c:/usr/man /usr/man
Example 8 Mounting a Replicated Set of NFS File Systems with Different
Pathnames
To mount a replicated set of NFS file systems with different pathnames:
# mount serv−x:/usr/man,serv−y:/var/man,nfs://serv-z/man /usr/man
FILES
/etc/mnttab
Table of mounted file systems
/etc/dfs/fstypes
Default distributed file system type
/etc/vfstab
Table of automatically mounted resources
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Availabilitysystem/file-system/nfs
SEE ALSO
mkdir(2), mmap(2), mount(2), open(2), umount(2), lofs(4FS), inet(4P),
inet6(4P), mnttab(5), nfssec.conf(5), attributes(7), fsattr(7), nf‐
ssec(7), standards(7), lockd(8), mount(8), mountall(8), mountd(8),
nfsd(8), quota(8), sharectl(8), statd(8)
Managing Network File Systems in Oracle Solaris 11.4
Callaghan, Brent, WebNFS Client Specification, RFC 2054, October 1996.
Callaghan, Brent, NFS URL Scheme, RFC 2224, October 1997.
Berners-Lee, Masinter & McCahill, Uniform Resource Locators (URL), RFC
1738, December 1994.
NOTES
An NFS server should not attempt to use NFS to mount the file systems
it serves, unless they are provided by zfs(4FS). For an alternative to
NFS mounts of file systems from the same host, see the lofs(4FS) man
page.
If the directory on which a file system is to be mounted is a symbolic
link, the file system is mounted on the directory to which the symbolic
link refers, rather than being mounted on top of the symbolic link it‐
self.
SunOS 4.x used the biod maintenance procedure to perform parallel read-
ahead and write-behind on NFS clients. SunOS 5.x made biod obsolete
with multi-threaded processing, which transparently performs parallel
read-ahead and write-behind.
Since the root (/) file system is mounted read-only by the kernel dur‐
ing the boot process, only the remount option (and options that can be
used in conjunction with remount) affect the root (/) entry in the
/etc/vfstab file.
HISTORY
The noresvport mount option was added in Oracle Solaris 11.4.72.
The acl and noacl mount options were added in Oracle Solaris 11.4.39.
The nommaplockcheck mount option was added in Oracle Solaris 11.4.24.
The idmap mount option was added in Oracle Solaris 11.4.0.
Support for NFS version 4.1 was added to the vers option in Oracle So‐
laris 11.4.0.
Support for NFS version 4.0 was added to the vers option in Solaris 10
3/05.
The attr and noattr mount options were added in Solaris 9.
The forcedirectio and noforcedirectio mount options were added in So‐
laris 8.
Support for Kerberos version 4, including the kerberos mount option,
was removed in Solaris 8.
The public mount option was added in Solaris 7.
Support for NFS version 3, including the proto, sec, and vers mount op‐
tions, was added in Solaris 2.6.
The posix mount option was added in Solaris 2.1.
Support for NFS mounts, using NFS version 2, has been included in all
Sun and Oracle releases of Solaris.
Oracle Solaris 11.4 13 Sep 2024 mount_nfs(8)