From patchwork Wed Oct 11 16:02:43 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "J. Bruce Fields" X-Patchwork-Id: 9999971 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id A56CF602BF for ; Wed, 11 Oct 2017 16:02:45 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8E19228AA5 for ; Wed, 11 Oct 2017 16:02:45 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 82F9228AAA; Wed, 11 Oct 2017 16:02:45 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0A16328AA5 for ; Wed, 11 Oct 2017 16:02:45 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752297AbdJKQCo (ORCPT ); Wed, 11 Oct 2017 12:02:44 -0400 Received: from fieldses.org ([173.255.197.46]:41748 "EHLO fieldses.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751744AbdJKQCn (ORCPT ); Wed, 11 Oct 2017 12:02:43 -0400 Received: by fieldses.org (Postfix, from userid 2815) id 4AF062592; Wed, 11 Oct 2017 12:02:43 -0400 (EDT) Date: Wed, 11 Oct 2017 12:02:43 -0400 To: Steve Dickson Cc: linux-nfs@vger.kernel.org Subject: [PATCH] nfs(5): update some version information Message-ID: <20171011160243.GG25913@fieldses.org> MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) From: bfields@fieldses.org (J. Bruce Fields) Sender: linux-nfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-nfs@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP From: "J. Bruce Fields" 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 --- 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.