mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
133 lines
4.8 KiB
Groff
133 lines
4.8 KiB
Groff
.TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvextend \(em extend the size of a logical volume
|
|
.SH SYNOPSIS
|
|
.B lvextend
|
|
.RB [ \-\-alloc
|
|
.IR AllocationPolicy ]
|
|
.RB [ \-A | \-\-autobackup
|
|
.RI { y | n }]
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.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)
|