svn commit: r344013 - head/usr.sbin/mountd

[Rodney W. Grimes]

> Author: cracauer
> Date: Mon Feb 11 15:51:28 2019
> New Revision: 344013
> URL: https://svnweb.freebsd.org/changeset/base/344013
> 
> Log:
>   Clarify NFSv4 /etc/exports semantics, with working example.
>   The existing wording has been confusing users for years.
> 
> Modified:
>   head/usr.sbin/mountd/exports.5
> 
> Modified: head/usr.sbin/mountd/exports.5
> ==============================================================================
> --- head/usr.sbin/mountd/exports.5	Mon Feb 11 15:38:05 2019	(r344012)
> +++ head/usr.sbin/mountd/exports.5	Mon Feb 11 15:51:28 2019	(r344013)
> @@ -498,6 +498,40 @@ and any client within the 131.104.48 subnet is permitt
>  operations on the server, so long as valid Kerberos credentials are provided.
>  The machine grumpy.cis.uoguelph.ca is permitted to perform NFSv4 state
>  operations on the server using AUTH_SYS credentials, as well as Kerberos ones.
> +.Pp
> +In the following example some directories are exported as NFSv3 and NFSv4:
> +.Bd -literal -offset indent
> +V4: /wingsdl/nfsv4
> +/wingsdl/nfsv4/usr-ports -maproot=root -network 172.16.0.0 -mask 255.255.0.0
> +/wingsdl/nfsv4/clasper   -maproot=root clasper
> +.Ed
> +.Pp
> +Only one V4: line is needed or allowed to declare where NFSv4 is
> +rooted.  The other lines declare specific exported directories with
Line break ^  here

> +their absolute paths given in /etc/exports.
> +.Pp
> +The exported directories' paths are used for both v3 and v4.
> +However, they are interpreted differently for v3 and v4.  A client
Line break                                                 ^ here

> +mount command for usr-ports would use the server-absolute name when
> +using nfsv3:
> +.Bd -literal -offset indent
> +mount server:/wingsdl/nfsv4/usr-ports /mnt/tmp
> +.Ed
> +.Pp
> +A mount command using NFSv4 would use the path relative to the NFSv4
> +root:
> +.Bd -literal -offset indent
> +mount server:/usr-ports /mnt/tmp
> +.Ed
> +.Pp
> +This also differentiates which version you want if the client can do
> +both v3 and v4.  The former will only ever do a v3 mount and the
Line break         ^ here

> +latter will only ever do a v4 mount.
> +.Pp
> +Note that due to different mount behavior between NFSv3 and NFSv4 a
> +NFSv4 mount request for a directory that the client does not have
> +permission for will succeed and read/write access will fail
> +afterwards, whereas NFSv3 rejects the mount request.
>  .Sh SEE ALSO
>  .Xr nfsv4 4 ,
>  .Xr netgroup 5 ,
> 
> 

When writting troff sentences should always start on a new line.
And it is encourage to start each sentence fragment on a new line too.

Thanks,
-- 
Rod Grimes                                                 rgrimes at freebsd.org