diff --git a/man/lvconvert.8.in b/man/lvconvert.8.in index 747bb7db6..e85fe962e 100644 --- a/man/lvconvert.8.in +++ b/man/lvconvert.8.in @@ -89,7 +89,7 @@ avoid the direct use of hidden LVs. VG/StripedLV .br \[bu] -Merge StripedLV into an LV when it is a previously split mirror +Merge StripedLV into an LV when it is a previously split mirror. .br \[bu] See --splitmirror. @@ -167,7 +167,7 @@ Number VG/RaidLV .br \[bu] -Change the number of images in a raid1 RaidLV. +Change the number of images in raid1 RaidLV. .B lvconvert \-\-splitmirrors Number @@ -197,9 +197,6 @@ Replace failed PVs in RaidLV. .B lvconvert \-\-replace PV -.B [\-\-replace -PV -.B ...] VG/RaidLV .br \[bu] @@ -207,6 +204,9 @@ Replace specific PV(s) in a raid* LV with another PV. .br \[bu] The replacement PV can be optionally specified, see below. +.br +\[bu] +Repeat to replace multiple: \-\-replace PV1 \-\-replace PV2 ... .B lvconvert \-\-type snapshot VG/RaidLV @@ -333,6 +333,9 @@ VG/CachePoolLV .br \[bu] Split the cache LV from CachePoolLV. +.br +\[bu] +Equivalent to --splitcache on CacheLV. .SS Operations on CacheLV with type cache: @@ -587,8 +590,8 @@ This option is required when converting an LV to a \fBraid1\fP or This option can be used alone to change the number of mirror images in an existing \fBraid1\fP or \fBmirror\fP LV. -The special case \fB\-\-mirrors 0\fP indicates a linear LV with no mirror -images. +The special case \fB\-\-mirrors 0\fP has been used historically to +indicate a linear LV with no mirror images. . .HP .BR \-n , @@ -709,17 +712,12 @@ still available in "_meta" LV. .BR \-\-replace .IR PhysicalVolume .br -Remove the specified device (\fIPhysicalVolume\fP) and replace it with one +Remove the specified device \fIPhysicalVolume\fP and replace it with one that is available in the VG, or from a specific list of PVs specified on the command line following the LV name. This option may be repeated multiple -times depending on the RaidLV type. Maxima for raid1 are N-1 mirrors, -for raid4/5 1 stripe, for raid6 2 stripes and for raid10 it is the number -of stripes, i.e. one mirror in each mirror group. It is recommended to keep -resilience whilst replacing PVs whenever possible, i.e. only replace a maximum -of N-2 mirrors in a raid1 LV and 1 stripe in a raid6 LV at a time; -this is not possible with raid4/5/10 LVs, because any single replaced PV -will render the RaidLV non-resilient against another PV failure during replacement. -.br +times depending on the RaidLV type. See +.BR lvmraid (7) +for specific limits on device replacement for each raid level. (This option only applies to \fBraid*\fP LV types.) . .HP @@ -766,7 +764,7 @@ Also see .IR Number .br Specifies the number of stripes in a striped LV. This is the number of -physical volumes (devices) across which to spread a striped LV. Data that +physical volumes (devices) a striped LV is spread across. Data that appears sequential in the LV is spread (striped) across multiple devices in units of the stripe size (see below). This does not apply to existing allocated space, only newly allocated space can be striped.