2014-12-23 21:44:54

by Scott Mayhew

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

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 <[email protected]>
---
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

2015-01-23 15:31:28

by Steve Dickson

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

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 <[email protected]>
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
>