LVEXTEND

Section: Maintenance Commands (8)
Updated: LVM TOOLS
Index
Return to Main Contents

NAME

lvextend - extend the size of a logical volume

SYNOPSIS

lvextend [-A|--autobackup {y|n}] [-d|--debug] [-h|--help] {-l|--extents [+]LogicalExtentsNumber| -L|--size [+]LogicalVolumeSize[kKmMgGtT]} [-v|--verbose] LogicalVolumePath [PhysicalVolumePath...]

DESCRIPTION

lvextend allows you to extend the size of a logical volume. Extension of snapshot logical volumes (see lvcreate(8) for information to create snapshots) is supprted as well.

OPTIONS

-A, --autobackup y/n: Controls automatic backup of VG metadata after the change ( see vgcfgbackup(8) ). Default is yes.
-d, --debug: Enables additional debugging output (if compiled with DEBUG).
-h, --help: Print a usage message on standard output and exit successfully.
-l, --extents [+]LogicalExtentsNumber: Extend or set the logical volume size in units of logical extents. 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.
-L, --size [+]LogicalVolumeSize[kKmMgGtT]: Extend or set the logical volume size in units in units of megabytes. A size suffix of M for megabytes, G for gigabytes or T for terabytes 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.
-v, --verbose: Gives verbose runtime information about lvextend's activities.

Examples

"lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3" tries to extend the size of that logical volume by 54MB 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.

DIAGNOSTICS

lvextend returns an exit code of 0 for success or > 0 for error:


1  no logical volume name on command line
2  invalid physical volume name on command line
3  invalid logical volume name
4  error checking existence of logical volume
5  logical volume not active
6  error reading VGDA
7  requested physical volume not in this volume group
8  error getting index of logical volume
9  logical volume size not bigger than before
10 logical volume size exceeds volume group free capacity
11 logical volume size exceeds maximum
12 error setting up VGDA for logical volume extension
13 error extending VGDA for logical volume in kernel
14 error writing VGDA to physical volume(s)
15 error getting index for read/write statistics transfer
16 error getting status of logical volume from kernel
17 error setting up copy on write exception table

95 driver/module not in kernel
96 invalid I/O protocol version
97 error locking logical volume manager
98 invalid lvmtab (run vgscan(8))
99 invalid command line

ENVIRONMENT VARIABLES

LVM_AUTOBACKUP: If this variable is set to "no" then the automatic backup of VG metadata is turned off.
LVM_VG_MAX_BACKUPS: This variable determines the backup history depth of kept VGDA copy files in /etc/lvmconf. It can be set to a positive number between 0 and 999. The higher this number is, the more changes you can restore using vgcfgrestore(8).
LVM_VG_NAME: The default Volume Group Name to use. Setting this variable enables you to enter just the Logical Volume Name rather than its complete path.

AUTHOR

Heinz Mauelshagen <Linux-LVM@Sistina.com>

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

Examples

DIAGNOSTICS

ENVIRONMENT VARIABLES

See also

AUTHOR

This document was created by man2html, using the manual pages.
Time: 08:57:38 GMT, April 20, 2024