1997-03-11 12:40:45 +00:00
|
|
|
.\" Copyright (c) 1992, 1993, 1994, 1995
|
1994-05-26 06:35:07 +00:00
|
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
2017-02-28 23:42:47 +00:00
|
|
|
.\" 3. Neither the name of the University nor the names of its contributors
|
1994-05-26 06:35:07 +00:00
|
|
|
.\" may be used to endorse or promote products derived from this software
|
|
|
|
.\" without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
1997-03-11 12:40:45 +00:00
|
|
|
.\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95
|
1999-08-28 00:22:10 +00:00
|
|
|
.\" $FreeBSD$
|
2003-05-17 22:53:44 +00:00
|
|
|
.\"
|
2022-07-03 20:37:23 +00:00
|
|
|
.Dd July 2, 2022
|
1994-05-26 06:35:07 +00:00
|
|
|
.Dt MOUNT_NFS 8
|
2001-07-10 11:04:34 +00:00
|
|
|
.Os
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh NAME
|
|
|
|
.Nm mount_nfs
|
2003-05-17 22:53:44 +00:00
|
|
|
.Nd mount NFS file systems
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh SYNOPSIS
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
2009-05-22 12:35:12 +00:00
|
|
|
.Op Fl 23bcdiLlNPsTU
|
1994-05-26 06:35:07 +00:00
|
|
|
.Op Fl a Ar maxreadahead
|
2005-02-10 09:19:34 +00:00
|
|
|
.Op Fl D Ar deadthresh
|
1994-05-26 06:35:07 +00:00
|
|
|
.Op Fl g Ar maxgroups
|
2005-02-10 09:19:34 +00:00
|
|
|
.Op Fl I Ar readdirsize
|
1994-05-26 06:35:07 +00:00
|
|
|
.Op Fl o Ar options
|
2005-02-10 09:19:34 +00:00
|
|
|
.Op Fl R Ar retrycnt
|
1994-05-26 06:35:07 +00:00
|
|
|
.Op Fl r Ar readsize
|
|
|
|
.Op Fl t Ar timeout
|
|
|
|
.Op Fl w Ar writesize
|
|
|
|
.Op Fl x Ar retrans
|
2001-02-01 16:38:02 +00:00
|
|
|
.Ar rhost : Ns Ar path node
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
1998-07-06 07:15:53 +00:00
|
|
|
.Nm
|
2002-07-06 19:34:18 +00:00
|
|
|
utility calls the
|
2007-01-23 07:17:10 +00:00
|
|
|
.Xr nmount 2
|
2003-05-17 22:53:44 +00:00
|
|
|
system call to prepare and graft a remote NFS file system
|
2001-02-01 16:38:02 +00:00
|
|
|
.Pq Ar rhost : Ns Ar path
|
2002-08-21 18:11:48 +00:00
|
|
|
on to the file system tree at the point
|
2001-02-01 16:38:02 +00:00
|
|
|
.Ar node .
|
1994-05-26 06:35:07 +00:00
|
|
|
This command is normally executed by
|
|
|
|
.Xr mount 8 .
|
2019-12-14 21:49:47 +00:00
|
|
|
For NFSv2 and NFSv3,
|
|
|
|
it implements the mount protocol as described in RFC 1094, Appendix A and
|
|
|
|
RFC 1813, Appendix I.
|
|
|
|
For NFSv4, it uses the NFSv4 protocol as described in RFC 7530, RFC 5661 and
|
|
|
|
RFC 7862.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Pp
|
2001-07-21 15:38:37 +00:00
|
|
|
By default,
|
|
|
|
.Nm
|
|
|
|
keeps retrying until the mount succeeds.
|
2002-08-21 18:11:48 +00:00
|
|
|
This behaviour is intended for file systems listed in
|
2001-07-21 15:38:37 +00:00
|
|
|
.Xr fstab 5
|
|
|
|
that are critical to the boot process.
|
2002-08-21 18:11:48 +00:00
|
|
|
For non-critical file systems, the
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm bg
|
2001-07-21 15:38:37 +00:00
|
|
|
and
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm retrycnt
|
|
|
|
options provide mechanisms to prevent the boot process from hanging
|
2001-07-21 15:38:37 +00:00
|
|
|
if the server is unavailable.
|
|
|
|
.Pp
|
2002-08-21 18:11:48 +00:00
|
|
|
If the server becomes unresponsive while an NFS file system is
|
|
|
|
mounted, any new or outstanding file operations on that file system
|
2001-07-21 15:38:37 +00:00
|
|
|
will hang uninterruptibly until the server comes back.
|
|
|
|
To modify this default behaviour, see the
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm intr
|
2001-07-21 15:38:37 +00:00
|
|
|
and
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm soft
|
|
|
|
options.
|
2001-07-21 15:38:37 +00:00
|
|
|
.Pp
|
1994-05-26 06:35:07 +00:00
|
|
|
The options are:
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl o
|
|
|
|
Options are specified with a
|
|
|
|
.Fl o
|
|
|
|
flag followed by a comma separated string of options.
|
|
|
|
See the
|
|
|
|
.Xr mount 8
|
|
|
|
man page for possible options and their meanings.
|
2003-05-17 22:53:44 +00:00
|
|
|
The following NFS specific options are also available:
|
1995-06-14 17:41:04 +00:00
|
|
|
.Bl -tag -width indent
|
2003-05-17 22:53:44 +00:00
|
|
|
.It Cm acregmin Ns = Ns Aq Ar seconds
|
|
|
|
.It Cm acregmax Ns = Ns Aq Ar seconds
|
|
|
|
.It Cm acdirmin Ns = Ns Aq Ar seconds
|
|
|
|
.It Cm acdirmax Ns = Ns Aq Ar seconds
|
1998-07-06 07:15:53 +00:00
|
|
|
When attributes of files are cached, a timeout calculated to determine
|
2003-05-17 22:53:44 +00:00
|
|
|
whether a given cache entry has expired.
|
|
|
|
These four values determine the upper and lower bounds of the timeouts for
|
|
|
|
.Dq directory
|
|
|
|
attributes and
|
|
|
|
.Dq regular
|
|
|
|
(ie: everything else).
|
|
|
|
The default values are 3 -> 60 seconds
|
|
|
|
for regular files, and 30 -> 60 seconds for directories.
|
|
|
|
The algorithm to calculate the timeout is based on the age of the file.
|
|
|
|
The older the file,
|
1998-05-19 07:18:28 +00:00
|
|
|
the longer the cache is considered valid, subject to the limits above.
|
2014-10-30 08:50:01 +00:00
|
|
|
.It Cm actimeo Ns = Ns Aq Ar seconds
|
|
|
|
Set four cache timeouts above to specified value.
|
2013-07-09 01:31:36 +00:00
|
|
|
.It Cm allgssname
|
|
|
|
This option can be used along with
|
|
|
|
.Fl o Cm gssname
|
|
|
|
to specify that all operations should use the host-based initiator
|
|
|
|
credential.
|
|
|
|
This may be used for clients that run system daemons that need to
|
|
|
|
access files on the NFSv4 mounted volume.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm bg
|
|
|
|
If an initial attempt to contact the server fails, fork off a child to keep
|
|
|
|
trying the mount in the background.
|
|
|
|
Useful for
|
|
|
|
.Xr fstab 5 ,
|
|
|
|
where the file system mount is not critical to multiuser operation.
|
2022-01-11 16:20:01 +00:00
|
|
|
.It Cm bgnow
|
|
|
|
Like
|
|
|
|
.Cm bg ,
|
|
|
|
fork off a child to keep trying the mount in the background,
|
|
|
|
but do not attempt to mount in the foreground first.
|
|
|
|
This eliminates a
|
|
|
|
60+ second timeout when the server is not responding.
|
|
|
|
Useful for speeding up the boot process of a client when the server is
|
|
|
|
likely to be unavailable.
|
|
|
|
This is often the case for interdependent servers
|
|
|
|
such as cross-mounted servers (each of two servers is an NFS client of
|
|
|
|
the other) and for cluster nodes that must boot before the file servers.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm deadthresh Ns = Ns Aq Ar value
|
|
|
|
Set the
|
|
|
|
.Dq "dead server threshold"
|
|
|
|
to the specified number of round trip timeout intervals before a
|
|
|
|
.Dq "server not responding"
|
|
|
|
message is displayed.
|
|
|
|
.It Cm dumbtimer
|
|
|
|
Turn off the dynamic retransmit timeout estimator.
|
|
|
|
This may be useful for UDP mounts that exhibit high retry rates,
|
|
|
|
since it is possible that the dynamically estimated timeout interval is too
|
|
|
|
short.
|
|
|
|
.It Cm fg
|
|
|
|
Same as not specifying
|
|
|
|
.Cm bg .
|
2013-07-09 01:31:36 +00:00
|
|
|
.It Cm gssname Ns = Ns Aq Ar service-principal-name
|
|
|
|
This option can be used with the KerberosV security flavors for NFSv4 mounts
|
|
|
|
to specify the
|
|
|
|
.Dq "service-principal-name"
|
|
|
|
of a host-based entry in the default
|
|
|
|
keytab file that is used for system operations.
|
|
|
|
It allows the mount to be performed by
|
|
|
|
.Dq "root"
|
|
|
|
and avoids problems with
|
|
|
|
cached credentials for the system operations expiring.
|
|
|
|
The
|
|
|
|
.Dq "service-prinicpal-name"
|
|
|
|
should be specified without instance or domain and is typically
|
|
|
|
.Dq "host" ,
|
|
|
|
.Dq "nfs"
|
|
|
|
or
|
2020-07-17 21:55:24 +00:00
|
|
|
.Dq "root" ,
|
|
|
|
although the form
|
|
|
|
.Sm off
|
|
|
|
.Aq Ar service
|
|
|
|
@
|
|
|
|
.Aq Ar fqdn
|
|
|
|
.Sm on
|
|
|
|
can also be used if the local system's
|
|
|
|
.Xr gethostname 3
|
|
|
|
value does not match the host-based principal in the keytab.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm hard
|
|
|
|
Same as not specifying
|
|
|
|
.Cm soft .
|
|
|
|
.It Cm intr
|
|
|
|
Make the mount interruptible, which implies that file system calls that
|
|
|
|
are delayed due to an unresponsive server will fail with EINTR when a
|
|
|
|
termination signal is posted for the process.
|
|
|
|
.It Cm maxgroups Ns = Ns Aq Ar value
|
|
|
|
Set the maximum size of the group list for the credentials to the
|
|
|
|
specified value.
|
|
|
|
This should be used for mounts on old servers that cannot handle a
|
|
|
|
group list size of 16, as specified in RFC 1057.
|
|
|
|
Try 8, if users in a lot of groups cannot get response from the mount
|
|
|
|
point.
|
|
|
|
.It Cm mntudp
|
|
|
|
Force the mount protocol to use UDP transport, even for TCP NFS mounts.
|
|
|
|
(Necessary for some old
|
|
|
|
.Bx
|
|
|
|
servers.)
|
2012-01-25 20:05:58 +00:00
|
|
|
.It Cm nametimeo Ns = Ns Aq Ar value
|
|
|
|
Override the default of NFS_DEFAULT_NAMETIMEO for the timeout (in seconds)
|
|
|
|
for positive name cache entries.
|
|
|
|
If this is set to 0 it disables positive name caching for the mount point.
|
2010-01-21 21:21:00 +00:00
|
|
|
.It Cm negnametimeo Ns = Ns Aq Ar value
|
|
|
|
Override the default of NFS_DEFAULT_NEGNAMETIMEO for the timeout (in seconds)
|
2016-09-16 04:28:31 +00:00
|
|
|
for negative name cache entries.
|
|
|
|
If this is set to 0 it disables negative name caching for the mount point.
|
2021-07-11 20:34:16 +00:00
|
|
|
.It Cm nconnect Ns = Ns Aq Ar value
|
|
|
|
Specify the number of TCP connections (1-16) to be used
|
|
|
|
for an NFS Version 4, minor version 1 or 2 mount.
|
|
|
|
Multiple TCP connections can provide more client to server network
|
|
|
|
bandwidth for certain network configurations such as:
|
|
|
|
.Bd -literal
|
|
|
|
- Multiple network interfaces that are aggregated together.
|
|
|
|
- A fast network interface that uses multiple queues.
|
|
|
|
.Ed
|
|
|
|
.sp
|
|
|
|
The first TCP connection will be used for all RPCs that consist
|
|
|
|
entirely of small RPC messages.
|
|
|
|
The RPCs that can have large RPC messages (Read/Readdir/Write) are
|
|
|
|
distributed over the additional TCP connections in a round robin
|
|
|
|
fashion.
|
|
|
|
This option will result in more IP port#s being used.
|
|
|
|
This option requires the
|
|
|
|
.Cm nfsv4
|
|
|
|
option.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm nfsv2
|
|
|
|
Use the NFS Version 2 protocol (the default is to try version 3 first
|
|
|
|
then version 2).
|
|
|
|
Note that NFS version 2 has a file size limit of 2 gigabytes.
|
|
|
|
.It Cm nfsv3
|
|
|
|
Use the NFS Version 3 protocol.
|
2009-05-27 19:56:51 +00:00
|
|
|
.It Cm nfsv4
|
|
|
|
Use the NFS Version 4 protocol.
|
2011-04-28 00:20:35 +00:00
|
|
|
This option will force the mount to use
|
2009-05-27 19:56:51 +00:00
|
|
|
TCP transport.
|
2021-06-26 21:09:28 +00:00
|
|
|
By default, the highest minor version of NFS Version 4 that is
|
|
|
|
supported by the NFS Version 4 server will be used.
|
|
|
|
See the
|
|
|
|
.Cm minorversion
|
|
|
|
option.
|
2012-12-09 21:26:47 +00:00
|
|
|
.It Cm minorversion Ns = Ns Aq Ar value
|
2021-06-26 21:09:28 +00:00
|
|
|
Use the specified minor version for a NFS Version 4 mount,
|
|
|
|
overriding the default.
|
|
|
|
The minor versions supported are 0, 1, and 2.
|
2012-12-09 21:26:47 +00:00
|
|
|
This option is only meaningful when used with the
|
|
|
|
.Cm nfsv4
|
|
|
|
option.
|
2017-04-13 22:05:24 +00:00
|
|
|
.It Cm oneopenown
|
2019-12-14 21:49:47 +00:00
|
|
|
Make a minor version 1 or 2 of the NFS Version 4 protocol mount use a single
|
|
|
|
OpenOwner for all Opens.
|
2017-04-13 22:05:24 +00:00
|
|
|
This may be useful for a server with a very low limit on OpenOwners, such as
|
|
|
|
AmazonEFS.
|
2021-01-18 03:00:41 +00:00
|
|
|
It may be required when an accumulation of NFS version 4 Opens occurs,
|
|
|
|
as indicated by the
|
|
|
|
.Dq Opens
|
|
|
|
count displayed by
|
2021-06-26 21:09:28 +00:00
|
|
|
.Xr nfsstat 1
|
2021-01-18 03:00:41 +00:00
|
|
|
with the
|
|
|
|
.Fl c
|
|
|
|
and
|
|
|
|
.Fl E
|
|
|
|
command-line options.
|
|
|
|
A common case for an accumulation of Opens is a shared library within
|
|
|
|
the NFS mount that is used by several
|
|
|
|
processes, where at least one of these processes is always running.
|
2020-12-01 23:33:10 +00:00
|
|
|
This option cannot be used for an NFS Version 4, minor version 0 mount.
|
2017-04-13 22:05:24 +00:00
|
|
|
It may not work correctly when Delegations are being issued by a server,
|
|
|
|
but note that the AmazonEFS server does not issued delegations at this time.
|
2020-12-01 23:33:10 +00:00
|
|
|
This option is only meaningful when used with the
|
|
|
|
.Cm nfsv4
|
2021-06-26 21:09:28 +00:00
|
|
|
option.
|
2012-12-09 21:26:47 +00:00
|
|
|
.It Cm pnfs
|
2019-12-14 21:49:47 +00:00
|
|
|
Enable support for parallel NFS (pNFS) for minor version 1 or 2 of the
|
2012-12-09 21:26:47 +00:00
|
|
|
NFS Version 4 protocol.
|
|
|
|
This option is only meaningful when used with the
|
2021-06-26 21:09:28 +00:00
|
|
|
.Cm nfsv4
|
2012-12-09 21:26:47 +00:00
|
|
|
option.
|
2014-10-30 08:50:01 +00:00
|
|
|
.It Cm noac
|
|
|
|
Disable attribute caching.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm noconn
|
|
|
|
For UDP mount points, do not do a
|
|
|
|
.Xr connect 2 .
|
|
|
|
This must be used if the server does not reply to requests from the standard
|
|
|
|
NFS port number 2049 or replies to requests using a different IP address
|
|
|
|
(which can occur if the server is multi-homed).
|
|
|
|
Setting the
|
|
|
|
.Va vfs.nfs.nfs_ip_paranoia
|
|
|
|
sysctl to 0 will make this option the default.
|
2011-05-04 13:27:45 +00:00
|
|
|
.It Cm nocto
|
|
|
|
Normally, NFS clients maintain the close-to-open cache coherency.
|
|
|
|
This works by flushing at close time and checking at open time.
|
|
|
|
Checking at open time is implemented by getting attributes from
|
|
|
|
the server and purging the data cache if they do not match
|
|
|
|
attributes cached by the client.
|
|
|
|
.Pp
|
|
|
|
This option disables checking at open time.
|
|
|
|
It may improve performance for read-only mounts,
|
|
|
|
but should only be used if the data on the server changes rarely.
|
|
|
|
Be sure to understand the consequences before enabling this option.
|
2003-05-17 22:53:44 +00:00
|
|
|
.It Cm noinet4 , noinet6
|
|
|
|
Disables
|
|
|
|
.Dv AF_INET
|
|
|
|
or
|
|
|
|
.Dv AF_INET6
|
|
|
|
connections.
|
|
|
|
Useful for hosts that have
|
2003-03-25 01:25:30 +00:00
|
|
|
both an A record and an AAAA record for the same name.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm nolockd
|
|
|
|
Do
|
|
|
|
.Em not
|
|
|
|
forward
|
|
|
|
.Xr fcntl 2
|
2019-12-14 21:49:47 +00:00
|
|
|
locks over the wire via the NLM protocol for NFSv3 mounts.
|
2008-09-13 20:22:46 +00:00
|
|
|
All locks will be local and not seen by the server
|
2019-12-14 21:49:47 +00:00
|
|
|
and likewise not seen by other NFS clients for NFSv3 mounts.
|
2008-09-13 20:22:46 +00:00
|
|
|
This removes the need to run the
|
|
|
|
.Xr rpcbind 8
|
|
|
|
service and the
|
|
|
|
.Xr rpc.statd 8
|
|
|
|
and
|
|
|
|
.Xr rpc.lockd 8
|
|
|
|
servers on the client.
|
|
|
|
Note that this option will only be honored when performing the
|
|
|
|
initial mount, it will be silently ignored if used while updating
|
|
|
|
the mount options.
|
2019-12-14 21:49:47 +00:00
|
|
|
Also, note that NFSv4 mounts do not use these daemons and handle locks over the
|
|
|
|
wire in the NFSv4 protocol.
|
|
|
|
As such, this option is meaningless for NFSv4 mounts.
|
2013-12-08 00:59:04 +00:00
|
|
|
.It Cm noncontigwr
|
|
|
|
This mount option allows the NFS client to
|
|
|
|
combine non-contiguous byte ranges being written
|
|
|
|
such that the dirty byte range becomes a superset of the bytes
|
|
|
|
that are dirty.
|
|
|
|
This reduces the number of writes significantly for software
|
|
|
|
builds.
|
2016-09-16 04:28:31 +00:00
|
|
|
The merging of byte ranges is not done if the file has been file
|
2013-12-08 00:59:04 +00:00
|
|
|
locked, since most applications modifying a file from multiple
|
|
|
|
clients will use file locking.
|
|
|
|
As such, this option could result in a corrupted file for the
|
|
|
|
rare case of an application modifying the file from multiple
|
|
|
|
clients concurrently without using file locking.
|
2009-05-27 19:56:51 +00:00
|
|
|
.It Cm principal
|
|
|
|
For the RPCSEC_GSS security flavors, such as krb5, krb5i and krb5p,
|
|
|
|
this option sets the name of the host based principal name expected
|
2016-09-16 04:28:31 +00:00
|
|
|
by the server.
|
|
|
|
This option overrides the default, which will be ``nfs@<server-fqdn>''
|
|
|
|
and should normally be sufficient.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm noresvport
|
|
|
|
Do
|
|
|
|
.Em not
|
|
|
|
use a reserved socket port number (see below).
|
|
|
|
.It Cm port Ns = Ns Aq Ar port_number
|
|
|
|
Use specified port number for NFS requests.
|
|
|
|
The default is to query the portmapper for the NFS port.
|
2014-10-30 08:50:01 +00:00
|
|
|
.It Cm proto Ns = Ns Aq Ar protocol
|
|
|
|
Specify transport protocol version to use.
|
|
|
|
Currently, they are:
|
|
|
|
.Bd -literal
|
|
|
|
udp - Use UDP over IPv4
|
|
|
|
tcp - Use TCP over IPv4
|
|
|
|
udp6 - Use UDP over IPv6
|
|
|
|
tcp6 - Use TCP over IPv6
|
|
|
|
.Ed
|
2003-05-17 22:53:44 +00:00
|
|
|
.It Cm rdirplus
|
2009-05-27 19:56:51 +00:00
|
|
|
Used with NFSV3 to specify that the \fBReaddirPlus\fR RPC should
|
2008-09-13 20:22:46 +00:00
|
|
|
be used.
|
2009-05-27 19:56:51 +00:00
|
|
|
For NFSV4, setting this option has a similar effect, in that it will make
|
|
|
|
the Readdir Operation get more attributes.
|
2008-09-13 20:22:46 +00:00
|
|
|
This option reduces RPC traffic for cases such as
|
|
|
|
.Dq "ls -l" ,
|
|
|
|
but tends to flood the attribute and name caches with prefetched entries.
|
|
|
|
Try this option and see whether performance improves or degrades.
|
|
|
|
Probably
|
|
|
|
most useful for client to server network interconnects with a large bandwidth
|
|
|
|
times delay product.
|
|
|
|
.It Cm readahead Ns = Ns Aq Ar value
|
|
|
|
Set the read-ahead count to the specified value.
|
|
|
|
This may be in the range of 0 - 4, and determines how many blocks
|
|
|
|
will be read ahead when a large file is being read sequentially.
|
|
|
|
Trying a value greater than 1 for this is suggested for
|
|
|
|
mounts with a large bandwidth * delay product.
|
|
|
|
.It Cm readdirsize Ns = Ns Aq Ar value
|
|
|
|
Set the readdir read size to the specified value.
|
|
|
|
The value should normally
|
|
|
|
be a multiple of
|
|
|
|
.Dv DIRBLKSIZ
|
|
|
|
that is <= the read size for the mount.
|
2003-05-17 22:53:44 +00:00
|
|
|
.It Cm resvport
|
2008-09-13 20:22:46 +00:00
|
|
|
Use a reserved socket port number.
|
|
|
|
This flag is obsolete, and only retained for compatibility reasons.
|
|
|
|
Reserved port numbers are used by default now.
|
|
|
|
(For the rare case where the client has a trusted root account
|
|
|
|
but untrustworthy users and the network cables are in secure areas this does
|
|
|
|
help, but for normal desktop clients this does not apply.)
|
|
|
|
.It Cm retrans Ns = Ns Aq Ar value
|
|
|
|
Set the retransmit timeout count for soft mounts to the specified value.
|
|
|
|
.It Cm retrycnt Ns = Ns Aq Ar count
|
|
|
|
Set the mount retry count to the specified value.
|
|
|
|
The default is a retry count of zero, which means to keep retrying
|
|
|
|
forever.
|
|
|
|
There is a 60 second delay between each attempt.
|
|
|
|
.It Cm rsize Ns = Ns Aq Ar value
|
1994-05-26 06:35:07 +00:00
|
|
|
Set the read data size to the specified value.
|
1995-06-27 11:07:30 +00:00
|
|
|
It should normally be a power of 2 greater than or equal to 1024.
|
1994-05-26 06:35:07 +00:00
|
|
|
This should be used for UDP mounts when the
|
|
|
|
.Dq "fragments dropped due to timeout"
|
|
|
|
value is getting large while actively using a mount point.
|
|
|
|
(Use
|
|
|
|
.Xr netstat 1
|
|
|
|
with the
|
|
|
|
.Fl s
|
|
|
|
option to see what the
|
|
|
|
.Dq "fragments dropped due to timeout"
|
|
|
|
value is.)
|
2009-05-27 19:56:51 +00:00
|
|
|
.It Cm sec Ns = Ns Aq Ar flavor
|
|
|
|
This option specifies what security flavor should be used for the mount.
|
|
|
|
Currently, they are:
|
|
|
|
.Bd -literal
|
|
|
|
krb5 - Use KerberosV authentication
|
|
|
|
krb5i - Use KerberosV authentication and
|
|
|
|
apply integrity checksums to RPCs
|
|
|
|
krb5p - Use KerberosV authentication and
|
|
|
|
encrypt the RPC data
|
|
|
|
sys - The default AUTH_SYS, which uses a
|
|
|
|
uid + gid list authenticator
|
|
|
|
.Ed
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm soft
|
2002-08-21 18:11:48 +00:00
|
|
|
A soft mount, which implies that file system calls will fail
|
2003-05-17 22:53:44 +00:00
|
|
|
after
|
|
|
|
.Ar retrycnt
|
|
|
|
round trip timeout intervals.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm tcp
|
|
|
|
Use TCP transport.
|
|
|
|
This is the default option, as it provides for increased reliability on both
|
|
|
|
LAN and WAN configurations compared to UDP.
|
|
|
|
Some old NFS servers do not support this method; UDP mounts may be required
|
|
|
|
for interoperability.
|
|
|
|
.It Cm timeout Ns = Ns Aq Ar value
|
2014-10-30 09:06:52 +00:00
|
|
|
Set the initial retransmit timeout to the specified value,
|
|
|
|
expressed in tenths of a second.
|
1994-05-26 06:35:07 +00:00
|
|
|
May be useful for fine tuning UDP mounts over internetworks
|
|
|
|
with high packet loss rates or an overloaded server.
|
|
|
|
Try increasing the interval if
|
|
|
|
.Xr nfsstat 1
|
2002-08-21 18:11:48 +00:00
|
|
|
shows high retransmit rates while the file system is active or reducing the
|
1994-05-26 06:35:07 +00:00
|
|
|
value if there is a low retransmit rate but long response delay observed.
|
2003-05-17 22:53:44 +00:00
|
|
|
(Normally, the
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm dumbtimer
|
2003-05-17 22:53:44 +00:00
|
|
|
option should be specified when using this option to manually
|
1995-06-27 11:07:30 +00:00
|
|
|
tune the timeout
|
|
|
|
interval.)
|
2014-10-30 08:50:01 +00:00
|
|
|
.It Cm timeo Ns = Ns Aq Ar value
|
|
|
|
Alias for
|
|
|
|
.Cm timeout .
|
2020-11-20 22:29:38 +00:00
|
|
|
.It Cm tls
|
|
|
|
This option specifies that the connection to the server must use TLS
|
|
|
|
per RFC NNNN.
|
|
|
|
TLS is only supported for TCP connections and the
|
|
|
|
.Xr rpc.tlsclntd 8
|
|
|
|
daemon must be running for an NFS over TCP connection to use TLS.
|
2020-12-24 22:20:06 +00:00
|
|
|
.It Cm tlscertname Ns = Ns Aq Ar name
|
|
|
|
This option specifies the name of an alternate certificate to be
|
|
|
|
presented to the NFS server during TLS handshake.
|
|
|
|
The default certificate file names are
|
|
|
|
.Dq cert.pem
|
|
|
|
and
|
|
|
|
.Dq certkey.pem .
|
|
|
|
When this option is specified,
|
|
|
|
.Ar name
|
|
|
|
replaces
|
|
|
|
.Dq cert
|
|
|
|
in the above file names.
|
|
|
|
For example, if the value of
|
|
|
|
.Ar name
|
|
|
|
is specified as
|
|
|
|
.Dq other
|
|
|
|
the certificate file names to be used will be
|
|
|
|
.Dq other.pem
|
|
|
|
and
|
|
|
|
.Dq otherkey.pem .
|
|
|
|
These files are stored in
|
|
|
|
.Pa /etc/rpc.tlsclntd
|
|
|
|
by default.
|
|
|
|
This option is only meaningful when used with the
|
|
|
|
.Cm tls
|
|
|
|
option and the
|
|
|
|
.Xr rpc.tlsclntd 8
|
|
|
|
is running with the
|
|
|
|
.Fl m
|
|
|
|
command line flag set.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm udp
|
|
|
|
Use UDP transport.
|
2014-08-05 12:04:40 +00:00
|
|
|
.It Cm vers Ns = Ns Aq Ar vers_number
|
|
|
|
Use the specified version number for NFS requests.
|
|
|
|
See the
|
|
|
|
.Cm nfsv2 ,
|
|
|
|
.Cm nfsv3 ,
|
2014-12-29 13:50:59 +00:00
|
|
|
and
|
2014-08-05 12:04:40 +00:00
|
|
|
.Cm nfsv4
|
|
|
|
options for details.
|
2011-11-14 18:52:07 +00:00
|
|
|
.It Cm wcommitsize Ns = Ns Aq Ar value
|
|
|
|
Set the maximum pending write commit size to the specified value.
|
|
|
|
This determines the maximum amount of pending write data that the NFS
|
|
|
|
client is willing to cache for each file.
|
2008-09-13 20:22:46 +00:00
|
|
|
.It Cm wsize Ns = Ns Aq Ar value
|
1994-05-26 06:35:07 +00:00
|
|
|
Set the write data size to the specified value.
|
2004-07-02 21:45:06 +00:00
|
|
|
Ditto the comments w.r.t.\& the
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm rsize
|
1994-05-26 06:35:07 +00:00
|
|
|
option, but using the
|
|
|
|
.Dq "fragments dropped due to timeout"
|
|
|
|
value on the server instead of the client.
|
|
|
|
Note that both the
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm rsize
|
1994-05-26 06:35:07 +00:00
|
|
|
and
|
2008-09-13 20:22:46 +00:00
|
|
|
.Cm wsize
|
1994-05-26 06:35:07 +00:00
|
|
|
options should only be used as a last ditch effort at improving performance
|
|
|
|
when mounting servers that do not support TCP mounts.
|
2008-09-13 20:22:46 +00:00
|
|
|
.El
|
|
|
|
.El
|
|
|
|
.Sh COMPATIBILITY
|
|
|
|
The following command line flags are equivalent to
|
|
|
|
.Fl o
|
|
|
|
named options and are supported for compatibility with older
|
|
|
|
installations.
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl 2
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nfsv2
|
|
|
|
.It Fl 3
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nfsv3
|
|
|
|
.It Fl D
|
|
|
|
Same as
|
|
|
|
.Fl o Cm deadthresh
|
|
|
|
.It Fl I
|
|
|
|
Same as
|
|
|
|
.Fl o Cm readdirsize Ns = Ns Aq Ar value
|
|
|
|
.It Fl L
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nolockd
|
|
|
|
.It Fl N
|
|
|
|
Same as
|
|
|
|
.Fl o Cm noresvport
|
|
|
|
.It Fl P
|
|
|
|
Use a reserved socket port number.
|
|
|
|
This flag is obsolete, and only retained for compatibility reasons.
|
|
|
|
(For the rare case where the client has a trusted root account
|
|
|
|
but untrustworthy users and the network cables are in secure areas this does
|
|
|
|
help, but for normal desktop clients this does not apply.)
|
|
|
|
.It Fl R
|
|
|
|
Same as
|
|
|
|
.Fl o Cm retrycnt Ns = Ns Aq Ar value
|
|
|
|
.It Fl T
|
|
|
|
Same as
|
|
|
|
.Fl o Cm tcp
|
|
|
|
.It Fl U
|
|
|
|
Same as
|
|
|
|
.Fl o Cm mntudp
|
|
|
|
.It Fl a
|
|
|
|
Same as
|
|
|
|
.Fl o Cm readahead Ns = Ns Aq Ar value
|
|
|
|
.It Fl b
|
|
|
|
Same as
|
|
|
|
.Fl o Cm bg
|
|
|
|
.It Fl c
|
|
|
|
Same as
|
|
|
|
.Fl o Cm noconn
|
|
|
|
.It Fl d
|
|
|
|
Same as
|
|
|
|
.Fl o Cm dumbtimer
|
|
|
|
.It Fl g
|
|
|
|
Same as
|
|
|
|
.Fl o Cm maxgroups
|
|
|
|
.It Fl i
|
|
|
|
Same as
|
|
|
|
.Fl o Cm intr
|
|
|
|
.It Fl l
|
|
|
|
Same as
|
|
|
|
.Fl o Cm rdirplus
|
|
|
|
.It Fl r
|
|
|
|
Same as
|
|
|
|
.Fl o Cm rsize Ns = Ns Aq Ar value
|
|
|
|
.It Fl s
|
|
|
|
Same as
|
|
|
|
.Fl o Cm soft
|
|
|
|
.It Fl t
|
|
|
|
Same as
|
|
|
|
.Fl o Cm retransmit Ns = Ns Aq Ar value
|
|
|
|
.It Fl w
|
|
|
|
Same as
|
|
|
|
.Fl o Cm wsize Ns = Ns Aq Ar value
|
1994-05-26 06:35:07 +00:00
|
|
|
.It Fl x
|
2008-09-13 20:22:46 +00:00
|
|
|
Same as
|
|
|
|
.Fl o Cm retrans Ns = Ns Aq Ar value
|
1994-05-26 06:35:07 +00:00
|
|
|
.El
|
2014-08-05 12:04:40 +00:00
|
|
|
.Pp
|
|
|
|
The following
|
|
|
|
.Fl o
|
|
|
|
named options are equivalent to other
|
|
|
|
.Fl o
|
|
|
|
named options and are supported for compatibility with other
|
|
|
|
operating systems (e.g., Linux, Solaris, and OSX) to ease usage of
|
|
|
|
.Xr autofs 5
|
|
|
|
support.
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl o Cm vers Ns = Ns 2
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nfsv2
|
|
|
|
.It Fl o Cm vers Ns = Ns 3
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nfsv3
|
|
|
|
.It Fl o Cm vers Ns = Ns 4
|
|
|
|
Same as
|
|
|
|
.Fl o Cm nfsv4
|
|
|
|
.El
|
2021-07-11 20:34:16 +00:00
|
|
|
.Sh IMPLEMENTATION NOTES
|
|
|
|
When neither the
|
|
|
|
.Cm rsize
|
|
|
|
nor
|
|
|
|
.Cm wsize
|
|
|
|
options are specified, the I/O size will be set to the largest value
|
|
|
|
supported by both the NFS client and server.
|
|
|
|
The largest value supported by the NFS client is defined by
|
|
|
|
the tunable
|
|
|
|
.Cd vfs.maxbcachebuf
|
|
|
|
which can be set to a power of two up to
|
|
|
|
.Cd kern.maxphys .
|
|
|
|
.Pp
|
|
|
|
The
|
|
|
|
.Xr nfsstat 1
|
|
|
|
command with the
|
|
|
|
.Ic -m
|
|
|
|
command line option will show what
|
|
|
|
.Nm
|
|
|
|
option settings are actually in use for the mount.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh SEE ALSO
|
2021-07-11 20:34:16 +00:00
|
|
|
.Xr nfsstat 1 ,
|
2007-01-23 07:17:10 +00:00
|
|
|
.Xr nmount 2 ,
|
1994-05-26 06:35:07 +00:00
|
|
|
.Xr unmount 2 ,
|
2021-07-11 20:34:16 +00:00
|
|
|
.Xr lagg 4 ,
|
2009-05-27 19:56:51 +00:00
|
|
|
.Xr nfsv4 4 ,
|
1994-05-26 06:35:07 +00:00
|
|
|
.Xr fstab 5 ,
|
2009-05-27 19:56:51 +00:00
|
|
|
.Xr gssd 8 ,
|
2000-01-13 21:47:21 +00:00
|
|
|
.Xr mount 8 ,
|
2000-07-18 17:31:00 +00:00
|
|
|
.Xr nfsd 8 ,
|
2000-07-18 17:34:23 +00:00
|
|
|
.Xr nfsiod 8 ,
|
2020-11-20 22:29:38 +00:00
|
|
|
.Xr rpc.tlsclntd 8 ,
|
2000-07-18 17:34:23 +00:00
|
|
|
.Xr showmount 8
|
2016-09-16 04:28:31 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
A version of the
|
|
|
|
.Nm
|
|
|
|
utility appeared in
|
|
|
|
.Bx 4.4 .
|
2009-05-27 19:56:51 +00:00
|
|
|
.Sh BUGS
|
|
|
|
Since nfsv4 performs open/lock operations that have their ordering strictly
|
|
|
|
enforced by the server, the options
|
|
|
|
.Cm intr
|
|
|
|
and
|
|
|
|
.Cm soft
|
|
|
|
cannot be safely used.
|
2022-07-03 20:37:23 +00:00
|
|
|
For NFSv4 minor version 1 or 2 mounts, these options may
|
|
|
|
also result
|
|
|
|
in hung mount points, due to corruption of session slots.
|
2009-05-27 19:56:51 +00:00
|
|
|
.Cm hard
|
|
|
|
nfsv4 mounts are strongly recommended.
|