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