<section remap="h5">
<title>Synopsis</title>
<screen>lfs
-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 changelog [--follow] <replaceable>mdt_name</replaceable> [startrec [endrec]]
+lfs changelog_clear <replaceable>mdt_name id endrec</replaceable>
+lfs check <replaceable>mds|osts|servers</replaceable>
+lfs df [-i] [-h] [--pool]-p <replaceable>fsname</replaceable>[.<replaceable>pool</replaceable>] [<replaceable>path</replaceable>]
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]>]
+ [[!] --ctime|-C [-+]N] [--maxdepth|-D N] [--name|-n <replaceable>pattern</replaceable>]
+ [--print|-p] [--print0|-P] [[!] --obd|-O <replaceable>ost_name</replaceable>[,<replaceable>ost_name...</replaceable>]]
[[!] --size|-S [+-]N[kMGTPE]] --type |-t {bcdflpsD}]
- [[!] --gid|-g|--group|-G <gname>|<gid>]
- [[!] --uid|-u|--user|-U <uname>|<uid>]
- <dirname|filename>
+ [[!] --gid|-g|--group|-G <replaceable>gname|gid</replaceable>]
+ [[!] --uid|-u|--user|-U <replaceable>uname|uid</replaceable>]
+ <replaceable>dirname|filename</replaceable>
lfs getname [-h]|[path...]
-lfs getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
+lfs getstripe [--obd|-O <replaceable>ost_name</replaceable>] [--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>
+ [--recursive|-r] [--raw|-R] [-M] <replaceable>dirname|filename</replaceable> ...
+lfs setstripe [--size|-s stripe_size] [--count|-c <replaceable>stripe_count</replaceable>]
+ [--index|-i|--offset|-o <replaceable>start_ost_index</replaceable>]
+ [--pool|-p <replaceable>pool</replaceable>]
+ <replaceable>dirname|filename</replaceable>
+lfs setstripe -d <replaceable>dir</replaceable>
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 -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>
-lfs setquota -t <-u|-g>
- [--block-grace <block-grace>]
- [--inode-grace <inode-grace>]
- <filesystem>
-lfs setquota -t <-u|-g>
- [-b <block-grace>] [-i <inode-grace>]
- <filesystem>
+lfs poollist <replaceable>filesystem</replaceable>[.<replaceable>pool</replaceable>]|<replaceable>pathname</replaceable>
+lfs quota [-q] [-v] [-o <replaceable>obd_uuid</replaceable>|-I <replaceable>ost_idx</replaceable>|-i <replaceable>mdt_idx</replaceable>]
+ [-u <replaceable>username|uid|-g</replaceable> <replaceable>group|gid</replaceable>]
+ <replaceable>/mount_point</replaceable>
+lfs quota -t -u|-g <replaceable>/mount_point</replaceable>
+lfs quotacheck [-ug] <replaceable>/mount_point</replaceable>
+lfs quotachown [-i] <replaceable>/mount_point</replaceable>
+lfs quotainv [-ug] [-f] <replaceable>/mount_point</replaceable>
+lfs quotaon [-ugf] <replaceable>/mount_point</replaceable>
+lfs quotaoff [-ug] <replaceable>/mount_point</replaceable>
+lfs setquota {-u|--user|-g|--group} <replaceable>uname|uid|gname|gid</replaceable>
+ [--block-softlimit <replaceable>block_softlimit</replaceable>]
+ [--block-hardlimit <replaceable>block_hardlimit</replaceable>]
+ [--inode-softlimit <replaceable>inode_softlimit</replaceable>]
+ [--inode-hardlimit <replaceable>inode_hardlimit</replaceable>]
+ <replaceable>/mount_point</replaceable>
+lfs setquota -u|--user|-g|--group <replaceable>uname|uid|gname|gid</replaceable>
+ [-b <replaceable>block_softlimit</replaceable>] [-B <replaceable>block_hardlimit</replaceable>]
+ [-i <replaceable>inode-softlimit</replaceable>] [-I <replaceable>inode_hardlimit</replaceable>]
+ <replaceable>/mount_point</replaceable>
+lfs setquota -t -u|-g
+ [--block-grace <replaceable>block_grace</replaceable>]
+ [--inode-grace <replaceable>inode_grace</replaceable>]
+ <replaceable>/mount_point</replaceable>
+lfs setquota -t -u|-g
+ [-b <replaceable>block_grace</replaceable>] [-i <replaceable>inode_grace</replaceable>]
+ <replaceable>/mount_point</replaceable>
lfs help
</screen>
<note>
- <para>In the above example, the <literal><filesystem></literal> parameter refers to the mount point of the Lustre file system. The default mount point is <literal>/mnt/lustre</literal></para>
+ <para>In the above example, the <literal><replaceable>/mount_point</replaceable></literal> parameter refers to the mount point of the Lustre file system.</para>
</note>
<note>
<para>The old lfs quota output was very detailed and contained cluster-wide quota statistics (including cluster-wide limits for a user/group and cluster-wide usage for a user/group), as well as statistics for each MDS/OST. Now, <literal>lfs quota</literal> has been updated to provide only cluster-wide statistics, by default. To obtain the full report of cluster-wide limits, usage and statistics, use the <literal>-v</literal> option with <literal>lfs quota</literal>.</para>
<para> <literal>changelog_clear</literal></para>
</entry>
<entry>
- <para>Indicates that changelog records previous to <literal><endrec></literal> are no longer of interest to a particular consumer <literal><id></literal>, potentially allowing the MDT to free up disk space. An <literal><endrec></literal> of 0 indicates the current last record. Changelog consumers must be registered on the MDT node using <literal>lctl</literal>.</para>
+ <para>Indicates that changelog records previous to <literal><replaceable>endrec</replaceable></literal> are no longer of interest to a particular consumer <literal><replaceable>id</replaceable></literal>, potentially allowing the MDT to free up disk space. An <literal><replaceable>endrec</replaceable></literal> of 0 indicates the current last record. Changelog consumers must be registered on the MDT node using <literal>lctl</literal>.</para>
</entry>
</row>
<row>
</row>
<row>
<entry nameend="c2" namest="c1">
- <literal> df [-i] [-h] [--pool|-p <fsname>[.<pool>] [path] </literal>
+ <literal> df [-i] [-h] [--pool|-p <replaceable>fsname</replaceable>[.<replaceable>pool</replaceable>] [<replaceable>path</replaceable>] </literal>
</entry>
<entry>
<para>Report file system disk space usage or inode usage (with <literal>-i</literal>) of each MDT/OST or a subset of OSTs if a pool is specified with <literal>-p</literal>. By default, prints the usage of all mounted Lustre file systems. Otherwise, if path is specified, prints only the usage of that file system. If <literal>-h</literal> is given, the output is printed in human-readable format, using SI base-2 suffixes for <emphasis role="bold">M</emphasis>ega-, <emphasis role="bold">G</emphasis>iga-, <emphasis role="bold">T</emphasis>era-, <emphasis role="bold">P</emphasis>eta-, or <emphasis role="bold">E</emphasis>xabytes.</para>
<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>
+ <para condition='l24'>The <literal>-M</literal> prints the index of the MDT for a given directory. See <xref linkend='dbdoclet.rmremotedir'/>.</para>
</entry>
</row>
<row>
<para>  </para>
</entry>
<entry>
- <para> <literal>--obd <uuid></literal></para>
+ <para> <literal>--obd <replaceable>ost_name</replaceable></literal></para>
</entry>
<entry>
<para>Lists files that have an object on a specific OST.</para>
<para>  </para>
</entry>
<entry>
- <para> <literal>--pool <pool></literal></para>
+ <para> <literal>--pool <replaceable>pool</replaceable></literal></para>
</entry>
<entry>
<para>Name of the pre-defined pool of OSTs (see <xref linkend="dbdoclet.50438219_38274"/>) that will be used for striping. The <literal>stripe_cnt</literal>, <literal>stripe_size</literal> and <literal>start_ost</literal> values are used as well. The start-ost value must be part of the pool or an error is returned.</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quota [-q] [-v] [-o obd_uuid|-i mdt_idx|-I ost_idx] [-u|-g <uname>|<uid>|<gname>|<gid>] <filesystem></literal></para>
+ <para> <literal>quota [-q] [-v] [-o <replaceable>obd_uuid</replaceable>|-i <replaceable>mdt_idx</replaceable>|-I <replaceable>ost_idx</replaceable>] [-u|-g <replaceable>uname|uid|gname|gid]</replaceable> <replaceable>/mount_point</replaceable></literal></para>
<para> </para>
</entry>
<entry>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quota -t <-u|-g> <filesystem></literal></para>
+ <para> <literal>quota -t <replaceable>-u|-g</replaceable> <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Displays block and inode grace times for user (<literal>-u</literal>) or group (<literal>-g</literal>) quotas.</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quotacheck [-ugf] <filesystem></literal></para>
+ <para> <literal>quotacheck [-ugf] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Scans the specified file system for disk usage, and creates or updates quota files. Options specify quota for users (<literal>-u</literal>), groups (<literal>-g</literal>), and force (<literal>-f</literal>).</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quotaon [-ugf] <filesystem></literal></para>
+ <para> <literal>quotaon [-ugf] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Turns on file system quotas. Options specify quota for users (<literal>-u</literal>), groups (<literal>-g</literal>), and force (<literal>-f</literal>).</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quotaoff [-ugf] <filesystem></literal></para>
+ <para> <literal>quotaoff [-ugf] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Turns off file system quotas. Options specify quota for users (<literal>-u</literal>), groups (<literal>-g</literal>), and force (<literal>-f</literal>).</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>quotainv [-ug] [-f] <filesystem></literal></para>
+ <para> <literal>quotainv [-ug] [-f] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para> Clears quota files (administrative quota files if used without <literal>-f</literal>, operational quota files otherwise), all of their quota entries for users (<literal>-u</literal>) or groups (<literal>-g</literal>). After running <literal>quotainv</literal>, you must run <literal>quotacheck</literal> before using quotas.</para>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para> <literal>setquota <-u|-g> <uname>|<uid>|<gname>|<gid> [--block-softlimit <block-softlimit>] [--block-hardlimit <block-hardlimit>] [--inode-softlimit <inode-softlimit>] [--inode-hardlimit <inode-hardlimit>] <filesystem></literal></para>
+ <para> <literal>setquota -u|-g <replaceable>uname|uid|gname|gid}</replaceable> [--block-softlimit <replaceable>block_softlimit</replaceable>] [--block-hardlimit <replaceable>block_hardlimit</replaceable>] [--inode-softlimit <replaceable>inode_softlimit</replaceable>] [--inode-hardlimit <replaceable>inode_hardlimit</replaceable>] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Sets file system quotas for users or groups. Limits can be specified with <literal>--{block|inode}-{softlimit|hardlimit}</literal> or their short equivalents <literal>-b</literal>, <literal>-B</literal>, <literal>-i</literal>, <literal>-I</literal>. Users can set 1, 2, 3 or 4 limits.<footnote>
</row>
<row>
<entry nameend="c2" namest="c1">
- <para><literal> setquota -t <-u|-g> [--block-grace <block-grace>] [--inode-grace <inode-grace>] <filesystem></literal></para>
+ <para><literal> setquota -t -u|-g [--block-grace <replaceable>block_grace</replaceable>] [--inode-grace <replaceable>inode_grace</replaceable>] <replaceable>/mount_point</replaceable></literal></para>
</entry>
<entry>
<para>Sets the file system quota grace times for users or groups. Grace time is specified in '<literal>XXwXXdXXhXXmXXs</literal>' format or as an integer seconds value. See <xref linkend="dbdoclet.50438206_11903"/>.</para>
<para>Lists inode usage per OST and MDT.</para>
<screen>$ lfs df -i</screen>
<para>List space or inode usage for a specific OST pool.</para>
- <screen>$ lfs df --pool <filesystem>[.<pool>] | <pathname></screen>
+ <screen>$ lfs df --pool <replaceable>filesystem</replaceable>[.<replaceable>pool</replaceable>] | <replaceable>pathname</replaceable></screen>
<para>List quotas of user 'bob'.</para>
<screen>$ lfs quota -u bob /mnt/lustre</screen>
<para>Show grace times for user quotas on /mnt/lustre.</para>
<para>The <literal>e2fsck</literal> utility is run on each of the local MDS and OST device file systems and verifies that the underlying <literal>ldiskfs</literal> is consistent. After <literal>e2fsck</literal> is run, <literal>lfsck</literal> does distributed coherency checking for the Lustre file system. In most cases, <literal>e2fsck</literal> is sufficient to repair any file system issues and <literal>lfsck</literal> is not required.</para>
<section remap="h5">
<title>Synopsis</title>
- <screen>lfsck [-c|--create] [-d|--delete] [-f|--force] [-h|--help] [-l|--lostfound] [-n|--nofix] [-v|--verbose] --mdsdb mds_database_file --ostdb ost1_database_file [ost2_database_file...] <filesystem>
+ <screen>lfsck [-c|--create] [-d|--delete] [-f|--force] [-h|--help] [-l|--lostfound] [-n|--nofix] [-v|--verbose] --mdsdb <replaceable>mds_database_file</replaceable> --ostdb <replaceable>ost1_database_file</replaceable>[<replaceable>ost2_database_file</replaceable>...] <replaceable>/mount_point</replaceable>
</screen>
<note>
- <para>As shown, the <literal><filesystem></literal> parameter refers to the Lustre file system mount point. The default mount point is <literal>/mnt/lustre</literal>.</para>
+ <para>As shown, the <literal><replaceable>/mount_point</replaceable></literal> parameter refers to the Lustre file system mount point. The default mount point is <literal>/mnt/lustre</literal>.</para>
</note>
<note>
<para>For <literal>lfsck</literal>, database filenames must be provided as absolute pathnames. Relative paths do not work, the databases cannot be properly opened.</para>
<para><literal>mds_database_file</literal></para>
</entry>
<entry>
- <para>MDS database file created by running <literal>e2fsck</literal> <literal>--mdsdb</literal> <literal>mds_database_file</literal> <literal><device></literal> on the MDS backing device. This is required.</para>
+ <para>MDT database file created by running <literal>e2fsck --mdsdb <replaceable>mds_database_file</replaceable> <replaceable>/dev/mdt_device</replaceable></literal> on the MDT backing device. This is required.</para>
</entry>
</row>
<row>
<entry>
- <para> <literal>--ostdb ost1_database_file</literal></para>
- <para><literal>[ost2_database_file...]</literal></para>
+ <para> <literal>--ostdb <replaceable>ost1_database_file</replaceable></literal></para>
+ <para><literal>[<replaceable>ost2_database_file</replaceable>...]</literal></para>
</entry>
<entry>
- <para>OST database files created by running <literal>e2fsck</literal> <literal>--ostdb ost_database_file <device></literal> on each of the OST backing devices. These are required unless an OST is unavailable, in which case all objects thereon are considered missing.</para>
+ <para>OST database files created by running <literal>e2fsck --ostdb <replaceable>ost_database_file</replaceable> <replaceable>/dev/ost_device</replaceable></literal> on each of the OST backing devices. These are required unless an OST is unavailable, in which case all objects thereon are considered missing.</para>
</entry>
</row>
</tbody>