X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flfs.1;h=5953ad4b214b0f8f702b3e23dc561ceecb877778;hb=ed5e47ac21b02abb16b10446dac7dae722259f0a;hp=882f1bb7dd1281eced548b54b718f952fc9bc5a0;hpb=8303b71ba4714a5d290daf9f7cd6ed895696bfe3;p=fs%2Flustre-release.git diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1 index 882f1bb..5953ad4 100644 --- a/lustre/doc/lfs.1 +++ b/lustre/doc/lfs.1 @@ -19,21 +19,24 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the \fB[[!] --size|-S [-+]N[kMGTPE]] [--type |-t {bcdflpsD}] \fB[[!] --gid|-g|--group|-G |] \fB[[!] --uid|-u|--user|-U |] - \fB\fR + \fB\fR .br -.B lfs osts +.B lfs getname [-h]|[path ...] .br .B lfs getstripe [--obd|-O ] [--quiet|-q] [--verbose|-v] - \fB[--count | -c ] [--size | -s ] [--index | -i ] - \fB[--offset | -o ] [--pool | -p ] [--directory | -d ] - \fB[--recursive|-r] \fR + \fB[--count | -c ] [--index | -i | --offset | -o ] + \fB[--size | -s ] [--pool | -p ] [--directory | -d ] + \fB[--recursive | -r] [--raw|-R] ...\fR .br .B lfs setstripe [--size|-s stripe-size] [--count|-c stripe-cnt] - \fB[--offset|-o start-ost] [--pool|-p ] - \fB\fR + \fB[--index|-i|--offset|-o start_ost_index ] [--pool|-p ] + \fB\fR .br .B lfs setstripe -d .br +.B lfs osts +.RB [ path ] +.br .B lfs poollist [.] | .br .B lfs quota [-q] [-v] [-o obd_uuid|-I ost_idx|-i mdt_idx] [-u | -u |-g | -g ] @@ -101,48 +104,101 @@ for \fBM\fRega-, \fBG\fRiga-, \fBT\fRera-, \fBP\fReta-, or \fBE\fRxabytes. .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 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 limits 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 getname [-h]|[path ...] +Report all the Lustre mount points and the corresponding Lustre filesystem +instance. If one or more \fBpath\fR entries are provided, then only the +Lustre instance for these mount points is returned. If the path given is not on +a Lustre instance 'No such device' is reported. +.TP .B osts -List all the OSTs for the filesystem +.RB [ path ] +List all the OSTs for all mounted filesystems. If a \fBpath\fR is provided +that is located on a lustre mounted file system then only the OSTs belonging +to that filesystem are displayed. .TP .B getstripe [--obd|-O ] [--quiet|-q] [--verbose|-v] - \fB[--count | -c ] [--size | -s ] [--index | -i ] - \fB[--offset | -o ] [--pool | -p ] [--directory | -d ] - \fB[--recursive|-r] \fR + \fB[--count | -c ] [--index | -i | --offset | -o ] + \fB[--pool | -p ] [--size | -s ] [--directory | -d ] + \fB[--recursive | -r ] [--raw | -R ] \fR .br -To list the striping information for a given filename or directory. By default the stripe count, size, and offset will be returned. If you only want specific striping information then the options of \fB--count\fR,\fB--size\fR,\fB--index\fR or \fB--offset\fR plus various combinations of these options can be used to retrieve only what you want. What pools a file belong to can also be obtained with \fB--pool\fR. In the case where you only want details about the files object id information then the \fB--quiet\fR option is used. Additional information available about striping can be displayed with \fB--verbose\fR. The default behavior of lfs getstripe used to retrieve data about a directory is to list all the contents of that directory. If you wish to inquire only about that directory then \fB--directory\fR,can be used to list directory entries instead of its contents in the same manner as ls -d. This can be expanded with \fB--recursive\fR which will recurse into all subdirectories. You can filter the search to return only files that has a object on a specific OST with \fB--obd\fR. -.TP -.B setstripe [--size stripe-size] [--count stripe-cnt] - \fB[--offset start-ost] [--pool ]\fR +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 +.BR --count , +.BR --size , +.BR --index , +.BR --offset , +or +.B --pool +can be used to return only the specific fields. +.br +If the +.B --raw +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. +In the case where you only want details about the files' object id +information then the +.B --quiet +option is used. Additional information available about striping can be +displayed with +.BR --verbose . +The default behavior when a directory is specified is to list the striping +information for all files within the specified directory (like +.RB ' "ls -l" ') . +This can be expanded with +.B --recursive +which will recurse into all subdirectories. +If you wish to get striping information for only the specified directory, then +.B --directory +can be used to limit the information, like +.RB ' "ls -d" '). +You can limit the returned files to those with objects on a specific OST with +.BR --obd . +.TP +.B setstripe [--count|-c stripe_cnt] [--size|-s stripe_size] + \fB[--index|-i|--offset|-o start_ost_index] [--pool ] + \fB\fR .br To create a new file, or set the directory default, with the specified striping parameters. The -.I stripe-count +.I stripe_count is the number of OSTs to stripe a file over. A -.I stripe-count +.I stripe_count of 0 means to use the filesystem-wide default stripe count (default 1), and a -.I stripe-count +.I stripe_count of -1 means to stripe over all available OSTs. The -.I stripe-size +.I stripe_size is the number of bytes to store on each OST before moving to the next OST. A -.I stripe-size +.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 +.I start_ost_index +is the OST index (starting at 0) on which to start striping for this file. A +.I 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 -.I pool +.I poolname is the name of a predefined pool of OSTs (see -.I lctl +.B lctl ) that will be used for striping. The -.I stripe-count, stripe-size, start-ost +.IR stripe_count , +.IR stripe_size , +and +.I start_ost_index will be used as well; the -.I start-ost +.I start_ost_index 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 [.] | -List the pools in \fBfilesystem\fR or \fBpathname\fR, or the OSTs in \fBfilesystem.pool\fR +.B poollist +.RI { filesystem }[ .poolname "] | {" pathname } +List the pools in +.I filesystem +or +.IR pathname , +or the OSTs in +.IR filesystem.pool . .TP .B quota [-q] [-v] [-o obd_uuid|-i mdt_idx|-I ost_idx] [-u|-g |||] 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).