[nfs-utils PATCH] rpc.idmapd: Add a reference to nfsidmap(8) on the man page

[nfs-utils PATCH] rpc.idmapd: Add a reference to nfsidmap(8) on the man page

[Scott Mayhew]

Even though the 'new' idmapper used by the client has been around for
several years, a lot of users seem to be unaware of its existence.

Signed-off-by: Scott Mayhew <smayhew@redhat.com>
---
 utils/idmapd/idmapd.man | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/utils/idmapd/idmapd.man b/utils/idmapd/idmapd.man
index 185cd1b..c809f78 100644
--- a/utils/idmapd/idmapd.man
+++ b/utils/idmapd/idmapd.man
@@ -20,6 +20,16 @@ is the NFSv4 ID <-> name mapping daemon.  It provides functionality to
 the NFSv4 kernel client and server, to which it communicates via
 upcalls, by translating user and group IDs to names, and vice versa.
 .Pp
+Note that on more recent kernels only the NFSv4 server uses
+.Nm .
+The NFSv4 client instead uses
+.Xr nfsidmap 8 ,
+and only falls back to 
+.Nm 
+if there was a problem running the
+.Xr nfsidmap 8
+program.
+.Pp
 The options are as follows:
 .Bl -tag -width Ds_imagedir
 .It Fl v
@@ -58,7 +68,8 @@ messages to console, and with a verbosity level of 3.
 .Sh FILES
 .Pa /etc/idmapd.conf
 .Sh SEE ALSO
-.Xr idmapd.conf 5
+.Xr idmapd.conf 5 ,
+.Xr nfsidmap 8
 .\".Sh SEE ALSO
 .\".Xr nylon.conf 4
 .\" .Sh COMPATIBILITY
-- 
1.9.3

Re: [nfs-utils PATCH] rpc.idmapd: Add a reference to nfsidmap(8) on the man page

[Steve Dickson]

On 12/23/2014 04:44 PM, Scott Mayhew wrote:
> Even though the 'new' idmapper used by the client has been around for
> several years, a lot of users seem to be unaware of its existence.
> 
> Signed-off-by: Scott Mayhew <smayhew@redhat.com>
Committed...

steved.

> ---
>  utils/idmapd/idmapd.man | 13 ++++++++++++-
>  1 file changed, 12 insertions(+), 1 deletion(-)
> 
> diff --git a/utils/idmapd/idmapd.man b/utils/idmapd/idmapd.man
> index 185cd1b..c809f78 100644
> --- a/utils/idmapd/idmapd.man
> +++ b/utils/idmapd/idmapd.man
> @@ -20,6 +20,16 @@ is the NFSv4 ID <-> name mapping daemon.  It provides functionality to
>  the NFSv4 kernel client and server, to which it communicates via
>  upcalls, by translating user and group IDs to names, and vice versa.
>  .Pp
> +Note that on more recent kernels only the NFSv4 server uses
> +.Nm .
> +The NFSv4 client instead uses
> +.Xr nfsidmap 8 ,
> +and only falls back to 
> +.Nm 
> +if there was a problem running the
> +.Xr nfsidmap 8
> +program.
> +.Pp
>  The options are as follows:
>  .Bl -tag -width Ds_imagedir
>  .It Fl v
> @@ -58,7 +68,8 @@ messages to console, and with a verbosity level of 3.
>  .Sh FILES
>  .Pa /etc/idmapd.conf
>  .Sh SEE ALSO
> -.Xr idmapd.conf 5
> +.Xr idmapd.conf 5 ,
> +.Xr nfsidmap 8
>  .\".Sh SEE ALSO
>  .\".Xr nylon.conf 4
>  .\" .Sh COMPATIBILITY
>