From: Dave Wysochanski <dwysocha@redhat.com>
Date: Wed, 9 Apr 2008 14:39:55 +0000 (+0000)
Subject: Update vgsplit man page to reflect lvnames on cmdline.
X-Git-Tag: dm_v1_02_25~11
X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=a42905efa6469a7bf04e7a2134f945cf334c9555;p=lvm2.git

Update vgsplit man page to reflect lvnames on cmdline.
---

diff --git a/WHATS_NEW b/WHATS_NEW
index 6545137ae..d0dad13a8 100644
--- a/WHATS_NEW
+++ b/WHATS_NEW
@@ -1,6 +1,7 @@
 Version 2.02.34 -
 ===================================
-  Update vgsplit to take "-n LogicalVolumeName" on the commandline.
+  Update vgsplit man page to reflect lvnames on the cmdline.
+  Update vgsplit to take "-n LogicalVolumeName" on the cmdline.
   Use clustered mirror log with pvmove in clustered VGs, if available.
   Fix some pvmove error status codes.
   Fix vgsplit error paths to release vg_to lock.
diff --git a/man/vgsplit.8 b/man/vgsplit.8
index 8614c7328..36e230caa 100644
--- a/man/vgsplit.8
+++ b/man/vgsplit.8
@@ -15,18 +15,21 @@ vgsplit \- split a volume group into two
 .IR type ]
 .RB [ -p | \-\-maxphysicalvolumes
 .IR MaxPhysicalVolumes ]
+.RB [ \-n | \-\-name 
+.IR LogicalVolumeName ]
 .RB [ \-t | \-\-test ]
 .RB [ \-v | \-\-verbose ]
 SourceVolumeGroupName DestinationVolumeGroupName
-PhysicalVolumePath [PhysicalVolumePath...]
+[ PhysicalVolumePath ...]
 .SH DESCRIPTION
 .B vgsplit 
-moves
-.IR PhysicalVolumePath (s)
-from
+moves one or more physical volumes from
 .I SourceVolumeGroupName
 into
-.I DestinationVolumeGroupName\fP.
+.I DestinationVolumeGroupName\fP.  The physical volumes moved can be
+specified either explicitly via \fIPhysicalVolumePath\fP, or implicitly by
+\fB-n\fP \fILogicalVolumeName\fP, in which case only physical volumes
+underlying the specified logical volume will be moved.
 
 If
 .I DestinationVolumeGroupName
@@ -46,9 +49,13 @@ before the physical volumes are moved. Specifying any of the above default
 volume group attributes with an existing destination volume group is an error,
 and no split will occur.
 
-Logical Volumes cannot be split between Volume Groups.
-Each existing Logical Volume must be entirely on the Physical Volumes forming
-either the source or the destination Volume Group.
+Logical volumes cannot be split between volume groups. \fBVgsplit(8)\fP only
+moves complete physical volumes: To move part of a physical volume, use
+\fBpvmove(8)\fP.  Each existing logical volume must be entirely on the physical
+volumes forming either the source or the destination volume group.  For this
+reason, \fBvgsplit(8)\fP may fail with an error if a split would result in a
+logical volume being split across volume groups.
+
 .SH OPTIONS
 See \fBlvm\fP for common options.
 .SH SEE ALSO