lustre/doc/lfs-mirror-copy.1

   1 .TH LFS-MIRROR-COPY 1 2018-09-23 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs mirror copy \- copy a mirror's content to other mirror(s) of a mirrored file
   4 .SH SYNOPSIS
   5 .B lfs mirror copy
   6 {\fB\-\-read-mirror|\-i\fR <\fIid0\fR>}
   7 {\fB\-\-write-mirror|\-o\fR <\fIid1>[,<id2>,...]\fR}
   8 <\fImirrored_file\fR>
   9 .SH DESCRIPTION
  10 This command copies a mirror's content to other mirror(s) of a mirrored file,
  11 the file is specified by the path name \fImirrored_file\fR, the mirrors are
  12 specified by their mirror ID.
  13 .SH NOTE
  14 Be ware that the written mirror(s) will be marked as non-stale mirror(s),
  15 be careful that after using this command, you could get a file with non-stale
  16 mirrors while containing different contents.
  17 .br
  18 .SH OPTIONS
  19 .TP
  20 .BR \-\-read-mirror|\-i\fR\ <\fIid0\fR>
  21 This option indicates the content of which mirror specified by \fIid0\fR
  22 needs to be read. The \fIid0\fR is the numerical unique identifier for
  23 a mirror.
  24 .TP
  25 .BR \-\-write-mirror|\-o\fR\ <\fIid1\fR>[,<\fIid2\fR>,...]
  26 This option indicates the content of which mirror(s) specified by mirror IDs
  27 needs to be written. The mirror IDs are separated with comma.
  28 If the mirror id \fB-1\fR is used here, it means that all mirrors other than
  29 the read mirror are to be written.
  30 .SH EXAMPLES
  31 .TP
  32 .B lfs mirror copy -i1 -o2,3 /mnt/lustre/file1
  33 Copy the content of mirror with mirror ID 1 to the mirrors with mirror ID 2 and
  34 mirror ID 3 in /mnt/lustre/file1.
  35 .TP
  36 .B lfs mirror copy -i1 -o-1 /mnt/lustre/file1
  37 Copy the content of mirror with mirror ID 1 to all other mirrors in /mnt/lustre/file1.
  38 .TP
  39 .SH AUTHOR
  40 The \fBlfs mirror copy\fR command is part of the Lustre filesystem.
  41 .SH SEE ALSO
  42 .BR lfs (1),
  43 .BR lfs-setstripe (1),
  44 .BR lfs-getstripe (1),
  45 .BR lfs-mirror-create (1),
  46 .BR lfs-mirror-extend (1),
  47 .BR lfs-mirror-split (1),
  48 .BR lfs-mirror-verify (1),
  49 .BR lfs-mirror-read (1)
  50 .BR lfs-mirror-write (1)