LU-8465 tests: enable pfsck if possible

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

diff --git a/lustre/doc/lfs-mirror-resync.1 b/lustre/doc/lfs-mirror-resync.1
index 11eea0f..23d4849 100644 (file)
--- a/lustre/doc/lfs-mirror-resync.1
+++ b/lustre/doc/lfs-mirror-resync.1
@@ -4,26 +4,33 @@ lfs mirror resync \- resynchronize an out-of-sync mirrored file
 .SH SYNOPSIS
 .B lfs mirror resync
 [\fB\-\-only\fR <\fImirror_id\fR[,...]>]
 .SH SYNOPSIS
 .B lfs mirror resync
 [\fB\-\-only\fR <\fImirror_id\fR[,...]>]

-<\fImirrored_file\fR>
+<\fImirrored_file\fR> [<\fImirrored_file2\fR>...]

 .SH DESCRIPTION
 .SH DESCRIPTION

-This command resynchronizes an out-of-sync mirrored file specified by the path
+This command resynchronizes out-of-sync mirrored file(s) specified by the path

 name \fImirrored_file\fR.
 .br
 name \fImirrored_file\fR.
 .br

-If there is no stale mirror for the \fImirrored_file\fR, then the command does
+If there is no stale mirror for the \fImirrored_file(s)\fR, then the command does

 nothing. Otherwise, it will copy data from synced mirror to stale mirror(s), and
 mark all successfully copied mirror(s) as SYNC.
 nothing. Otherwise, it will copy data from synced mirror to stale mirror(s), and
 mark all successfully copied mirror(s) as SYNC.

+.br
+If \fB\-\-only\fR option is not specified, the \fBnosync\fR mirror(s) (i.e.
+components that have this flag set) will not be synced.
+.br

 If \fB\-\-only\fR <\fImirror_id\fR[,...]> option is specified, then the
 If \fB\-\-only\fR <\fImirror_id\fR[,...]> option is specified, then the

-command will resynchronize the mirror(s) specified by the \fImirror_id\fR(s).
+command will resynchronize the mirror(s) specified by the \fImirror_id\fR(s),
+even nosync mirror(s) will be resynchronized as well.
+This option cannot be used when multiple mirrored files are specified.

 .SH OPTIONS
 .TP
 .BR \-\-only\fR\ <\fImirror_id\fR[,...]>
 This option indicates which mirror(s) specified by \fImirror_id\fR(s) needs to
 be resynchronized. The \fImirror_id\fR is the numerical unique identifier for
 .SH OPTIONS
 .TP
 .BR \-\-only\fR\ <\fImirror_id\fR[,...]>
 This option indicates which mirror(s) specified by \fImirror_id\fR(s) needs to
 be resynchronized. The \fImirror_id\fR is the numerical unique identifier for

-a mirror. Multiple \fImirror_id\fRs are separated by comma.
+a mirror. Multiple \fImirror_id\fRs are separated by comma. This option cannot
+be used when multiple mirrored files are specified.

 .SH EXAMPLES
 .TP
 .SH EXAMPLES
 .TP

-.B lfs mirror resync /mnt/lustre/file1
-Resynchronize all of the stale mirror(s) for /mnt/lustre/file1.
+.B lfs mirror resync /mnt/lustre/file1 /mnt/lustre/file2
+Resynchronize all of the stale and sync-able mirror(s) for /mnt/lustre/file1 and /mnt/lustre/file2.

 .TP
 .B lfs mirror resync --only 4,5 /mnt/lustre/file1
 Resynchronize mirrors with mirror ID 4 and 5 for /mnt/lustre/file1 even if they
 .TP
 .B lfs mirror resync --only 4,5 /mnt/lustre/file1
 Resynchronize mirrors with mirror ID 4 and 5 for /mnt/lustre/file1 even if they