Branch HEAD

Add "setstripe" parameter descriptions to lfs man page
b=15754

diff --git a/lustre/doc/lfs.1 b/lustre/doc/lfs.1
index bb9a30c..c8ba802 100644 (file)
--- a/lustre/doc/lfs.1
+++ b/lustre/doc/lfs.1
@@ -63,8 +63,27 @@ To list the striping info for a given filename or files in a directory, optional
 .B osts 
 List all the OSTs for the filesystem
 .TP
-.B setstripe 
-To create a new file with a specific striping pattern
+.B setstripe [--size stripe-size] [--count stripe-cnt] [--index start-ost]
+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 (starting at 0) on which to start striping for this file.  A
+.I start-ost
+of -1 allows the MDS to specify the starting index and it is strongly
+recommended that the starting OST not be given, as this allows space and
+load balancing to be done by the MDS as needed.
+.TP
+.B lfs setstripe -d
+Delete the default striping on the specified directory.
 .TP
 .B quotachown
 To change files' owner and group on OSTs of the specified filesystem