debian/patches/16-mount.nfs.man-nfs.man-update-distinction-between-fstypes.patch

   1 From: Ben Hutchings <ben@decadent.org.uk>
   2 Subject: [PATCH] mount.nfs.man, nfs.man: Update distinction between fstypes
   3
   4 This addresses Debian bug #575503.
   5
   6 --- nfs-utils.orig/utils/mount/mount.nfs.man
   7 +++ nfs-utils/utils/mount/mount.nfs.man
   8 @@ -15,16 +15,20 @@
   9  .BR mount (8)
  10  command for mounting NFS shares. This subcommand, however, can also be used as a standalone command with limited functionality.
  11
  12 -.BR mount.nfs4
  13 -is used for mounting NFSv4 file system, while
  14 -.BR mount.nfs
  15 -is used to mount NFS file systems versions 3 or 2.
  16  .I remotetarget
  17  is a server share usually in the form of
  18  .BR servername:/path/to/share.
  19  .I dir
  20  is the directory on which the file system is to be mounted.
  21
  22 +Under Linux 2.6.32 and later kernel versions,
  23 +.BR mount.nfs
  24 +can mount all NFS file system versions.  Under earlier Linux kernel versions,
  25 +.BR mount.nfs4
  26 +must be used for mounting NFSv4 file systems while
  27 +.BR mount.nfs
  28 +must be used for NFSv3 and v2.
  29 +
  30  .SH OPTIONS
  31  .TP
  32  .BI "\-r"
  33 --- nfs-utils.orig/utils/mount/nfs.man
  34 +++ nfs-utils/utils/mount/nfs.man
  35 @@ -71,14 +71,9 @@
  36  .P
  37  The
  38  .I fstype
  39 -field contains either "nfs" (for version 2 or version 3 NFS mounts)
  40 -or "nfs4" (for NFS version 4 mounts).
  41 -The
  42 -.B nfs
  43 -and
  44 -.B nfs4
  45 -file system types share similar mount options,
  46 -which are described below.
  47 +field usually contains "nfs". For NFSv4 file systems on Linux
  48 +kernel versions before 2.6.32, it must contain "nfs4" (this is
  49 +also supported on later versions).
  50  .SH "MOUNT OPTIONS"
  51  Refer to
  52  .BR mount (8)
  53 @@ -89,14 +84,23 @@
  54  in
  55  .IR /etc/fstab .
  56  .DT
  57 -.SS "Valid options for either the nfs or nfs4 file system type"
  58 -These options are valid to use when mounting either
  59 -.B nfs
  60 -or
  61 -.B nfs4
  62 -file system types.
  63 +.SS "Valid options for all NFS file system versions"
  64  They imply the same behavior
  65 -and have the same default for both file system types.
  66 +and have the same default for all file system versions.
  67 +.TP 1.5i
  68 +.BI nfsvers= n
  69 +The NFS protocol version number used to contact the server's NFS service.
  70 +If the server does not support the requested version,
  71 +the mount request fails.
  72 +If this option is not specified, the client attempts to use the latest
  73 +version (4 or 3), but negotiates the NFS version with the server if this
  74 +is not available.
  75 +.TP 1.5i
  76 +.BI vers= n
  77 +This option is an alternative to the
  78 +.B nfsvers
  79 +option.
  80 +It is included for compatibility with other operating systems.
  81  .TP 1.5i
  82  .BR soft " / " hard
  83  Determines the recovery behavior of the NFS client
  84 @@ -476,11 +480,7 @@
  85  .IP
  86  The DATA AND METADATA COHERENCE section contains a
  87  detailed discussion of these trade-offs.
  88 -.SS "Valid options for the nfs file system type"
  89 -Use these options, along with the options in the above subsection,
  90 -for mounting the
  91 -.B nfs
  92 -file system type.
  93 +.SS "Valid options for NFSv2 and v3 file systems"
  94  .TP 1.5i
  95  .BI proto= netid
  96  The transport protocol name and protocol family the NFS client uses
  97 @@ -621,23 +621,6 @@
  98  reports the proper maximum component length to applications
  99  in such cases.
 100  .TP 1.5i
 101 -.BI nfsvers= n
 102 -The NFS protocol version number used to contact the server's NFS service.
 103 -The Linux client supports version 2 and version 3 of the NFS protocol
 104 -when using the file system type
 105 -.BR nfs .
 106 -If the server does not support the requested version,
 107 -the mount request fails.
 108 -If this option is not specified, the client attempts to use version 3,
 109 -but negotiates the NFS version with the server if version 3 support
 110 -is not available.
 111 -.TP 1.5i
 112 -.BI vers= n
 113 -This option is an alternative to the
 114 -.B nfsvers
 115 -option.
 116 -It is included for compatibility with other operating systems.
 117 -.TP 1.5i
 118  .BR lock " / " nolock
 119  Selects whether to use the NLM sideband protocol to lock files on the server.
 120  If neither option is specified (or if
 121 @@ -727,11 +710,7 @@
 122  on NFS version 3 mounts to read small directories.
 123  Some applications perform better if the client uses only READDIR requests
 124  for all directories.
 125 -.SS "Valid options for the nfs4 file system type"
 126 -Use these options, along with the options in the first subsection above,
 127 -for mounting the
 128 -.B nfs4
 129 -file system type.
 130 +.SS "Valid options for NFSv4 file systems"
 131  .TP 1.5i
 132  .BI proto= netid
 133  The transport protocol name and protocol family the NFS client uses
 134 @@ -851,12 +830,11 @@
 135  To mount using NFS version 4,
 136  use the
 137  .B nfs4
 138 -file system type.
 139 -The
 140 -.B nfsvers
 141 -mount option is not supported for the
 142 -.B nfs4
 143 -file system type.
 144 +file system type or (from Linux 2.6.32) use the
 145 +.B nfs
 146 +file system type and specify the
 147 +.B nfsvers=4
 148 +mount option.
 149  .P
 150  The following example from an
 151  .I /etc/fstab