mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
b359b86f88
Start to convert percentage size handling in lvresize to the new standard. Note in the man pages that this code is incomplete. Fix a regression in non-percentage allocation in my last check in. This is what I am aiming for: -l<extents> -l<percent> LV/ORIGIN sets or changes the LV size based on the specified quantity of logical logical extents (that might be backed by a higher number of physical extents) -l<percent> PVS/VG/FREE sets or changes the LV size so as to allocate or free the desired quantity of physical extents (that might amount to a lower number of logical extents for the LV concerned) -l+50%FREE - Use up half the remaining free space in the VG when carrying out this operation. -l50%VG - After this operation, this LV should be using up half the space in the VG. -l200%LV - Double the logical size of this LV. -l+100%LV - Double the logical size of this LV. -l-50%LV - Reduce the logical size of this LV by half.
131 lines
4.7 KiB
Groff
131 lines
4.7 KiB
Groff
.TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvextend \- extend the size of a logical volume
|
|
.SH SYNOPSIS
|
|
.B lvextend
|
|
.RB [ \-\-alloc
|
|
.IR AllocationPolicy ]
|
|
.RB [ \-A | \-\-autobackup
|
|
.RI { y | n }]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-? | \-\-help ]
|
|
.RB [ \-f | \-\-force ]
|
|
.RB [ \-i | \-\-stripes
|
|
.I Stripes
|
|
.RB [ \-I | \-\-stripesize
|
|
.IR StripeSize ]]
|
|
.RB { \-l | \-\-extents
|
|
.RI [ + ] LogicalExtentsNumber [ % { VG | LV | PVS | FREE | ORIGIN }]
|
|
|
|
|
.BR \-L | \-\-size
|
|
.RI [ + ] LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
|
|
.RB [ \-n | \-\-nofsck ]
|
|
.RB [ \-\-noudevsync]
|
|
.RB [ \-r | \-\-resizefs ]
|
|
.RB [ \-\-use\-policies ]
|
|
.RB [ \-t | \-\-test ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.I LogicalVolumePath
|
|
.RI [ PhysicalVolumePath [ :PE [ -PE ]]...]
|
|
.SH DESCRIPTION
|
|
lvextend allows you to extend the size of a logical volume.
|
|
Extension of snapshot logical volumes (see
|
|
.BR lvcreate (8)
|
|
for information to create 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(8) for common options.
|
|
.TP
|
|
.BR \-f ", " \-\-force
|
|
Proceed with size extension without prompting.
|
|
.TP
|
|
.IR \fB\-l ", " \fB\-\-extents " [" + ] LogicalExtentsNumber [ % { VG | LV | PVS | FREE | ORIGIN }]
|
|
Extend or set the logical volume size in units of logical extents.
|
|
With the '\fI+\fP' sign the value is added to the actual size
|
|
of the logical volume and without it, the value is taken as an absolute one.
|
|
The total number of physical extents allocated will be
|
|
greater than this, for example, if the volume is mirrored.
|
|
The number can also be expressed as a percentage of the total space
|
|
in the Volume Group with the suffix \fI%VG\fP, relative to the existing
|
|
size of the Logical Volume with the suffix \fI%LV\fP, of the remaining
|
|
free space for the specified PhysicalVolume(s) with the suffix \fI%PVS\fP,
|
|
as a percentage of the remaining free space in the Volume Group
|
|
with the suffix \fI%FREE\fP, or (for a snapshot) as a percentage of the total
|
|
space in the Origin Logical Volume with the suffix \fI%ORIGIN\fP.
|
|
The resulting value is rounded upward.
|
|
N.B. In a future release, when expressed as a percentage with PVS, VG or FREE,
|
|
the number will be treated as an approximate upper limit for the total number
|
|
of physical extents to be allocated (including extents used by any mirrors, for
|
|
example). The code may currently allocate more space than you might otherwise
|
|
expect.
|
|
.TP
|
|
.IR \fB\-L ", " \fB\-\-size " [" + ] LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]
|
|
Extend 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 + sign the value is added to the actual size
|
|
of the logical volume and without it, the value is taken as an absolute one.
|
|
.TP
|
|
.BR \-i ", " \-\-stripes " " \fIStripes
|
|
Gives the number of stripes for the extension.
|
|
Not applicable to LVs using the original metadata LVM format, which must
|
|
use a single value throughout.
|
|
.TP
|
|
.BR \-I ", " \-\-stripesize " " \fIStripeSize
|
|
Gives the number of kilobytes for the granularity of the stripes.
|
|
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)
|
|
.TP
|
|
.BR \-n ", " \-\-nofsck
|
|
Do not perform fsck before extending filesystem when filesystem
|
|
requires it. You may need to use \fB\-\-force\fR to proceed with
|
|
this option.
|
|
.TP
|
|
.B \-\-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
|
|
.BR \-r ", " \-\-resizefs
|
|
Resize underlying filesystem together with the logical volume using
|
|
\fBfsadm\fR(8).
|
|
.TP
|
|
.B \-\-use\-policies
|
|
Resizes the logical volume according to configured policy. See
|
|
\fBlvm.conf\fR(5) for some details.
|
|
|
|
.SH Examples
|
|
Extends the size of the logical volume "vg01/lvol10" by 54MiB on physical
|
|
volume /dev/sdk3. This is only possible if /dev/sdk3 is a member of
|
|
volume group vg01 and there are enough free physical extents in it:
|
|
.sp
|
|
.B lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3
|
|
|
|
Extends the size of logical volume "vg01/lvol01" by the amount of free
|
|
space on physical volume /dev/sdk3. This is equivalent to specifying
|
|
"-l +100%PVS" on the command line:
|
|
.sp
|
|
.B lvextend /dev/vg01/lvol01 /dev/sdk3
|
|
|
|
Extends a logical volume "vg01/lvol01" by 16MiB using physical extents
|
|
/dev/sda:8-9 and /dev/sdb:8-9 for allocation of extents:
|
|
.sp
|
|
.B lvextend -L+16M vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9
|
|
|
|
.SH SEE ALSO
|
|
.BR fsadm (8),
|
|
.BR lvm (8),
|
|
.BR lvm.conf (5),
|
|
.BR lvcreate (8),
|
|
.BR lvconvert (8),
|
|
.BR lvreduce (8),
|
|
.BR lvresize (8),
|
|
.BR lvchange (8)
|