LU-10561 flr: remove "--parent" option from lfs mirror command

[fs/lustre-release.git] / lustre / doc / lfs-mirror-create.1

diff --git a/lustre/doc/lfs-mirror-create.1 b/lustre/doc/lfs-mirror-create.1
index 2943851..28092fa 100644 (file)
--- a/lustre/doc/lfs-mirror-create.1
+++ b/lustre/doc/lfs-mirror-create.1
@@ -4,7 +4,7 @@ lfs mirror create \- create a mirrored file or directory
 .SH SYNOPSIS
 .B lfs mirror create
 <\fB\-\-mirror\-count\fR|\fB\-N\fR[\fImirror_count\fR]>
-[\fIsetstripe_options\fR|\fB--parent\fR|[\fB--flags\fR<=\fIflags\fR>]] ...
+[\fIsetstripe_options\fR|[\fB--flags\fR<=\fIflags\fR>]] ...
 .RI < filename | directory >
 .SH DESCRIPTION
 This command creates a mirrored file or directory specified by the path name
@@ -21,10 +21,9 @@ be a plain layout with specific striping pattern or a composite layout like
 Progressive File Layout (PFL) (see \fBlfs-setstripe\fR(1)).
 If \fIsetstripe_options\fR are not specified,
 then the stripe options inherited from the previous component will be used. If
-there is no previous component or \fB\-\-parent\fR option is specified, then the
-default stripe options inherited from parent directory will be used. For stripe
-options, only \fIstripe_count\fR, \fIstripe_size\fR and OST \fIpool_name\fR can
-be inherited.
+there is no previous component, then the \fIstripe_count\fR and
+\fIstripe_size\fR options inherited from filesystem-wide default values will be
+used, and OST \fIpool_name\fR inherited from parent directory will be used.
 .br
 If no option is specified, then the command will return an error.
 .SH OPTIONS
@@ -41,10 +40,6 @@ The layout of one mirror. The options are the same as those for
 If \fIsetstripe_options\fR are not specified, then
 the stripe options inherited from the previous component will be used.
 .TP
-.B \-\-parent
-This option indicates that the default stripe options inherited from parent
-directory will be used.
-.TP
 .B --flags<=\fIflags\fR>
 Where available \fIflags\fR are as follows:
 .RS
@@ -69,7 +64,9 @@ set to individual components at mirror creation time.
 .TP
 .B lfs mirror create -N2 /mnt/lustre/file1
 Create a mirrored file with 2 mirrors. Each mirror has the same default striping
-pattern inherited from parent directory or filesystem-wide default.
+pattern with \fIstripe_count\fR and \fIstripe_size\fR inherited from
+filesystem-wide default values, and OST \fIpool_name\fR inherited from
+parent directory.
 .TP
 .B lfs mirror create -N2 -E 1M -E eof -c -1 /mnt/lustre/dir1
 Create a mirrored directory with 2 PFL mirrors. Each mirror has the same
@@ -80,13 +77,16 @@ specified PFL layout.
 .in
 Create a mirrored file with 3 PFL mirrors. Each mirror has the same specified
 PFL layout.
-.TP
-.B lfs mirror create -N -c 1 -S 4M -N -c 2 -o 2,3 -N --parent /mnt/lustre/file1
+.LP
+.B lfs mirror create -N -c 1 -S 4M -N -c 2 -o 2,3 -p flash
+.B -N -p none /mnt/lustre/file1
+.in
 Create a mirrored file with 3 plain layout mirrors. The first mirror has a
 single stripe and 4MB stripe size. The second mirror has two stripes and locates
-on OSTs with indices 2 and 3. It also has 4MB stripe size inherited from the
-first mirror. The third mirror has default striping pattern inherited from
-parent directory.
+on OSTs with indices 2 and 3 allocated from the \fBflash\fR OST pool.
+It also has 4MB stripe size inherited from the first mirror.
+The third mirror has two stripes and 4MB stripe size inherited from the previous
+mirror, and also has inherited OST \fIpool_name\fR from parent directory.
 .LP
 .B lfs mirror create -N2 -E 4M -c 2 --pool flash --flags prefer -E eof -c 4
 .B -N3 -E 16M -c 4 -S 16M --pool archive --comp-flags=prefer -E eof -c -1