Whamcloud - gitweb
LU-14789 tests: make sanity 133f and 133g working
[fs/lustre-release.git] / lustre / doc / lfs-setstripe.1
index 0ff3660..b9a144a 100644 (file)
@@ -133,7 +133,7 @@ file.
 Create a new
 .I file
 with a foreign/non-lustre layout of type
-.I foreign_type \fR(\fBnone\fR, \fBdaos\fR, ...)
+.I foreign_type \fR(\fBnone\fR, \fBsymlink\fR, ...)
 with flags
 .I hex
 and a free-format layout value of
@@ -163,7 +163,7 @@ means the file should use the filesystem-wide default stripe_size
 .BR G ibibytes.
 The
 .I stripe_size
-must be a multiple of 64KiB in size.
+must be a multiple of 64KiB.  Values below 4096 are assumed to be in KiB units.
 .TP
 .B -i\fR, \fB--stripe-index \fR<\fIstart_ost_index\fR>
 The OST index (starting at 0) on which to start striping for this file.  A
@@ -264,7 +264,7 @@ options).
 Current known types are
 .BR none
 and
-.BR daos
+.BR symlink
 , default is
 .BR none
 .
@@ -297,7 +297,10 @@ or
 means the following options extend to the end of the file.  The first
 component starts at offset 0, and each subsequent component starts at
 the end of the previous component, so they must be specified in increasing
-file offset order.
+file offset order, and must be a multiple of 64KiB to align with the
+minimum
+.I stripe_size
+value.  Values below 4096 are assumed to be in KiB units.
 .PP
 .RS
 The first component specified will inherit default parameters from the
@@ -387,8 +390,9 @@ to find uninitialized components.
 .B * prefer\fR - component preferred for read/write in a mirrored file
 .RE
 .RS
-.B * stale\fR - component has outdated data in a mirrored file.  Once a
-component is marked
+.B * stale\fR - component has outdated data in a mirrored file. This flag is
+not allowed to be set on a component of the last non-stale mirror.
+Once a component is marked
 .BR stale ,
 it isn't permitted to clear this flag directly. \fBlfs-mirror-resync\fR(1)
 is required to clear the flag.
@@ -488,7 +492,7 @@ writing beyond 192MiB, the first component is left as [0, 192MiB), and a new
 component is allocated between them, its layout repeats the first component
 layout but initialized on different OSTs so that the full OSTs are avoided.
 It is allocated and immediately extended to [192MiB, 256MiB), the following
-extension component is shortended again.
+extension component is shortened again.
 .RE
 .TP
 .B lfs setstripe -E 1G -z 64M -E 100G -z 256M -E -1 -z 1G /mnt/lustre/file1
@@ -532,12 +536,12 @@ which can be created with the
 .B lfs getstripe --yaml
 command.
 .TP
-.B lfs setstripe --foreign=daos --flags=0xda08 \
+.B lfs setstripe --foreign=symlink --flags=0xda08 \
        --xattr=PUUID:CUUID /mnt/lustre/file1
 This creates foreign
 .BR file1
 of type
-.BR daos
+.BR symlink
 with non-lustre/free-format
 .BR PUUID:CUUID
 layout/LOV EA and flags