X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flfs.1;h=4e093e736d8fb3b63bc7ff291fc44317aac0c1bc;hb=10a847d2511254d7cab0accbca03524d5c1fd909;hp=5415367134a065424583f7e0fc3b63664078cef4;hpb=93339415b8d74c0a2c74ee053aed23540b89bccb;p=fs%2Flustre-release.git diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1 index 5415367..4e093e7 100644 --- a/lustre/doc/lfs.1 +++ b/lustre/doc/lfs.1 @@ -13,28 +13,33 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the .br .B lfs df [-i] [-h] [--pool|-p [.] [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 ] - \fB[[!] --size|-S [-+]N[kMGTPE]] [--type |-t {bcdflpsD}] - \fB[[!] --gid|-g|--group|-G |] - \fB[[!] --uid|-u|--user|-U |] - \fB\fR +.B lfs find + \fB[[!] --atime|-A [-+]N] [[!] --mtime|-M [-+]N] [[!] --ctime|-C [+-]N] + \fB[--maxdepth|-D N] [[!] --mdt|-m ] [--name|-n pattern] + \fB[[!] --ost|-O ] [--print|-p] [--print0|-P] + \fB[[!] --size|-s [-+]N[kMGTPE]] + \fB[[!] --stripe-count|-c [+-]] + \fB[[!] --stripe-index|-i ] + \fB[[!] --stripe-size|-S [+-]N[kMG]] + \fB[--type |-t {bcdflpsD}] [[!] --gid|-g|--group|-G |] + \fB[[!] --uid|-u|--user|-U |] [[!] --pool ]\fR .br -.B lfs osts -.RB [ path ] +.B lfs getname [-h]|[path ...] .br .B lfs getstripe [--obd|-O ] [--quiet|-q] [--verbose|-v] - \fB[--count | -c ] [--index | -i | --offset | -o ] - \fB[--size | -s ] [--pool | -p ] [--directory | -d ] - \fB[--recursive | -r] [--raw|-R] ...\fR + \fB[--stripe-count|-c ] [--stripe-index|-i] [--mdt-index|-M] + \fB[--stripe-size|-S] [--directory|-d] + \fB[--pool|-p] [--recursive|-r] [--raw|-R] ...\fR .br -.B lfs setstripe [--size|-s stripe-size] [--count|-c stripe-cnt] - \fB[--index|-i|--offset|-o start_ost_index ] [--pool|-p ] +.B lfs setstripe [--stripe-size|-S stripe_size] [--stripe-count|-c stripe_count] + \fB[--stripe-index|-i 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 ] @@ -72,6 +77,8 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the \fB[-b ] [-i ] \fB\fR .br +.B lfs data_version [-n] \fB\fR +.br .B lfs help .SH DESCRIPTION .B lfs @@ -102,6 +109,12 @@ 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 .RB [ path ] List all the OSTs for all mounted filesystems. If a \fBpath\fR is provided @@ -149,8 +162,8 @@ can be used to limit the information, like 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 ] +.B setstripe [--stripe-count|-c stripe_count] [--stripe-size|-S stripe_size] + \fB[--stripe-index|-i start_ost_index] [--pool ] \fB\fR .br To create a new file, or set the directory default, with the specified striping parameters. The @@ -163,7 +176,7 @@ 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 +of 0 means to use the filesystem-wide default stripe_size (default 1MB). The .I start_ost_index is the OST index (starting at 0) on which to start striping for this file. A .I start_ost_index @@ -219,6 +232,16 @@ To set filesystem quotas for users or groups. Limits can be specified with -b, - .B setquota -t [-u|-g] [--block-grace ] [--inode-grace ] 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 data_version [-n] +Display current version of file data. If -n is specified, data version is read +without taking lock. As a consequence, data version could be outdated if there +is dirty caches on filesystem clients, but this will not force data flushes and +has less impact on filesystem. + +Even without -n, race conditions are possible and data version should be +checked before and after an operation to be confident the data did not change +during it. +.TP .B help Provides brief help on the various arguments .TP