All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH] nfs(5): update some version information
@ 2017-10-11 16:02 J. Bruce Fields
  2017-10-11 16:04 ` [PATCH] minor exports man page typo J. Bruce Fields
  2017-10-12 14:21 ` [PATCH] nfs(5): update some version information Steve Dickson
  0 siblings, 2 replies; 4+ messages in thread
From: J. Bruce Fields @ 2017-10-11 16:02 UTC (permalink / raw)
  To: Steve Dickson; +Cc: linux-nfs

From: "J. Bruce Fields" <bfields@redhat.com>

We've seen some confusion from people not understanding why newer
clients may not support NFSv2.  It might help a little to note in the
man page that version support depends on how the kernel was built.

While we're there:

	- update some references to NFS protocol versions.
	- update 4.0 RFC, and add references to 4.1 and 4.2 RFCs.
	- rename "BUGS" to "NOTES"; the section mostly isn't about bugs.
	  (Might be time to remove some of the linux-2.4 notes too.)
	- remove some outdated references to optional NFSv4+ features.
	  (Or should we try to keep this information up to date?)

Signed-off-by: J. Bruce Fields <bfields@redhat.com>
---
 utils/mount/nfs.man | 35 ++++++++++++++++++++---------------
 1 file changed, 20 insertions(+), 15 deletions(-)

diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
index 7d42f19d0ca6..bd1508c6154d 100644
--- a/utils/mount/nfs.man
+++ b/utils/mount/nfs.man
@@ -11,11 +11,8 @@ NFS is an Internet Standard protocol
 created by Sun Microsystems in 1984. NFS was developed
 to allow file sharing between systems residing
 on a local area network.
-The Linux NFS client supports three versions
-of the NFS protocol:
-NFS version 2 [RFC1094],
-NFS version 3 [RFC1813],
-and NFS version 4 [RFC3530].
+Depending on kernel configuration, the Linux NFS client may
+support NFS versions 2, 3, 4.0, 4.1, or 4.2.
 .P
 The
 .BR mount (8)
@@ -88,9 +85,8 @@ These options are valid to use with any NFS version.
 The NFS protocol version number used to contact the server's NFS service.
 If the server does not support the requested version, the mount request 
 fails.
-If this option is not specified, the client negotiates a suitable version 
-with
-the server, trying version 4 first, version 3 second, and version 2 last.
+If this option is not specified, the client tries version 4.2 first,
+then negotiates down until it finds a version supported by the server.
 .TP 1.5i
 .BI vers= n
 This option is an alternative to the
@@ -762,7 +758,7 @@ NOTE: When used together, the 'local_lock' mount option will be overridden
 by 'nolock'/'lock' mount option.
 .SS "Options for NFS version 4 only"
 Use these options, along with the options in the first subsection above,
-for NFS version 4 and newer.
+for NFS version 4.0 and newer.
 .TP 1.5i
 .BI proto= netid
 The
@@ -835,7 +831,7 @@ the behavior of this option in more detail.
 Specifies a single IPv4 address (in dotted-quad form),
 or a non-link-local IPv6 address,
 that the NFS client advertises to allow servers
-to perform NFS version 4 callback requests against
+to perform NFS version 4.0 callback requests against
 files on this mount point. If  the  server is unable to
 establish callback connections to clients, performance
 may degrade, or accesses to files may temporarily hang.
@@ -848,6 +844,11 @@ In the presence of multiple client network interfaces,
 special routing policies,
 or atypical network topologies,
 the exact address to use for callbacks may be nontrivial to determine.
+.IP
+NFS protocol versions 4.1 and 4.2 use the client-established
+TCP connection for callback requests, so do not require the server to
+connect to the client.  This option is therefore only affect NFS version
+4.0 mounts.
 .TP 1.5i
 .BR migration " / " nomigration
 Selects whether the client uses an identification string that is compatible
@@ -1789,7 +1790,7 @@ file system table
 .TP 1.5i
 .I /etc/nfsmount.conf
 Configuration file for NFS mounts
-.SH BUGS
+.SH NOTES
 Before 2.4.7, the Linux NFS client did not support NFS over TCP.
 .P
 Before 2.4.20, the Linux NFS client used a heuristic
@@ -1808,9 +1809,9 @@ when the
 .BR rsize " and " wsize
 settings were smaller than the system's page size.
 .P
-The Linux NFS client does not yet support
-certain optional features of the NFS version 4 protocol,
-such as security negotiation, server referrals, and named attributes.
+The Linux client's support for protocol versions depend on whether the
+kernel was built with options CONFIG_NFS_V2, CONFIG_NFS_V3,
+CONFIG_NFS_V4, CONFIG_NFS_V4_1, and CONFIG_NFS_V4_2.
 .SH "SEE ALSO"
 .BR fstab (5),
 .BR mount (8),
@@ -1843,4 +1844,8 @@ RFC 1833 for the RPC bind specification.
 .br
 RFC 2203 for the RPCSEC GSS API protocol specification.
 .br
-RFC 3530 for the NFS version 4 specification.
+RFC 7530 for the NFS version 4.0 specification.
+.br
+RFC 5661 for the NFS version 4.1 specification.
+.br
+RFC 7862 for the NFS version 4.2 specification.
-- 
2.13.5


^ permalink raw reply related	[flat|nested] 4+ messages in thread
* [PATCH] minor exports man page typo
  2017-10-11 16:02 [PATCH] nfs(5): update some version information J. Bruce Fields
@ 2017-10-11 16:04 ` J. Bruce Fields
  2017-10-12 14:21   ` Steve Dickson
  2017-10-12 14:21 ` [PATCH] nfs(5): update some version information Steve Dickson
  1 sibling, 1 reply; 4+ messages in thread
From: J. Bruce Fields @ 2017-10-11 16:04 UTC (permalink / raw)
  To: Steve Dickson; +Cc: linux-nfs

From: "J. Bruce Fields" <bfields@redhat.com>

---
 utils/exportfs/exports.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/utils/exportfs/exports.man b/utils/exportfs/exports.man
index d8de6bec2583..db47dfdee775 100644
--- a/utils/exportfs/exports.man
+++ b/utils/exportfs/exports.man
@@ -410,7 +410,7 @@ of the filesystem must be handled elsewhere.)
 
 .TP
 .IR pnfs
-This option allows enables the use of pNFS extension if protocol level
+This option enables the use of the pNFS extension if the protocol level
 is NFSv4.1 or higher, and the filesystem supports pNFS exports.  With
 pNFS clients can bypass the server and perform I/O directly to storage
 devices. The default can be explicitly requested with the
-- 
2.13.5


^ permalink raw reply related	[flat|nested] 4+ messages in thread
* Re: [PATCH] nfs(5): update some version information
  2017-10-11 16:02 [PATCH] nfs(5): update some version information J. Bruce Fields
  2017-10-11 16:04 ` [PATCH] minor exports man page typo J. Bruce Fields
@ 2017-10-12 14:21 ` Steve Dickson
  1 sibling, 0 replies; 4+ messages in thread
From: Steve Dickson @ 2017-10-12 14:21 UTC (permalink / raw)
  To: J. Bruce Fields; +Cc: linux-nfs



On 10/11/2017 12:02 PM, J. Bruce Fields wrote:
> From: "J. Bruce Fields" <bfields@redhat.com>
> 
> We've seen some confusion from people not understanding why newer
> clients may not support NFSv2.  It might help a little to note in the
> man page that version support depends on how the kernel was built.
> 
> While we're there:
> 
> 	- update some references to NFS protocol versions.
> 	- update 4.0 RFC, and add references to 4.1 and 4.2 RFCs.
> 	- rename "BUGS" to "NOTES"; the section mostly isn't about bugs.
> 	  (Might be time to remove some of the linux-2.4 notes too.)
> 	- remove some outdated references to optional NFSv4+ features.
> 	  (Or should we try to keep this information up to date?)
> 
> Signed-off-by: J. Bruce Fields <bfields@redhat.com>
Committed... 

steved.
> ---
>  utils/mount/nfs.man | 35 ++++++++++++++++++++---------------
>  1 file changed, 20 insertions(+), 15 deletions(-)
> 
> diff --git a/utils/mount/nfs.man b/utils/mount/nfs.man
> index 7d42f19d0ca6..bd1508c6154d 100644
> --- a/utils/mount/nfs.man
> +++ b/utils/mount/nfs.man
> @@ -11,11 +11,8 @@ NFS is an Internet Standard protocol
>  created by Sun Microsystems in 1984. NFS was developed
>  to allow file sharing between systems residing
>  on a local area network.
> -The Linux NFS client supports three versions
> -of the NFS protocol:
> -NFS version 2 [RFC1094],
> -NFS version 3 [RFC1813],
> -and NFS version 4 [RFC3530].
> +Depending on kernel configuration, the Linux NFS client may
> +support NFS versions 2, 3, 4.0, 4.1, or 4.2.
>  .P
>  The
>  .BR mount (8)
> @@ -88,9 +85,8 @@ These options are valid to use with any NFS version.
>  The NFS protocol version number used to contact the server's NFS service.
>  If the server does not support the requested version, the mount request 
>  fails.
> -If this option is not specified, the client negotiates a suitable version 
> -with
> -the server, trying version 4 first, version 3 second, and version 2 last.
> +If this option is not specified, the client tries version 4.2 first,
> +then negotiates down until it finds a version supported by the server.
>  .TP 1.5i
>  .BI vers= n
>  This option is an alternative to the
> @@ -762,7 +758,7 @@ NOTE: When used together, the 'local_lock' mount option will be overridden
>  by 'nolock'/'lock' mount option.
>  .SS "Options for NFS version 4 only"
>  Use these options, along with the options in the first subsection above,
> -for NFS version 4 and newer.
> +for NFS version 4.0 and newer.
>  .TP 1.5i
>  .BI proto= netid
>  The
> @@ -835,7 +831,7 @@ the behavior of this option in more detail.
>  Specifies a single IPv4 address (in dotted-quad form),
>  or a non-link-local IPv6 address,
>  that the NFS client advertises to allow servers
> -to perform NFS version 4 callback requests against
> +to perform NFS version 4.0 callback requests against
>  files on this mount point. If  the  server is unable to
>  establish callback connections to clients, performance
>  may degrade, or accesses to files may temporarily hang.
> @@ -848,6 +844,11 @@ In the presence of multiple client network interfaces,
>  special routing policies,
>  or atypical network topologies,
>  the exact address to use for callbacks may be nontrivial to determine.
> +.IP
> +NFS protocol versions 4.1 and 4.2 use the client-established
> +TCP connection for callback requests, so do not require the server to
> +connect to the client.  This option is therefore only affect NFS version
> +4.0 mounts.
>  .TP 1.5i
>  .BR migration " / " nomigration
>  Selects whether the client uses an identification string that is compatible
> @@ -1789,7 +1790,7 @@ file system table
>  .TP 1.5i
>  .I /etc/nfsmount.conf
>  Configuration file for NFS mounts
> -.SH BUGS
> +.SH NOTES
>  Before 2.4.7, the Linux NFS client did not support NFS over TCP.
>  .P
>  Before 2.4.20, the Linux NFS client used a heuristic
> @@ -1808,9 +1809,9 @@ when the
>  .BR rsize " and " wsize
>  settings were smaller than the system's page size.
>  .P
> -The Linux NFS client does not yet support
> -certain optional features of the NFS version 4 protocol,
> -such as security negotiation, server referrals, and named attributes.
> +The Linux client's support for protocol versions depend on whether the
> +kernel was built with options CONFIG_NFS_V2, CONFIG_NFS_V3,
> +CONFIG_NFS_V4, CONFIG_NFS_V4_1, and CONFIG_NFS_V4_2.
>  .SH "SEE ALSO"
>  .BR fstab (5),
>  .BR mount (8),
> @@ -1843,4 +1844,8 @@ RFC 1833 for the RPC bind specification.
>  .br
>  RFC 2203 for the RPCSEC GSS API protocol specification.
>  .br
> -RFC 3530 for the NFS version 4 specification.
> +RFC 7530 for the NFS version 4.0 specification.
> +.br
> +RFC 5661 for the NFS version 4.1 specification.
> +.br
> +RFC 7862 for the NFS version 4.2 specification.
> 

^ permalink raw reply	[flat|nested] 4+ messages in thread
* Re: [PATCH] minor exports man page typo
  2017-10-11 16:04 ` [PATCH] minor exports man page typo J. Bruce Fields
@ 2017-10-12 14:21   ` Steve Dickson
  0 siblings, 0 replies; 4+ messages in thread
From: Steve Dickson @ 2017-10-12 14:21 UTC (permalink / raw)
  To: J. Bruce Fields; +Cc: linux-nfs



On 10/11/2017 12:04 PM, J. Bruce Fields wrote:
> From: "J. Bruce Fields" <bfields@redhat.com>
> 
> ---
>  utils/exportfs/exports.man | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
Committed...

steved.
> 
> diff --git a/utils/exportfs/exports.man b/utils/exportfs/exports.man
> index d8de6bec2583..db47dfdee775 100644
> --- a/utils/exportfs/exports.man
> +++ b/utils/exportfs/exports.man
> @@ -410,7 +410,7 @@ of the filesystem must be handled elsewhere.)
>  
>  .TP
>  .IR pnfs
> -This option allows enables the use of pNFS extension if protocol level
> +This option enables the use of the pNFS extension if the protocol level
>  is NFSv4.1 or higher, and the filesystem supports pNFS exports.  With
>  pNFS clients can bypass the server and perform I/O directly to storage
>  devices. The default can be explicitly requested with the
> 

^ permalink raw reply	[flat|nested] 4+ messages in thread
end of thread, other threads:[~2017-10-12 14:21 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-10-11 16:02 [PATCH] nfs(5): update some version information J. Bruce Fields
2017-10-11 16:04 ` [PATCH] minor exports man page typo J. Bruce Fields
2017-10-12 14:21   ` Steve Dickson
2017-10-12 14:21 ` [PATCH] nfs(5): update some version information Steve Dickson

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.