LU-8616 utils: document specific MDT index selection

Document the "lfs setdirstripe -i" ability to specify explicit MDT
index values for striped direcotories.

Test-Parameters: trivial
Signed-off-by: Andreas Dilger <adilger@whamcloud.com>
Change-Id: I23b0b5211677bc935b37ebbbfa0a2999c03ebbe5
Reviewed-on: https://review.whamcloud.com/33216
Tested-by: Jenkins
Tested-by: Maloo <hpdd-maloo@intel.com>
Reviewed-by: Lai Siyao <lai.siyao@whamcloud.com>
Reviewed-by: Jian Yu <yujian@whamcloud.com>
Reviewed-by: Oleg Drokin <green@whamcloud.com>

diff --git a/lustre/doc/lfs-setdirstripe.1 b/lustre/doc/lfs-setdirstripe.1
index c603178..78cb3a2 100644 (file)
--- a/lustre/doc/lfs-setdirstripe.1
+++ b/lustre/doc/lfs-setdirstripe.1
@@ -18,10 +18,13 @@ Stripe the new directory over
 .I COUNT
 MDTs.
 .TP
-.BR \-i ", " \-\-mdt\-index =\fISTART_MDT_INDEX\fR
+.BR \-i ", " \-\-mdt\-index =\fISTART_MDT_INDEX\fR[,\fIMDT_INDEX ...]
 Use the MDT whose index is
 .I START_MDT_INDEX
-as the master/starting MDT for the directory. If -1 (default) is set, it will randomly pick
+as the master/starting MDT for the directory. If multiple
+.I MDT_INDEX
+values are given, then the stripes will be allocated on the specified
+MDT indices.  If index -1 (default) is used, it will randomly pick
 .I COUNT
 less full MDTs.
 .TP

diff --git a/lustre/utils/lfs.c b/lustre/utils/lfs.c
index e86c86d..e21b059 100644 (file)
--- a/lustre/utils/lfs.c
+++ b/lustre/utils/lfs.c
@@ -243,10 +243,10 @@ static inline int lfs_mirror_split(int argc, char **argv)
        "\tnon-block:    Abort migrations if concurrent access is detected\n" \
        "\tnon-direct:   Do not use direct I/O to copy file contents\n" \
 
-#define SETDIRSTRIPE_USAGE                                     \
-       "               [--mdt-count|-c stripe_count>\n"        \
-       "               [--mdt-index|-i mdt_index]\n"           \
-       "               [--mdt-hash|-H mdt_hash]\n"             \
+#define SETDIRSTRIPE_USAGE                                             \
+       "               [--mdt-count|-c stripe_count>\n"                \
+       "               [--mdt-index|-i mdt_index[,mdt_index,...]\n"    \
+       "               [--mdt-hash|-H mdt_hash]\n"                     \
        "               [--default|-D] [--mode|-m mode] <dir>\n"        \
        "\tstripe_count: stripe count of the striped directory\n"       \
        "\tmdt_index: MDT index of first stripe\n"                      \