LVM2/man lvconvert.8.in

LVM2/man lvconvert.8.in

[agk]

CVSROOT:	/cvs/lvm2
Module name:	LVM2
Changes by:	agk@sourceware.org	2011-08-19 17:36:13

Modified files:
	man            : lvconvert.8.in 

Log message:
	tweak split/track/merge
	How do you discover the value of N?

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvconvert.8.in.diff?cvsroot=lvm2&r1=1.21&r2=1.22

--- LVM2/man/lvconvert.8.in	2011/08/18 19:43:09	1.21
+++ LVM2/man/lvconvert.8.in	2011/08/19 17:36:13	1.22
@@ -125,12 +125,12 @@
 
 .TP
 .I \-\-trackchanges
-This argument is used along with \-\-splitmirrors when the intention
-is to use the split-off image temporarily in a read-only fashion.  Splitting
-off an image in this way allows it to be merged back into the mirror later
-- only resynchronizing those portions of the image that have changed since
-the split occurred.  This option is only available to the "raid1" segment
-type.
+Used with \-\-splitmirrors on a raid1 device, this tracks changes so that the
+read-only detached image can be merged efficiently back into the mirror later.
+Only the regions of the detatched device where the data changed get resynchronized.
+
+Please note that this feature is only supported with the new md-based mirror
+implementation and not with the original device-mapper mirror implementation.
 .br
 
 .TP
@@ -146,7 +146,7 @@
 If the volume is read-only the snapshot will not be zeroed.
 .TP
 .I \-\-merge
-Merges a snapshot into its origin volume or merges a RAID1 image that has
+Merges a snapshot into its origin volume or merges a raid1 image that has
 been split from its mirror with \-\-trackchanges back into its mirror.
 
 To check if your kernel supports the snapshot merge feature, look
@@ -164,7 +164,6 @@
 multiple snapshots be merged to their respective origin.
 .br
 
-
 .TP
 .I \-\-repair
 Repair a mirror after suffering a disk failure. The mirror will be brought back
@@ -238,20 +237,20 @@
 .br
 "lvconvert --splitmirrors 1 --trackchanges vg00/lv_raid1"
 .br
-A mirrored logical volume that uses the "raid1" segment type (i.e. created
-with '--type raid1') can use the '\-\-trackchanges' argument when splitting
-off an image.  The split-off image cannot be given a new name, as it is still
-part of the original RAID1 logical volume in the sense that changes between
-the two are being tracked for future integration upon merging.  The device that
-results from the split will be read-only and will be named similarly to the
-original - in this case "lv_raid1_rimage_N", where 'N' is the index of the
-image that has been split.
+A mirrored logical volume created with --type raid1 can use the '\-\-trackchanges' argument when splitting
+off an image.  
+
+Detach one image from the mirrored logical volume lv_raid1 as a separate
+read-only device and track the changes made to the mirror while it is detached.
+The split-off device has a name of the form lv_raid1_rimage_N, where N is
+a number, and it cannot be renamed.
 
 .br
 "lvconvert --merge vg00/lv_raid1_rimage_1"
 .br
-Merge an image back into the mirror it was split from when the '\-\-trackchanges'
-argument was used.
+Merge an image that was detached temporarily from its mirror with 
+the '\-\-trackchanges' argument back into its original mirror and
+bring its contents back up-to-date.
 
 .SH SEE ALSO
 .BR lvm (8),

LVM2/man lvconvert.8.in

[jbrassow]

CVSROOT:	/cvs/lvm2
Module name:	LVM2
Changes by:	jbrassow@sourceware.org	2011-01-04 21:41:36

Modified files:
	man            : lvconvert.8.in 

Log message:
	Fix bug 635949: lvconvert man page clarification

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvconvert.8.in.diff?cvsroot=lvm2&r1=1.18&r2=1.19

--- LVM2/man/lvconvert.8.in	2010/10/13 21:26:38	1.18
+++ LVM2/man/lvconvert.8.in	2011/01/04 21:41:35	1.19
@@ -51,9 +51,10 @@
 [\-\-version]
 LogicalVolume[Path] [PhysicalVolume[Path]...]
 .SH DESCRIPTION
-lvconvert will change a linear logical volume to a mirror
-logical volume or to a snapshot of linear volume and vice versa.
-It is also used to add and remove disk logs from mirror devices.
+lvconvert is used to change the segment type (i.e. linear, mirror, etc) or
+characteristics of a logical volume.  For example, it can add or remove the
+redundant images of a logical volume, change the log type of a mirror, or
+designate a logical volume as a snapshot repository.
 .br
 If the conversion requires allocation of physical extents (for
 example, when converting from linear to mirror) and you specify

LVM2/man lvconvert.8.in

[jbrassow]

CVSROOT:	/cvs/lvm2
Module name:	LVM2
Changes by:	jbrassow@sourceware.org	2010-04-13 16:13:08

Modified files:
	man            : lvconvert.8.in 

Log message:
	Arguments to the --mirrorlog option are described in the synopsis as
	{core|disk|mirrored}.  However, under the options section they are
	described as {core|disk} - even though the 'mirrored' argument is
	described.
	
	s/'{core|disk}'/'{core|disk|mirrored}'/

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvconvert.8.in.diff?cvsroot=lvm2&r1=1.16&r2=1.17

--- LVM2/man/lvconvert.8.in	2010/04/13 01:54:33	1.16
+++ LVM2/man/lvconvert.8.in	2010/04/13 16:13:08	1.17
@@ -76,7 +76,7 @@
 volume to a mirror volume with 2-sides; that is, a
 linear volume plus one copy.
 .TP
-.I \-\-mirrorlog {disk|core}
+.I \-\-mirrorlog {disk|core|mirrored}
 Specifies the type of log to use.
 The default is disk, which is persistent and requires
 a small amount of storage space, usually on a separate device

LVM2/man lvconvert.8.in

[snitzer]

CVSROOT:	/cvs/lvm2
Module name:	LVM2
Changes by:	snitzer@sourceware.org	2010-01-13 01:55:05

Modified files:
	man            : lvconvert.8.in 

Log message:
	Update lvconvert manpage for snapshot --merge

Patches:
http://sourceware.org/cgi-bin/cvsweb.cgi/LVM2/man/lvconvert.8.in.diff?cvsroot=lvm2&r1=1.12&r2=1.13

--- LVM2/man/lvconvert.8.in	2010/01/12 14:00:51	1.12
+++ LVM2/man/lvconvert.8.in	2010/01/13 01:55:05	1.13
@@ -31,7 +31,18 @@
 [\-\-version]
 .br
 OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
+.br
 
+.br
+.B lvconvert
+\-\-merge [\-b|\-\-background] [\-i|\-\-interval Seconds]
+[\-h|\-?|\-\-help]
+[\-v|\-\-verbose]
+[\-\-version]
+SnapshotLogicalVolume[Path]
+.br
+
+.br
 .B lvconvert
 \-\-repair
 [\-h|\-?|\-\-help]
@@ -54,7 +65,8 @@
 .SH OPTIONS
 See \fBlvm\fP for common options.
 .br
-Exactly one of \-\-splitmirrors, \-\-mirrors, \-\-repair or \-\-snapshot arguments required.
+Exactly one of \-\-splitmirrors, \-\-mirrors, \-\-repair, \-\-snapshot
+or \-\-merge arguments is required.
 .br
 .TP
 .I \-m, \-\-mirrors Mirrors
@@ -119,6 +131,17 @@
 .I \-Z, \-\-zero y|n
 Controls zeroing of the first KB of data in the snapshot.
 If the volume is read-only the snapshot will not be zeroed.
+.TP
+.I \-\-merge
+Merges a snapshot into its origin volume. If both the origin and snapshot volume
+are not open the merge will start immediately.  Otherwise, the merge will start
+the first time either the origin or snapshot are activated and both are closed.
+Merging a snapshot into an origin that cannot be closed, for example a root
+filesystem, is deferred until the next time the origin volume is activated.
+When merging starts, the resulting logical volume will have the origin's name,
+minor number and UUID.  While the merge is in progress, reads or writes to the
+origin appear as they were directed to the snapshot being merged.  When the
+merge finishes, the merged snapshot is removed.
 .br
 
 
@@ -171,6 +194,11 @@
 converts mirror logical volume "vg00/lvmirror1" to linear, freeing physical
 extents from /dev/sda.
 
+.br
+"lvconvert --merge vg00/lvol1_snap"
+.br
+merges "vg00/lvol1_snap" into its origin.
+
 .SH SEE ALSO
 .BR lvm (8),
 .BR vgcreate (8),