LUDOC-2 add "--raw" option to "lfs getstripe"

A new option to "lfs getstripe" is introduced; the "--raw" or
"-R" option.

If this option is specified, the stripe information is printed
without substituting the filesystem's default values for
unspecified fields. If the striping EA is not set, 0, 0, and -1
will be printed for the stripe count, size, and offset respectively.

Signed-off-by: Yu Jian <yujian@whamcloud.com>
Change-Id: I2d4a1bf8fd063afb40345609db9c8204d6e3cc09

diff --git a/UserUtilities.xml b/UserUtilities.xml
index 3dfba45..76fa03e 100644 (file)
--- a/UserUtilities.xml
+++ b/UserUtilities.xml
@@ -34,49 +34,51 @@ lfs changelog [--follow] <mdtname> [startrec [endrec]]
 lfs changelog_clear <mdtname> <id> <endrec>
 lfs check <mds|osts|servers>
 lfs df [-i] [-h] [--pool]-p <fsname>[.<pool>] [path]
-lfs find [[!] --atime|-A [-+]N] [[!] --mtime|-M [-+]N] 
-   [[!] --ctime|-C [-+]N] [--maxdepth|-D N] [--name|-n <pattern>]
-   [--print|-p] [--print0|-P] [[!] --obd|-O <uuid[s]>] 
-   [[!] --size|-S [+-]N[kMGTPE]] --type |-t {bcdflpsD}]
-   [[!] --gid|-g|--group|-G <gname>|<gid>]
-   [[!] --uid|-u|--user|-U <uname>|<uid>]
-   <dirname|filename>
-lfs getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
-                   [--count|-c] [--index|-i | --offset|-o]
-                   [--size|-s] [--pool|-p] [--directory|-d]
-                   [--recursive|-r] <dirname|filename> ...
+lfs find [[!] --atime|-A [-+]N] [[!] --mtime|-M [-+]N]
+         [[!] --ctime|-C [-+]N] [--maxdepth|-D N] [--name|-n <pattern>]
+         [--print|-p] [--print0|-P] [[!] --obd|-O <uuid[s]>]
+         [[!] --size|-S [+-]N[kMGTPE]] --type |-t {bcdflpsD}]
+         [[!] --gid|-g|--group|-G <gname>|<gid>]
+         [[!] --uid|-u|--user|-U <uname>|<uid>]
+         <dirname|filename>
 lfs getname [-h]|[path...]
+lfs getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
+              [--count|-c] [--index|-i | --offset|-o]
+              [--size|-s] [--pool|-p] [--directory|-d]
+              [--recursive|-r] [--raw|-R] <dirname|filename> ...
+lfs setstripe [--size|-s stripe_size] [--count|-c stripe_cnt]
+              [--index|-i|--offset|-o start_ost_index]
+              [--pool|-p <pool>]
+              <dirname|filename>
+lfs setstripe -d <dir>
 lfs osts [path]
 lfs poollist <filesystem>[.<pool>]|<pathname>
-lfs quota [-q] [-v] [-o obd_uuid|-I ost_idx|-i mdt_idx] [-u <uname>| -u <uid>|-g <gname>| -g <gid>] <filesystem>
+lfs quota [-q] [-v] [-o obd_uuid|-I ost_idx|-i mdt_idx]
+          [-u <uname>|-u <uid>|-g <gname>|-g <gid>]
+          <filesystem>
 lfs quota -t <-u|-g> <filesystem>
 lfs quotacheck [-ug] <filesystem>
 lfs quotachown [-i] <filesystem>
 lfs quotainv [-ug] [-f] <filesystem>
 lfs quotaon [-ugf] <filesystem>
 lfs quotaoff [-ug] <filesystem>
-lfs setquota               <-u|--user|-g|--group> <uname|uid|gname|gid>
-                   [--block-softlimit <block-softlimit>]
-                   [--block-hardlimit <block-hardlimit>]
-                   [--inode-softlimit <inode-softlimit>]
-                   [--inode-hardlimit <inode-hardlimit>]
-                   <filesystem>
 lfs setquota <-u|--user|-g|--group> <uname|uid|gname|gid>
-           [-b <block-softlimit>] [-B <block-hardlimit>]
-           [-i <inode-softlimit>] [-I <inode-hardlimit>] 
-           <filesystem>
+             [--block-softlimit <block-softlimit>]
+             [--block-hardlimit <block-hardlimit>]
+             [--inode-softlimit <inode-softlimit>]
+             [--inode-hardlimit <inode-hardlimit>]
+             <filesystem>
+lfs setquota <-u|--user|-g|--group> <uname|uid|gname|gid>
+             [-b <block-softlimit>] [-B <block-hardlimit>]
+             [-i <inode-softlimit>] [-I <inode-hardlimit>]
+             <filesystem>
 lfs setquota -t <-u|-g>
-           [--block-grace <block-grace>]
-           [--inode-grace <inode-grace>]
-           <filesystem>
+             [--block-grace <block-grace>]
+             [--inode-grace <inode-grace>]
+             <filesystem>
 lfs setquota -t <-u|-g>
-           [-b <block-grace>] [-i <inode-grace>]
-           <filesystem>
-lfs setstripe              [--size|-s stripe_size] [--count|-c stripe_cnt] 
-           [--index|-i|--offset|-o start_ost_index] 
-           [--pool|-p <pool>]
-           <dirname|filename>
-lfs setstripe -d <dir>
+             [-b <block-grace>] [-i <inode-grace>]
+             <filesystem>
 lfs help
 </screen>
       <note>
@@ -305,6 +307,7 @@ lfs help
               <entry>
                 <para>Lists striping information for a given filename or directory. By default, the stripe count, stripe size and offset are returned.</para>
                 <para>If you only want specific striping information, then the options of <literal>--count</literal>,<literal>--size</literal>,<literal>--index</literal> or <literal>--offset</literal> plus various combinations of these options can be used to retrieve specific information.</para>
+                <para>If the <literal>--raw</literal> option is specified, the stripe information is printed without substituting the filesystem's default values for unspecified fields. If the striping EA is not set, 0, 0, and -1 will be printed for the stripe count, size, and offset respectively.</para>
               </entry>
             </row>
             <row>