From 76965ebc257ef1a090df2b21f107739f6471a9af Mon Sep 17 00:00:00 2001
From: Sebastien Buisson <sbuisson@ddn.com>
Date: Fri, 18 Jan 2019 00:53:50 +0900
Subject: [PATCH] LU-11871 doc: man page for lctl nodemap_set_fileset

Man page for lctl nodemap_set_fileset.

Test-Parameters: trivial
Signed-off-by: Sebastien Buisson <sbuisson@ddn.com>
Change-Id: Icce0b1558621bca84b14f76037a5000002855881
Reviewed-on: https://review.whamcloud.com/34057
Tested-by: Jenkins
Reviewed-by: Andreas Dilger <adilger@whamcloud.com>
Tested-by: Maloo <maloo@whamcloud.com>
Reviewed-by: James Nunez <jnunez@whamcloud.com>
---
 lustre/doc/Makefile.am                |  1 +
 lustre/doc/lctl-nodemap-set-fileset.8 | 57 +++++++++++++++++++++++++++++++++++
 lustre/doc/lctl.8                     |  5 +++
 3 files changed, 63 insertions(+)
 create mode 100644 lustre/doc/lctl-nodemap-set-fileset.8

diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am
index b2dbb4b..628326e 100644
--- a/lustre/doc/Makefile.am
+++ b/lustre/doc/Makefile.am
@@ -143,6 +143,7 @@ SERVER_MANFILES =				\
 	lctl-nodemap-del-idmap.8		\
 	lctl-nodemap-del-range.8		\
 	lctl-nodemap-modify.8			\
+	lctl-nodemap-set-fileset.8		\
 	lctl-lcfg.8				\
 	lctl-barrier.8				\
 	lctl-snapshot-create.8			\
diff --git a/lustre/doc/lctl-nodemap-set-fileset.8 b/lustre/doc/lctl-nodemap-set-fileset.8
new file mode 100644
index 0000000..d224d7f
--- /dev/null
+++ b/lustre/doc/lctl-nodemap-set-fileset.8
@@ -0,0 +1,57 @@
+.TH lctl-nodemap-set-fileset 8 "2019 Jan 17" Lustre "configuration utilities"
+.SH NAME
+lctl-nodemap-set-fileset \- Add a fileset to a nodemap.
+
+.SH SYNOPSIS
+.br
+.B lctl nodemap_set_fileset --name
+.RI < nodemap >
+.B --fileset
+.RI < fileset >
+.br
+.SH DESCRIPTION
+.B nodemap_set_fileset
+adds
+.I fileset
+to the specified
+.IR nodemap .
+The
+.I fileset
+must
+begin with '/'. Clients belonging to
+.I nodemap
+will be automatically
+presented the corresponding
+.I fileset
+when mounting. This means these clients
+are doing an implicit subdirectory mount on the subdirectory represented by
+the defined
+.IR fileset .
+
+.SH OPTIONS
+.I nodemap
+is the name of the nodemap that this fileset should be associated with.
+
+.I fileset
+is the fileset to restrict the clients to. The fileset must begin with '/'.
+
+.SH EXAMPLES
+.nf
+# lctl nodemap_set_fileset --name tenant1 --fileset '/dir1'
+# lctl nodemap_set_fileset --name admins --fileset ''
+.fi
+
+.SH AVAILABILITY
+.B lctl
+is part of the
+.BR Lustre (7)
+filesystem package.
+.SH SEE ALSO
+.BR lustre (7),
+.BR lctl-nodemap-activate (8),
+.BR lctl-nodemap-add (8),
+.BR lctl-nodemap-del (8),
+.BR lctl-nodemap-del-range (8),
+.BR lctl-nodemap-add-idmap (8),
+.BR lctl-nodemap-del-idmap (8),
+.BR lctl-nodemap-modify (8)
diff --git a/lustre/doc/lctl.8 b/lustre/doc/lctl.8
index 5e65d70..521d79e 100644
--- a/lustre/doc/lctl.8
+++ b/lustre/doc/lctl.8
@@ -370,6 +370,11 @@ Delete an existing UID or GID mapping from a nodemap.
 .RS 4
 Modify a nodemap property.
 .RE
+.PP
+\fBlctl-nodemap-set-fileset\fR(8)
+.RS 4
+Add a fileset to a nodemap.
+.RE
 .SS Configuration logs
 .TP
 .BI clear_conf " <device|fsname>"
-- 
1.8.3.1