Date: Sat, 14 Dec 2019 21:49:48 +0000 (UTC) From: Rick Macklem <rmacklem@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r355758 - head/sbin/mount_nfs Message-ID: <201912142149.xBELnmbg000327@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: rmacklem Date: Sat Dec 14 21:49:47 2019 New Revision: 355758 URL: https://svnweb.freebsd.org/changeset/base/355758 Log: 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. Modified: head/sbin/mount_nfs/mount_nfs.8 Modified: head/sbin/mount_nfs/mount_nfs.8 ============================================================================== --- head/sbin/mount_nfs/mount_nfs.8 Sat Dec 14 19:44:42 2019 (r355757) +++ head/sbin/mount_nfs/mount_nfs.8 Sat Dec 14 21:49:47 2019 (r355758) @@ -28,7 +28,7 @@ .\" @(#)mount_nfs.8 8.3 (Berkeley) 3/29/95 .\" $FreeBSD$ .\" -.Dd April 13, 2017 +.Dd December 14, 2019 .Dt MOUNT_NFS 8 .Os .Sh NAME @@ -59,9 +59,11 @@ on to the file system tree at the point .Ar node . This command is normally executed by .Xr mount 8 . -It implements the mount protocol as described in RFC 1094, Appendix A and -.%T "NFS: Network File System Version 3 Protocol Specification" , -Appendix I. +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. .Pp By default, .Nm @@ -197,20 +199,20 @@ This option will force the mount to use TCP transport. .It Cm minorversion Ns = Ns Aq Ar value 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 .Cm nfsv4 option. .It Cm oneopenown -Make a minor version 1 of the NFS Version 4 protocol mount use a single OpenOwner -for all Opens. +Make a minor version 1 or 2 of the NFS Version 4 protocol mount use a single +OpenOwner for all Opens. This may be useful for a server with a very low limit on OpenOwners, such as 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, but note that the AmazonEFS server does not issued delegations at this time. .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. This option is only meaningful when used with the .Cm minorversion @@ -250,9 +252,9 @@ Do .Em not forward .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 -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 .Xr rpcbind 8 service and the @@ -263,6 +265,9 @@ 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. +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 This mount option allows the NFS client to combine non-contiguous byte ranges being written
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201912142149.xBELnmbg000327>