[Bug 1689516] [NEW] Manpage for exports doesn't clarify on the NFSv4 fsid=0 option

[Thomas Mack]

Public bug reported:

The only statement about NFSv4 syntax in the manpage for exports is:

--------------------------------------------------------------------
For NFSv4, there is a distinguished filesystem which is the root of all exported filesystem.  This is specified with fsid=root or fsid=0 both of which mean exactly the same thing.
--------------------------------------------------------------------

Indeed, this root filesystem for NFSv4 isn't necessary at all on 17.04,
it's just an option. One can use the normal NFSv3 / NFSv2 syntax for
NFSv4. This should be mentioned in the man page.

If someone prefers the more complex native NFSv4 layout with an NFSv4
root, one might like to find some more info on it. Probably an extra
section explaining the NFSv4 specialties would be fine, but maybe it's
ok without, as there isn't much use for this extra complexity.

ProblemType: Bug
DistroRelease: Ubuntu 17.04
Package: nfs-kernel-server 1:1.2.8-9.2ubuntu2
ProcVersionSignature: Ubuntu 4.10.0-20.22-generic 4.10.8
Uname: Linux 4.10.0-20-generic x86_64
ApportVersion: 2.20.4-0ubuntu4
Architecture: amd64
Date: Tue May  9 11:34:26 2017
InstallationDate: Installed on 2017-05-04 (4 days ago)
InstallationMedia: Ubuntu 17.04 "Zesty Zapus" - Release amd64 (20170412)
SourcePackage: nfs-utils
UpgradeStatus: No upgrade log present (probably fresh install)

** Affects: nfs-utils (Ubuntu)
     Importance: Undecided
         Status: New


** Tags: exports man nfsv4 zesty

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to nfs-utils in Ubuntu.
https://bugs.launchpad.net/bugs/1689516

Title:
  Manpage for exports doesn't clarify on the NFSv4 fsid=0 option

Status in nfs-utils package in Ubuntu:
  New

Bug description:
  The only statement about NFSv4 syntax in the manpage for exports is:

  --------------------------------------------------------------------
  For NFSv4, there is a distinguished filesystem which is the root of all exported filesystem.  This is specified with fsid=root or fsid=0 both of which mean exactly the same thing.
  --------------------------------------------------------------------

  Indeed, this root filesystem for NFSv4 isn't necessary at all on
  17.04, it's just an option. One can use the normal NFSv3 / NFSv2
  syntax for NFSv4. This should be mentioned in the man page.

  If someone prefers the more complex native NFSv4 layout with an NFSv4
  root, one might like to find some more info on it. Probably an extra
  section explaining the NFSv4 specialties would be fine, but maybe it's
  ok without, as there isn't much use for this extra complexity.

  ProblemType: Bug
  DistroRelease: Ubuntu 17.04
  Package: nfs-kernel-server 1:1.2.8-9.2ubuntu2
  ProcVersionSignature: Ubuntu 4.10.0-20.22-generic 4.10.8
  Uname: Linux 4.10.0-20-generic x86_64
  ApportVersion: 2.20.4-0ubuntu4
  Architecture: amd64
  Date: Tue May  9 11:34:26 2017
  InstallationDate: Installed on 2017-05-04 (4 days ago)
  InstallationMedia: Ubuntu 17.04 "Zesty Zapus" - Release amd64 (20170412)
  SourcePackage: nfs-utils
  UpgradeStatus: No upgrade log present (probably fresh install)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/nfs-utils/+bug/1689516/+subscriptions