Initial import of binutils 2.22 on the new vendor branch
[dragonfly.git] / contrib / lvm2 / dist / man / pvresize.8.in
1 .TH PVRESIZE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2 .SH NAME
3 pvresize \- resize a disk or partition in use by LVM2
4 .SH SYNOPSIS
5 .B pvresize
6 .RB [ \-d | \-\-debug ]
7 .RB [ \-h | \-\-help ]
8 .RB [ \-t | \-\-test ]
9 .RB [ \-v | \-\-verbose ]
10 .RB [ \-\-setphysicalvolumesize size ]
11 .IR PhysicalVolume " [" PhysicalVolume ...]
12 .SH DESCRIPTION
13 .B pvresize
14 resizes
15 .I PhysicalVolume
16 which may already be in a volume group and have active logical volumes
17 allocated on it.
18 .SH OPTIONS
19 See \fBlvm\fP(8) for common options.
20 .TP
21 .BR \-\-setphysicalvolumesize " size"
22 Overrides the automatically-detected size of the PV.  Use with care, or
23 prior to reducing the physical size of the device.
24 .SH EXAMPLES
25 Expand the PV on /dev/sda1 after enlarging the partition with fdisk:
26 .sp
27 .B pvresize /dev/sda1
28 .sp
29 Shrink the PV on /dev/sda1 prior to shrinking the partition with fdisk
30 (ensure that the PV size is appropriate for your intended new partition
31 size):
32 .sp
33 .B pvresize --setphysicalvolumesize 40G /dev/sda1
34 .sp
35 .SH RESTRICTIONS
36 .B pvresize
37 will refuse to shrink
38 .I PhysicalVolume
39 if it has allocated extents after where its new end would be. In the future,
40 it should relocate these elsewhere in the volume group if there is sufficient
41 free space, like
42 .B pvmove
43 does.
44 .sp
45 .B pvresize
46 won't currently work correctly on LVM1 volumes or PVs with extra
47 metadata areas.
48 .SH SEE ALSO
49 .BR lvm "(8), " pvmove "(8), " lvresize "(8), " fdisk "(8)"