From 611ca5a692c87e1440088c334e5aed4506346736 Mon Sep 17 00:00:00 2001 From: Andreas Dilger Date: Wed, 7 Dec 2016 13:56:40 -0700 Subject: [PATCH] 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 Change-Id: I698c8170cb0623ff692bfe76962b5c71d75bc18b Reviewed-on: https://review.whamcloud.com/24219 Tested-by: Jenkins Tested-by: Maloo Reviewed-by: Steve Guminski Reviewed-by: Bob Glossman Reviewed-by: Oleg Drokin --- lustre/doc/Makefile.am | 2 +- lustre/doc/l_getgroups.8 | 18 ------------------ lustre/doc/l_getidentity.8 | 33 +++++++++++++++++++++++++++++++++ lustre/doc/lustre.7 | 2 +- lustre/utils/.gitignore | 1 - 5 files changed, 35 insertions(+), 21 deletions(-) delete mode 100644 lustre/doc/l_getgroups.8 create mode 100644 lustre/doc/l_getidentity.8 diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am index abce16f..eae6946 100644 --- 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 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 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 --- 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 --- 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 -- 1.8.3.1