Provided by:
lustre-utils_1.8.5+dfsg-3ubuntu1_i386 
NAME
lfs - Lustre utility to create a file with specific striping pattern,
find the striping pattern of existing files
SYNOPSIS
lfs
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>]
<directory|filename>
lfs osts [path]
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 setstripe [--size|-s stripe-size] [--count|-c stripe-cnt]
[--index|-i|--offset|-o start_ost_index ] [--pool|-p <pool>]
<directory|filename>
lfs setstripe -d <dir>
lfs poollist <filesystem>[.<pool>] | <pathname>
lfs quota [-q] [-v] [-o obd_uuid] [<-u|-g> <uname>|<uid>|<gname><gid>]
<filesystem>
lfs quota -t <-u|-g> <filesystem>
lfs quotacheck [-ug] <filesystem>
lfs quotachown [-i] <filesystem>
lfs quotaon [-ugf] <filesystem>
lfs quotaoff [-ug] <filesystem>
lfs quotainv [-ug] [-f] <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 help
DESCRIPTION
lfs can be used to create a new file with a specific striping pattern,
determine the default striping pattern, gather the extended attributes
(object numbers and location) for a specific file, find files with
specific attributes, list OST information, or set quota limits. It can
be invoked interactively without any arguments or in a non-interactive
mode with one of the arguments supported.
OPTIONS
The various options supported by lctl are listed and explained below:
check Display the status of MDS or OSTs (as specified in the command)
or all the servers (MDS and OSTs)
df [-i] [-h] [--pool|-p <fsname>[.<pool>] [path]
Report filesystem disk space usage or inodes usage (with -i) of
each MDT/OST, or a subset of OSTs if a pool is specified with
-p. By default print the usage of all mounted Lustre
filesystems, otherwise if path is specified print only the usage
of that filesystem. If -h is given, the output is printed in
human readable format, using SI base-2 suffixes for Mega-,
Giga-, Tera-, Peta-, or Exabytes.
find To search the directory tree rooted at the given dir/file name
for the files that match the given parameters: --atime (file was
last accessed N*24 hours ago), --ctime (file's status was last
changed N*24 hours ago), --mtime (file's data was last modified
N*24 hours ago), --obd (file has an object on a specific OST or
OSTs), --size (file has size in bytes, or kilo-, Mega-, Giga-,
Tera-, Peta-, or Exabytes if a suffix is given), --type (file
has the type: block, character, directory, pipe, file, symlink,
socket, or Door (Solaris)), --uid (file has specific numeric
user ID), --user (file owned by specific user, numeric user ID
allowed), --gid (file has specific group ID), --group (file
belongs to specific group, numeric group ID allowed). The option
--maxdepth limits find to decend at most N levels of directory
tree. The options --print and --print0 print full file name,
followed by a newline or NUL character correspondingly. Using !
before an option negates its meaning (files NOT matching the
parameter). Using + before a numeric value means files with the
parameter OR MORE, while - before a numeric value means files
with the parameter OR LESS.
osts [path] List all the OSTs for all mounted filesystems. If a path
is provided that is located on a lustre mounted file system then
only the OSTs belonging to that filesystem are displayed.
getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
[--count | -c ] [--size | -s ] [--index | -i ]
[--offset | -o ] [--pool | -p ] [--directory | -d ]
[--recursive|-r] <dirname|filename>
List the striping information for a given filename or directory
tree. By default the stripe count, size, and offset will be
returned. If you only want specific striping information then
the options of --count, --size, --index, --offset, or --pool can
be used to return only the specific fields.
In the case where you only want details about the files' object
id information then the --quiet option is used. Additional
information available about striping can be displayed with
--verbose. The default behavior when a directory is specified
is to list the striping information for all files within the
specified directory (like 'ls -l'). This can be expanded with
--recursive which will recurse into all subdirectories. If you
wish to get striping information for only the specified
directory, then --directory can be used to limit the
information, like 'ls -d'). You can limit the returned files to
those with objects on a specific OST with --obd.
setstripe [--size stripe-size] [--count stripe-cnt]
[--offset start-ost] [--pool <pool>] {directory|filename}
To create a new file, or set the directory default, with the
specified striping parameters. The stripe_count is the number
of OSTs to stripe a file over. A stripe_count of 0 means to use
the filesystem-wide default stripe count (default 1), and a
stripe_count of -1 means to stripe over all available OSTs. The
stripe_size is the number of bytes to store on each OST before
moving to the next OST. A stripe_size of 0 means to use the
filesystem-wide default stripe size (default 1MB). The
start_ost_index is the OST index (starting at 0) on which to
start striping for this file. A start_ost_index of -1 allows
the MDS to choose the starting index and it is strongly
recommended, as this allows space and load balancing to be done
by the MDS as needed. The poolname is the name of a predefined
pool of OSTs (see lctl ) that will be used for striping. The
stripe_count, stripe_size, and start_ost_index will be used as
well; the start_ost_index must be part of the pool or an error
will be returned.
setstripe -d
Delete the default striping on the specified directory.
poollist
{filesystem}[.poolname] | {pathname} List the pools in
filesystem or pathname, or the OSTs in filesystem.pool.
quotachown
To change files' owner and group on OSTs of the specified
filesystem
quotacheck [-ugf] <filesystem>
To scan the specified filesystem for disk usage, and create or
update quota files. Options specify quota for users (-u) groups
(-g) and force (-f)
quotaon [-ugf] <filesystem>
To turn filesystem quotas on. Options specify quota for users
(-u) groups (-g) and force (-f)
quotaoff [-ugf] <filesystem>
To turn filesystem quotas off. Options specify quota for users
(-u) groups (-g) and force (-f)
quotainv [-ug] [-f] <filesystem>
Clear quota files (administrative quota files if used without
-f, operational quota files otherwise), all of their quota
entries, for (-u) users or (-g) groups; after quotainv one must
use quotacheck before using quotas. DO NOT USE THIS COMMAND
UNLESS YOU REALLY KNOW WHAT IT DOES. IT IS MAINLY FOR INTERNAL
PURPOSES.
setquota <-u|-g> <uname>|<uid>|<gname>|<gid> [--block-softlimit <block-
softlimit>] [--block-hardlimit <block-hardlimit>] [--inode-softlimit
<inode-softlimit>] [--inode-hardlimit <inode-hardlimit>] <filesystem>
To set filesystem quotas for users or groups. Limits can be
specified with -b, -k, -m, -g, -t, -p suffixes which specify
units of 1, 2^10, 2^20, 2^30, 2^40 and 2^50 accordingly. Block
limits unit is kilobyte (1024) by default and block limits are
always kilobyte-grained (even if specified in bytes), see
EXAMPLES
setquota -t <-u|-g> [--block-grace <block-grace>] [--inode-grace
<inode-grace>] <filesystem>
To set filesystem quota grace times for users or groups. Grace
time is specified in "XXwXXdXXhXXmXXs" format or as an integer
seconds value, see EXAMPLES
quota [-q] [-v] [-o obd_uuid] [ -u|-g <uname|uid|gname|gid> ]
<filesystem>
To display disk usage and limits, either for the full
filesystem, or for objects on a specific obd. A user or group
name or an ID can be specified. If both user and group are
omitted quotas for current uid/gid are shown. -v provides more
verbose (with per-obd statistics) output. -q disables printing
of additional descriptions (including column titles).
quota -t <-u|-g> <filesystem>
To display block and inode grace times for user (-u) or group
(-g) quotas
help Provides brief help on the various arguments
exit/quit
Quit the interactive lfs session
EXAMPLES
$ lfs setstripe -s 128k -c 2 /mnt/lustre/file1
This creates a file striped on two OSTs with 128kB on each
stripe.
$ lfs setstripe -d /mnt/lustre/dir
This deletes a default stripe pattern on dir. New files will use
the default striping pattern created therein.
$ lfs getstripe -v /mnt/lustre/file1
Lists the detailed object allocation of a given file
$ lfs find /mnt/lustre
Efficiently lists all files in a given directory and its
subdirectories
$ lfs find /mnt/lustre -mtime +30 -type f -print
Recursively list all regular files in given directory more than
30 days old
$ lfs find --obd OST2-UUID /mnt/lustre/
Recursively list all files in a given directory that have
objects on OST2-UUID.
$ lfs check servers
Check the status of all servers (MDT, OST)
$ lfs osts
List all the OSTs
$ lfs df -h
Lists space usage per OST and MDT in human readable format.
$ lfs df -i
Lists inode usage per OST and MDT
$ lfs df --pool <filesystem>[.<pool>] | <pathname>
List space or inode usage for a specific OST pool
$ lfs quotachown -i /mnt/lustre
Change file owner and group
$ lfs quotacheck -ug /mnt/lustre
Quotacheck for user and group - will turn on quotas after making
the check.
$ lfs quotaon -ug /mnt/lustre
Turn quotas of user and group on
$ lfs quotaoff -ug /mnt/lustre
Turn quotas of user and group off
$ lfs setquota -u bob --block-softlimit 2000000 --block-hardlimit
1000000 /mnt/lustre
Set quotas of user `bob': 1GB block quota hardlimit and 2 GB
block quota softlimit
$ lfs setquota -t -u --block-grace 1000 --inode-grace 1w4d /mnt/lustre
Set grace times for user quotas: 1000 seconds for block quotas,
1 week and 4 days for inode quotas
$ lfs quota -u bob /mnt/lustre
List quotas of user `bob'
$ lfs quota -t -u /mnt/lustre
Show grace times for user quotas on /mnt/lustre
BUGS
The lfs find command isn't as comprehensive as find(1). Report bugs
using http://bugzilla.lustre.org.
AUTHOR
The lfs command is part of the Lustre filesystem. Contact
http://www.lustre.org/
SEE ALSO
lctl(8), lustre(7)