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>

diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am
index b2dbb4b..628326e 100644 (file)
--- 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-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                  \
        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 (file)
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 (file)
--- 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
 .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>"
 .SS Configuration logs
 .TP
 .BI clear_conf " <device|fsname>"