X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flfs.1;h=6c1e5a38525410c8a4387d81f44ba2d828d71c75;hb=b046468f58a1f40e85cb59ed9abf75fd2fd5ea5a;hp=1d5d9fb821ec80cb75014465864c2e378ec3989d;hpb=9ef9c1dc0deb46eb8cc7cafa51e7a81fec16d900;p=fs%2Flustre-release.git diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1 index 1d5d9fb..6c1e5a3 100644 --- a/lustre/doc/lfs.1 +++ b/lustre/doc/lfs.1 @@ -32,19 +32,19 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the .B lfs getstripe [--obd|-O ] [--quiet|-q] [--verbose|-v] \fB[--stripe-count|-c ] [--stripe-index|-i] [--mdt-index|-M] \fB[--stripe-size|-S] [--directory|-d] - \fB[--layout|-L] + \fB[--layout|-L] \fB[--pool|-p] [--recursive|-r] [--raw|-R] ...\fR .br .B lfs setstripe [--stripe-size|-S stripe_size] [--stripe-count|-c stripe_count] - \fB[--stripe-index|-i start_ost_index ] [--pool|-p ] - \fB\fR + \fB[--stripe-index|-i start_ost_index] [--pool|-p ] + \fB[--ost-list|-o ] \fR .br .B lfs setstripe -d .br .B lfs osts .RB [ path ] .br -.B path2fid ... +.B lfs path2fid [--parents] ... .br .B lfs pool_list [.] | .br @@ -84,12 +84,14 @@ lfs \- Lustre utility to create a file with specific striping pattern, find the .br .B lfs data_version [-n] \fB\fR .br +.B lfs --version +.br .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. .SH OPTIONS -The various options supported by lctl are listed and explained below: +The various options supported by lfs are listed and explained below: .TP .B changelog Show the metadata changes on an MDT. Start and end points are optional. The --follow option will block on new changes; this option is only valid when run direclty on the MDT node. @@ -132,7 +134,7 @@ to that filesystem are displayed. .B getstripe [--obd|-O ] [--quiet|-q] [--verbose|-v] \fB[--count | -c ] [--index | -i | --offset | -o ] \fB[--pool | -p ] [--size | -s ] [--directory | -d ] - \fB[--layout | -L] + \fB[--layout | -L] \fB[--recursive | -r ] [--raw | -R ] \fR .br List the striping information for a given filename or directory tree. @@ -174,9 +176,10 @@ You can limit the returned files to those with objects on a specific OST with .TP .B setstripe [--stripe-count|-c stripe_count] [--stripe-size|-S stripe_size] \fB[--stripe-index|-i start_ost_index] [--pool ] - \fB\fR + \fB[--ost-index|-o ] \fR .br -To create a new file, or set the directory default, with the specified striping parameters. The +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 @@ -190,18 +193,48 @@ 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 -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 +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 +.B -o +option is used to specify the exact stripe layout on the file system. +.I ost_indices +is a list of OSTs referenced by their indices, which are specified in decimal +or hex form and can be obtained using the +.B lfs osts +command. The list format consists of individual OST indices and index ranges +separated by commas, e.g. 1,2-4,7. The +.B -o +option may be specified multiple times to stripe across the union of all listed +OSTs. If the +.B -c +option is combined with +.B -o +the +.I stripe_count +must agree with the number of OSTs in +.IR ost_indices . +If the +.B -i +option is combined with +.B -o +the +.I start_ost_index +must be in the OST list, and it will be used as the index on which to start +striping the file. Otherwise the striping will occur in the order specified in +.IR ost_indices . +The .I poolname -is the name of a predefined pool of OSTs (see -.B lctl -) that will be used for striping. The +is the name of a predefined pool of OSTs (see +.BR lctl (8)) +that will be used for striping. The .IR stripe_count , .IR stripe_size , and .I start_ost_index -will be used as well; the +will be used as well; the .I start_ost_index -must be part of the pool or an error will be returned. +must be part of the pool or an error will be returned. .TP .B setstripe -d Delete the default striping on the specified directory. @@ -214,9 +247,12 @@ hard links, then all of the pathnames for that file are printed, unless at 0, in no particular order). If multiple fids are specified, but only a single pathname is needed for each file, use \fB--link 0\fR. .TP -.B path2fid ... +.B path2fid [--parents] ... Print out the FIDs for the specified \fBpath(s)\fR. If multiple pathnames are given, then they will be printed one per line with the path as prefix. +The \fB--parents\fR switch makes it output the parent FID and name(s) of the +given entries. If an entry has multiple links, these are displayed on a single +line, tab-separated. .TP .B pool_list .RI { filesystem }[ .poolname "] | {" pathname } @@ -284,6 +320,9 @@ MDT0000. This is restricted to avoid creating directory trees that have intermediate path components on a series different MDTs and become unavailable if any of the intermediate MDTs are offline. .TP +.B --version +Output the build version of the lfs utility. Use "lctl lustre_build_version" to get the version of the Lustre kernel modules +.TP .B help Provides brief help on the various arguments .TP