-.TH lfs 1 "2003 Oct 29" Lustre "configuration utilities"
+.TH lfs 1 "2008 Mar 15" Lustre "user utilities"
.SH NAME
lfs \- Lustre utility to create a file with specific striping pattern, find the striping pattern of exiting files
.SH SYNOPSIS
.br
.B lfs
.br
-.B lfs find [--atime|-A N] [--mtime|-M N] [--ctime|-C N] [--maxdepth|-D N]
- \fB[--print0|-P] [--print|-p] [--obd|-O <uuid>] <dir/file>\fR
+.B lfs check <mds|osts|servers>
.br
-.B lfs find [--quiet|-q] [--verbose|-v] [--recursive|-r] <dir|file>
+.B lfs df [-i] [-h] [path]
+.br
+.B lfs find [[!] --atime|-A [-+]N] [[!] --mtime|-M [-+]N]
+ \fB[[!] --ctime|-C [-+]N] [--maxdepth|-D N] [--name|-n pattern]
+ \fB[--print|-p] \fB[--print0|-P] [--obd|-O <uuid[s]>]
+ \fB[[!] --size|-S [-+]N[kMGTPE]] [--type |-t {bcdflpsD}]
+ \fB[[!] --gid|-g N] [[!] --group|-G <name>]
+ \fB[[!] --uid|-u N] [[!] --user|-U <name>]
+ \fB<dirname|filename>\fR
+.br
+.B lfs osts
.br
.B lfs getstripe [--obd|-O <uuid>] [--quiet|-q] [--verbose|-v]
- \fB[--recursive|-r] <dir/file>\fR
+ \fB[--recursive|-r] <dirname|filename>\fR
.br
-.B lfs setstripe <filename|dirname> <stripe-size> <start-ost> <stripe-cnt>
+.B lfs setstripe [--size|-s stripe-size] [--count|-c stripe-cnt]
+ \fB[--offset|-o start-ost] [--pool|-p pool-name]
+ \fB<dir|filename>\fR
.br
-.B lfs setstripe <filename|dirname> [--size|-s stripe-size] [--index|-i start-ost] [--count|-c stripe-cnt]
+.B lfs setstripe -d <dir>
.br
-.B lfs setstripe -d <dirname>
+.B lfs poollist <filesystem>[.<pool>] | <pathname>
.br
-.B lfs quotachown [-i] <filesystem>
+.B lfs quota [-v] [-o obd_uuid] [-u|-g] <username|groupname> <filesystem>
+.br
+.B lfs quota <filesystem>
+.br
+.B lfs quota -t [-u|-g] <filesystem>
.br
.B lfs quotacheck [-ug] <filesystem>
.br
+.B lfs quotachown [-i] <filesystem>
+.br
.B lfs quotaon [-ugf] <filesystem>
.br
.B lfs quotaoff [-ug] <filesystem>
.br
-.B lfs setquota [-u|-g] <name> <block-softlimit> <block-hardlimit>
- \fB<inode-softlimit> <inode-hardlimit> <filesystem>\fR
+.B lfs setquota [-u|-g] <username|groupname> <block-softlimit>
+ \fB<block-hardlimit> <inode-softlimit> <inode-hardlimit>
+ \fB<filesystem>\fR
.br
.B lfs setquota -t [-u|-g] <block-grace> <inode-grace> <filesystem>
.br
-.B lfs quota [-o obd_uuid] [-u|-g] <name> <filesystem>
+.B lfs quota [-o obd_uuid] [-u|-g] <username|groupname> <filesystem>
.br
.B lfs quota -t [-u|-g] <filesystem>
.br
-.B lfs check <mds| osts| servers>
-.br
-.B lfs df [-i] [-h] [path]
+.B lfs help
.SH DESCRIPTION
.B 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. It can be invoked interactively without any
-arguments or in a non-interactive mode with one of the arguements supported.
+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. It can be invoked interactively without any arguments or in a non-interactive mode with one of the arguements supported.
.SH OPTIONS
The various options supported by lctl are listed and explained below:
.TP
-.B setstripe
-To create a new file with a specific striping pattern
+.B check
+Display the status of MDS or OSTs (as specified in the command) or all the servers (MDS and OSTs)
+.TP
+.B df
+Report filesystem disk space usage or inodes usage of each MDT/OST.
.TP
.B find
-To search the directory tree rooted at the given dir/file name for the files that match the given parameters: \fB--atime\fR (file was last accessed N*24 hours ago), \fB--ctime\fR (file's status was last changed N*24 hours ago), \fB--mtime\fR (file's data was last modified N*24 hours ago), \fB--obd\fR (file has an object on a specific OST). The option \fB--maxdepth\fR allows find to decend at most N levels of directory tree. The options \fB--print\fR and \fB--print0\fR print full file name, followed by a newline and null character correspondingly. Using one of these options works in the new (filename only) mode.
+To search the directory tree rooted at the given dir/file name for the files that match the given parameters: \fB--atime\fR (file was last accessed N*24 hours ago), \fB--ctime\fR (file's status was last changed N*24 hours ago), \fB--mtime\fR (file's data was last modified N*24 hours ago), \fB--obd\fR (file has an object on a specific OST or OSTs), \fB--size\fR (file has size in bytes, or \fBk\fRilo-, \fBM\fRega-, \fBG\fRiga-, \fBT\fRera-, \fBP\fReta-, or \fBE\fRxabytes if a suffix is given), \fB--type\fR (file has the type: \fBb\fRlock, \fBc\fRharacter, \fBd\fRirectory, \fBp\fRipe, \fBf\fRile, sym\fBl\fRink, \fBs\fRocket, or \fBD\fRoor (Solaris)), \fB--uid\fR (file has specific numeric user ID), \fB--user\fR (file owned by specific user, numeric user ID allowed), \fB--gid\fR (file has specific group ID), \fB--group\fR (file belongs to specific group, numeric group ID allowed). The option \fB--maxdepth\fR allows find to decend at most N levels of directory tree. The options \fB--print\fR and \fB--print0\fR print full file name, followed by a newline or NUL character correspondingly. Using \fB!\fR before an option negates its meaning (\fIfiles NOT matching the parameter\fR). Using \fB+\fR before a numeric value means \fIfiles with the parameter OR MORE\fR, while \fB-\fR before a numeric value means \fIfiles with the parameter OR LESS\fR.
.TP
-.B find
-To list the striping info for a given filename or files in a directory or recursively for all files in a directory tree use one of the following options: \fB[--quiet|-q] [--verbose|-v] [--recursive|-r]\fR. If one of these options is given find works in old (obsolete, please use getstripe instead) filename and striping mode.
+.B osts
+List all the OSTs for the filesystem
.TP
-.B getstripe
-To list the striping info for given filename or files in a directory or recursively for all files in a directory tree. It can also be used to list the files that have objects on a specific OST.
+.B getstripe
+To list the striping info for a given filename or files in a directory, optionally recursively, for all files in a directory tree: \fB--quiet\fR (don't print object IDs), \fB--verbose\fR (print striping parameters), \fB--recursive\fR (recurse into subdirectories).
+.TP
+.B setstripe [--size stripe-size] [--count stripe-cnt]
+ \fB[--offset start-ost] [--pool pool-name]\fR
+.br
+To create a new file, or set the directory default, with the specified striping parameters. The
+.I stripe-count
+is the number of OSTs to stripe a file over. A
+.I stripe-count
+of 0 means to use the filesystem-wide default stripe count (default 1), and a
+.I stripe-count
+of -1 means to stripe over all available OSTs. The
+.I stripe-size
+is the number of bytes to store on each OST before moving to the next OST. A
+.I stripe-size
+of 0 means to use the filesystem-wide default stripe size (default 1MB). The
+.I start-ost
+is the OST index (base 10, starting at 0) on which to start striping for this file. A
+.I start-ost
+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
+.I pool-name
+is the name of a predefined pool of OSTs (see
+.I lctl
+) that will be used for striping. The
+.I stripe-count, stripe-size, start-ost
+will be used as well; the
+.I start-ost
+must be part of the pool or an error will be returned.
+.TP
+.B setstripe -d
+Delete the default striping on the specified directory.
+.TP
+.B poollist <filesystem>[.<pool>] | <pathname>
+List the pools in \fBfilesystem\fR or \fBpathname\fR, or the OSTs in \fBfilesystem.pool\fR
.TP
.B quotachown
To change files' owner and group on OSTs of the specified filesystem
.B setquota -t [-u|-g] <block-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
.TP
-.B quota [-o obd_uuid] [-u|-g] <name> <filesystem>
+.B quota [-o obd_uuid] [-u|-g] <username|groupname> <filesystem>
To display disk usage and limits, either for the full filesystem, or for objects on a specific obd. A user or group name must be specified.
.TP
.B quota -t [-u|-g] <filesystem>
To display block and inode grace times for user (-u) or group (-g) quotas
.TP
-.B check
-Display the status of MDS or OSTs (as specified in the command) or all the servers (MDS and OSTs)
-.TP
-.B osts
-List all the OSTs for the filesystem
-.TP
-.B df
-Report filesystem disk space usage or inodes usage of each MDT/OST.
-.TP
.B help
Provides brief help on the various arguments
.TP
Quit the interactive lfs session
.SH EXAMPLES
.TP
-.B $ lfs setstripe /mnt/lustre/file1 131072 -1 2
+.B $ lfs setstripe -s 128k -c 2 /mnt/lustre/file1
This creats a file striped on two OSTs with 128kB on each stripe.
.TP
.B $ lfs setstripe -d /mnt/lustre/dir
This deletes a default stripe pattern on dir. New files will use the default striping pattern created therein.
.TP
-.B $ lfs find /mnt/lustre/file1
-Lists the object allocation of a given file
+.B $ lfs getstripe -v /mnt/lustre/file1
+Lists the detailed object allocation of a given file
.TP
-.B $ lfs find /mnt/lustre/
-Lists the object allocationss of all files in a given directory
+.B $ lfs find /mnt/lustre
+Efficiently lists all files in a given directory and its subdirectories
.TP
-.B $ lfs find -r /mnt/lustre/
-Recursively list the objects of all files in a given directory tree
+.B $ lfs find /mnt/lustre -mtime +30 -type f -print
+Recursively list all regular files in given directory more than 30 days old
.TP
-.B $ lfs find -r --obd OST2-UUID /mnt/lustre/
+.B $ lfs find --obd OST2-UUID /mnt/lustre/
Recursively list all files in a given directory that have objects on OST2-UUID.
+.tP
+.B $ lfs check servers
+Check the status of all servers (MDT, OST)
+.TP
+.B $ lfs osts
+List all the OSTs
+.TP
+.B $ lfs df -h
+Lists space usage per OST and MDT in human readable format.
+.TP
+.B $ lfs df -i
+Lists inode usage per OST and MDT
.TP
.B $ lfs quotachown -i /mnt/lustre
Change file owner and group
.TP
.B $ lfs quota -t -u /mnt/lustre
Show grace times for user quotas on /mnt/lustre
-.TP
-.B $ lfs check servers
-Check the status of all servers (MDT, OST)
-.TP
-.B $ lfs osts
-List all the OSTs
-.TP
-.B $ lfs df -i
-Lists inode consumpton per OST and MDT
.SH BUGS
-None are known.
+The \fBlfs find\fR command isn't as comprehensive as \fBfind\fR(1).
+Report bugs using http://bugzilla.lustre.org.
+.SH AUTHOR
+The lfs command is part of the Lustre filesystem. Contact http://www.lustre.org/
+.SH SEE ALSO
+.BR lctl (8),
+.BR lustre (7)