LU-3425 utils: rename l_getgroups.8 to l_getidentity.8

Rename the man page for l_getgroups.8 to l_getidentity.8 to match
the "new" name of the utility, and update the content accordingly.

Test-Parameters: trivial
Signed-off-by: Andreas Dilger <andreas.dilger@intel.com>
Change-Id: I698c8170cb0623ff692bfe76962b5c71d75bc18b
Reviewed-on: https://review.whamcloud.com/24219
Tested-by: Jenkins
Tested-by: Maloo <hpdd-maloo@intel.com>
Reviewed-by: Steve Guminski <stephenx.guminski@intel.com>
Reviewed-by: Bob Glossman <bob.glossman@intel.com>
Reviewed-by: Oleg Drokin <oleg.drokin@intel.com>

diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am
index abce16f..eae6946 100644 (file)
--- a/lustre/doc/Makefile.am
+++ b/lustre/doc/Makefile.am
@@ -34,7 +34,7 @@
 
 MANFILES = lustre.7 lfs.1 mount.lustre.8 lctl.8 lnetctl.8 \
        llverdev.8 llbackup.8 llapi_quotactl.3 llobdstat.8 llstat.8 \
-       plot-llstat.8 l_getgroups.8 lst.8 routerstat.8 llog_reader.8 \
+       plot-llstat.8 l_getidentity.8 lst.8 routerstat.8 llog_reader.8 \
        llapi_file_open.3 llapi_file_create.3 llapi_file_get_stripe.3 \
        lustre_rsync.8 lfs_migrate.1 lhbadm.8 ldev.8 ldev.conf.5 nids.5 \
        lfs-hsm.1 llapi_hsm_state_get.3 llapi_hsm_state_set.3 \

diff --git a/lustre/doc/l_getgroups.8 b/lustre/doc/l_getgroups.8
deleted file mode 100644 (file)
index bbd7810..0000000
--- a/lustre/doc/l_getgroups.8
+++ /dev/null
@@ -1,18 +0,0 @@
-.TH l_getgroups 1 "Jul 7, 2008" Lustre "utilities"
-.SH NAME
-l_getgroups \- Handle Lustre user/group cache upcall
-.SH SYNOPSIS
-.B "l_getgroups [-v] [-d | mdsname] uid"
-.br
-.B "l_getgroups [-v] -s"
-.SH DESCRIPTION
-The group upcall file contains the path to an executable that, when
-properly installed, is invoked to resolve a numeric UID to a group
-membership list.
-.LP
-.B l_getgroups
-is the reference implementation of the user/group cache upcall
-.SH FILES
-/{proc,sys}/fs/lustre/mds/mds-service/group_upcall
-.SH SEE ALSO
-Lustre Programming Interfaces section of Lustre Operations Manual.

diff --git a/lustre/doc/l_getidentity.8 b/lustre/doc/l_getidentity.8
new file mode 100644 (file)
index 0000000..662bbd5
--- /dev/null
+++ b/lustre/doc/l_getidentity.8
@@ -0,0 +1,33 @@
+.TH l_getidentity 1 "Dec 7, 2016" Lustre "utilities"
+.SH NAME
+l_getidentity \- Handle Lustre user/group cache upcall
+.SH SYNOPSIS
+.B "l_getidentity {-d | mdtname} uid"
+.SH DESCRIPTION
+The identity upcall command specifies the path to an executable that,
+when properly installed, is invoked to resolve the numeric
+.I uid
+to a group membership list.
+.LP
+.B l_getidentity
+is the reference implementation of the user/group cache upcall.
+This command is normally run directly by the Lustre MDS service
+and specifies the
+.I mdtname
+argument for the MDT that should be updated.
+.SH OPTIONS
+.TP
+.B -d
+Run in debug mode and print supplementary groups information for
+.I uid
+to
+.B stdout
+instead of updating Lustre.
+.SH EXAMPLES
+The identity upcall command can be specified via:
+.br
+.RI "lctl set_param mdt." mdtname .identity_upcall= path_to_upcall
+.SH FILES
+.RI /{proc,sys}/fs/lustre/mdt/ mdt-service /identity_upcall
+.SH SEE ALSO
+Lustre Programming Interfaces section of Lustre Operations Manual.

diff --git a/lustre/doc/lustre.7 b/lustre/doc/lustre.7
index 41b2b3f..3531a19 100644 (file)
--- a/lustre/doc/lustre.7
+++ b/lustre/doc/lustre.7
@@ -74,7 +74,7 @@ https://downloads.hpdd.intel.com/
 .BR lfs (1),
 .BR lfs_migrate (1),
 .BR liblustreapi (7),
-.BR l_getgroups (8),
+.BR l_getidentity (8),
 .BR llstat (8),
 .BR llverdev (8),
 .BR lst (8),

diff --git a/lustre/utils/.gitignore b/lustre/utils/.gitignore
index 0fdc8c6..05fa7c6 100644 (file)
--- a/lustre/utils/.gitignore
+++ b/lustre/utils/.gitignore
@@ -14,7 +14,6 @@
 /l_getidentity
 /l_facl
 /req_layout
-/l_getgroups
 /mkfs_lustre
 /mount_lustre
 /tunefs_lustre