Whamcloud - gitweb
LU-15115 ptlrpc: recalc timer on EINPROGRESS reply
[fs/lustre-release.git] / lustre / doc / lfs-mirror-split.1
index 34386f9..fb74f18 100644 (file)
@@ -3,8 +3,9 @@
 lfs mirror split \- split a specified mirror from an existing mirrored file
 .SH SYNOPSIS
 .B lfs mirror split
-{\fB\-\-mirror\-id\fR <\fImirror_id\fR> | \fB\-\-component\-id\fR|\fB\-I\fR
-<\fIcomp_id\fR> |\fB\-\-pool\fR <\fIpool\fR>}
+{\fB\-\-mirror\-id\fR <\fImirror_id\fR> | \fB\-\-component\-id\fR|\
+\fB\-\-comp\-id\fR|\fB\-I\fR
+<\fIcomp_id\fR> | \fB\-\-pool\fR <\fIpool\fR>}
 [\fB\-\-destroy\fR|\fB\-d\fR]
 [\fB\-f\fR <\fInew_file\fR>]
 <\fImirrored_file\fR>
@@ -14,7 +15,8 @@ a component with <\fIcomp_id\fR> or containing a component on <\fIpool\fR>
 out of a mirrored file specified by the path name \fImirrored_file\fR.
 By default, the layout of the split mirror will be stored into a new file named
 <\fImirrored_file\fR>.mirror~<\fImirror_id\fR>. If \fB\-\-destroy\fR|\fB\-d\fR
-option is specified, then the split mirror will be destroyed.
+option is specified, and the split mirror is not the last non-stale mirror,
+then it will be destroyed.
 If \fB\-f\fR <\fInew_file\fR> option is specified, then the layout of the split
 mirror will be stored into the named file.
 .br
@@ -55,6 +57,10 @@ Split a mirror with ID 2 out of /mnt/lustre/file1 and destroy it.
 Split a mirror with ID 3 out of /mnt/lustre/file1 and store it into
 /mnt/lustre/file2.
 .TP
+.B lfs mirror split --comp-id 65537 -d /mnt/lustre/file1
+Split a mirror containing the component with ID 65537 out of /mnt/lustre/file1
+and destroy it.
+.TP
 .B lfs mirror split --pool lustre-nvme -d /mnt/lustre/file1
 Split a mirror on pool lustre-nvme out of /mnt/lustre/file1 and destroy it.
 .SH AUTHOR
@@ -63,6 +69,7 @@ The \fBlfs mirror split\fR command is part of the Lustre filesystem.
 .BR lfs (1),
 .BR lfs-setstripe (1),
 .BR lfs-mirror-create (1),
+.BR lfs-mirror-delete (1),
 .BR lfs-mirror-extend (1),
 .BR lfs-mirror-resync (1),
 .BR lfs-mirror-verify (1)