From: Jonathan Earl Brassow <jbrassow@redhat.com>
Date: Wed, 9 Feb 2011 22:24:55 +0000 (+0000)
Subject: bug 659264: more examples for pvmove
X-Git-Tag: v2_02_91~1107
X-Git-Url: https://sourceware.org/git/?a=commitdiff_plain;h=84d2039b7ff08ffb089c81b6366efffca4738aa1;p=lvm2.git

bug 659264: more examples for pvmove
---

diff --git a/man/pvmove.8.in b/man/pvmove.8.in
index 4e35ee50a..caf67051c 100644
--- a/man/pvmove.8.in
+++ b/man/pvmove.8.in
@@ -95,12 +95,37 @@ instead of all allocated extents to the destination physical volume(s).
 
 .SH EXAMPLES
 To move all logical extents of any logical volumes on
-.B /dev/hda4
-to free physical extents elsewhere in the volume group, giving verbose
-runtime information, use:
+.B /dev/sdb1
+to free physical extents elsewhere in the volume group, use:
 .sp
-\	pvmove -v /dev/hda4
+\	pvmove /dev/sdb1
+.P
+Additionally, the destination device can be specified.
 .sp
+\	pvmove /dev/sdb1 /dev/sdc1
+.P
+It is possible to perform the action on a single logical volume (instead of all
+the logical volumes that might be on the source device), like this:
+.sp
+\	pvmove -n lvol1 /dev/sdb1 /dev/sdc1
+.P
+Rather than moving the contents of the entire device, it is possible to
+move a range of extents.
+.sp
+\	pvmove /dev/sdb1:1000-1999
+.P
+It is possible to move the range of extents to a specific location (as long
+as the location has sufficent free extents) - even on the same device.
+.sp
+\	pvmove /dev/sdb1:1000-1999 /dev/sdc1
+.sp
+\	pvmove /dev/sdb1:1000-1999 /dev/sdb1:0-999
+.P
+A specific logical volume in a range of extents can also be picked out and
+moved.
+.sp
+\	pvmove -n lvol1 /dev/sdb1:1000-1999 /dev/sdc1
 .SH SEE ALSO
 .BR lvm (8),
 .BR vgconvert (8)
+.BR pvs (8)
\ No newline at end of file