mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
5bc2af2688
Allow the number of logical extents to be expressed (for a snapshot) as a percentage of the total space in the Origin Logical Volume with the suffix %ORIGIN. Update the relevant man pages accordingly. Eliminate inconsistencies between the man pages and tools/commands.h Signed-off-by: Mike Snitzer <snitzer@redhat.com>
83 lines
3.3 KiB
Groff
83 lines
3.3 KiB
Groff
.TH LVRESIZE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvresize \- resize a logical volume
|
|
.SH SYNOPSIS
|
|
.B lvresize
|
|
[\-\-alloc AllocationPolicy]
|
|
[\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help]
|
|
[\-\-noudevsync]
|
|
[\-i|\-\-stripes Stripes [\-I|\-\-stripesize StripeSize]]
|
|
{\-l|\-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}] |
|
|
\-L|\-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
|
|
[\-t|\-\-test]
|
|
[\-v|\-\-verbose] LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]
|
|
.SH DESCRIPTION
|
|
lvresize allows you to resize a logical volume.
|
|
Be careful when reducing a logical volume's size, because data in the reduced
|
|
part is lost!!!
|
|
You should therefore ensure that any filesystem on the volume is
|
|
shrunk first so that the extents that are to be removed are not in use.
|
|
Resizing snapshot logical volumes (see
|
|
.B lvcreate(8)
|
|
for information about creating snapshots) is supported as well.
|
|
But to change the number of copies in a mirrored logical
|
|
volume use
|
|
.BR lvconvert (8).
|
|
.SH OPTIONS
|
|
See \fBlvm\fP for common options.
|
|
.TP
|
|
.I \-\-noudevsync
|
|
Disable udev synchronisation. The
|
|
process will not wait for notification from udev.
|
|
It will continue irrespective of any possible udev processing
|
|
in the background. You should only use this if udev is not running
|
|
or has rules that ignore the devices LVM2 creates.
|
|
.TP
|
|
.I \-l, \-\-extents [+|-]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]
|
|
Change or set the logical volume size in units of logical extents.
|
|
With the + or - sign the value is added to or subtracted from the actual size
|
|
of the logical volume and without it, the value is taken as an absolute one.
|
|
The number can also be expressed as a percentage of the total space
|
|
in the Volume Group with the suffix %VG, relative to the existing
|
|
size of the Logical Volume with the suffix %LV, as a percentage of
|
|
the remaining free space of the PhysicalVolumes on the command line with the
|
|
suffix %PVS, as a percentage of the remaining free space in the
|
|
Volume Group with the suffix %FREE, or (for a snapshot) as a percentage
|
|
of the total space in the Origin Logical Volume with the suffix %ORIGIN.
|
|
.TP
|
|
.I \-L, \-\-size [+|-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
|
|
Change or set the logical volume size in units of megabytes.
|
|
A size suffix of M for megabytes,
|
|
G for gigabytes, T for terabytes, P for petabytes
|
|
or E for exabytes is optional.
|
|
With the + or - sign the value is added to or subtracted from
|
|
the actual size of the logical volume and without it, the value is taken as an
|
|
absolute one.
|
|
.TP
|
|
.I \-i, \-\-stripes Stripes
|
|
Gives the number of stripes to use when extending a Logical Volume.
|
|
Defaults to whatever the last segment of the Logical Volume uses.
|
|
Not applicable to LVs using the original metadata LVM format, which must
|
|
use a single value throughout.
|
|
.TP
|
|
.I \-I, \-\-stripesize StripeSize
|
|
Gives the number of kilobytes for the granularity of the stripes.
|
|
Defaults to whatever the last segment of the Logical Volume uses.
|
|
Not applicable to LVs using the original metadata LVM format, which
|
|
must use a single value throughout.
|
|
.br
|
|
StripeSize must be 2^n (n = 2 to 9)
|
|
.SH Examples
|
|
.br
|
|
"lvresize -L+16M vg1/lv1 /dev/sda:0-1 /dev/sdb:0-1"
|
|
.br
|
|
tries to extend a logical volume "vg1/lv1" by 16MB using physical extents
|
|
/dev/sda:0-1 and /dev/sdb:0-1 for allocation of extents.
|
|
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR lvconvert (8),
|
|
.BR lvcreate (8),
|
|
.BR lvreduce (8),
|
|
.BR lvchange (8)
|