Update the mount_nfs.8 man page to include NFSv4.2.

r355677 added NFSv4.2 support to the NFS client. This patch updates the
mount_nfs.8 man page to reflect that.
It also clarifies that the "nolockd" option does not apply to NFSv4 mounts.

This is a content change.
This commit is contained in:
Rick Macklem 2019-12-14 21:49:47 +00:00
parent 9f70442a04
commit 547a4dba9f
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=355758

View File

@ -28,7 +28,7 @@
.\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95 .\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 13, 2017 .Dd December 14, 2019
.Dt MOUNT_NFS 8 .Dt MOUNT_NFS 8
.Os .Os
.Sh NAME .Sh NAME
@ -59,9 +59,11 @@ on to the file system tree at the point
.Ar node . .Ar node .
This command is normally executed by This command is normally executed by
.Xr mount 8 . .Xr mount 8 .
It implements the mount protocol as described in RFC 1094, Appendix A and For NFSv2 and NFSv3,
.%T "NFS: Network File System Version 3 Protocol Specification" , it implements the mount protocol as described in RFC 1094, Appendix A and
Appendix I. RFC 1813, Appendix I.
For NFSv4, it uses the NFSv4 protocol as described in RFC 7530, RFC 5661 and
RFC 7862.
.Pp .Pp
By default, By default,
.Nm .Nm
@ -197,20 +199,20 @@ This option will force the mount to use
TCP transport. TCP transport.
.It Cm minorversion Ns = Ns Aq Ar value .It Cm minorversion Ns = Ns Aq Ar value
Override the default of 0 for the minor version of the NFS Version 4 protocol. Override the default of 0 for the minor version of the NFS Version 4 protocol.
The only minor version currently supported is 1. The minor versions other than 0 currently supported are 1 and 2.
This option is only meaningful when used with the This option is only meaningful when used with the
.Cm nfsv4 .Cm nfsv4
option. option.
.It Cm oneopenown .It Cm oneopenown
Make a minor version 1 of the NFS Version 4 protocol mount use a single OpenOwner Make a minor version 1 or 2 of the NFS Version 4 protocol mount use a single
for all Opens. OpenOwner for all Opens.
This may be useful for a server with a very low limit on OpenOwners, such as This may be useful for a server with a very low limit on OpenOwners, such as
AmazonEFS. AmazonEFS.
It can only be used with an NFSv4.1 mount. It ca only be used with an NFSv4.1 or NFSv4.2 mount.
It may not work correctly when Delegations are being issued by a server, 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. but note that the AmazonEFS server does not issued delegations at this time.
.It Cm pnfs .It Cm pnfs
Enable support for parallel NFS (pNFS) for minor version 1 of the Enable support for parallel NFS (pNFS) for minor version 1 or 2 of the
NFS Version 4 protocol. NFS Version 4 protocol.
This option is only meaningful when used with the This option is only meaningful when used with the
.Cm minorversion .Cm minorversion
@ -250,9 +252,9 @@ Do
.Em not .Em not
forward forward
.Xr fcntl 2 .Xr fcntl 2
locks over the wire. locks over the wire via the NLM protocol for NFSv3 mounts.
All locks will be local and not seen by the server All locks will be local and not seen by the server
and likewise not seen by other NFS clients. and likewise not seen by other NFS clients for NFSv3 mounts.
This removes the need to run the This removes the need to run the
.Xr rpcbind 8 .Xr rpcbind 8
service and the service and the
@ -263,6 +265,9 @@ servers on the client.
Note that this option will only be honored when performing the Note that this option will only be honored when performing the
initial mount, it will be silently ignored if used while updating initial mount, it will be silently ignored if used while updating
the mount options. the mount options.
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.
.It Cm noncontigwr .It Cm noncontigwr
This mount option allows the NFS client to This mount option allows the NFS client to
combine non-contiguous byte ranges being written combine non-contiguous byte ranges being written