lvextend(8)

1LVEXTEND(8)                 System Manager's Manual                LVEXTEND(8)
2
3
4

NAME

6       lvextend — extend the size of a logical volume
7

SYNOPSIS

9       lvextend [--alloc AllocationPolicy] [-A|--autobackup {y|n}] [--command‐
10       profile   ProfileName]   [-d|--debug]    [-h|-?|--help]    [-f|--force]
11       [-i|--stripes   Stripes   [-I|--stripesize  StripeSize]]  {-l|--extents
12       [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}] | -L|--size  [+]Logi‐
13       calVolumeSize[bBsSkKmMgGtTpPeE]}      [-n|--nofsck]      [--noudevsync]
14       [-r|--resizefs] [--use-policies] [-t|--test] [-v|--verbose] LogicalVol‐
15       umePath [PhysicalVolumePath[:PE[-PE]]...]
16

DESCRIPTION

18       lvextend  allows you to extend the size of a logical volume.  Extension
19       of snapshot logical volumes (see lvcreate(8) for information to  create
20       snapshots) is supported as well.  But to change the number of copies in
21       a mirrored logical volume use lvconvert(8).
22

OPTIONS

24       See lvm(8) for common options.
25
26       -f, --force
27              Proceed with size extension without prompting.
28
29       -l, --extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]
30              Extend or set the  logical  volume  size  in  units  of  logical
31              extents.   With  the  '+'  sign the value is added to the actual
32              size of the logical volume and without it, the value is taken as
33              an absolute one.  The total number of physical extents allocated
34              will be greater than this, for example, if the  volume  is  mir‐
35              rored.   The number can also be expressed as a percentage of the
36              total space in the Volume Group with the suffix %VG, relative to
37              the  existing size of the Logical Volume with the suffix %LV, of
38              the remaining free space  for  the  specified  PhysicalVolume(s)
39              with  the  suffix  %PVS,  as  a percentage of the remaining free
40              space in the Volume Group with the suffix %FREE, or (for a snap‐
41              shot)  as  a percentage of the total space in the Origin Logical
42              Volume with the suffix %ORIGIN.  The resulting value is  rounded
43              upward.   N.B. In a future release, when expressed as a percent‐
44              age with PVS, VG or FREE, the  number  will  be  treated  as  an
45              approximate upper limit for the total number of physical extents
46              to be allocated (including extents  used  by  any  mirrors,  for
47              example).   The  code may currently allocate more space than you
48              might otherwise expect.
49
50       -L, --size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
51              Extend or set the logical volume size in units of megabytes.   A
52              size  suffix  of  M  for  megabytes, G for gigabytes, T for ter‐
53              abytes, P for petabytes or E for exabytes is optional.  With the
54              + sign the value is added to the actual size of the logical vol‐
55              ume and without it, the value is taken as an absolute one.
56
57       -i, --stripes Stripes
58              Gives the number of stripes for the extension.   Not  applicable
59              to  LVs using the original metadata LVM format, which must use a
60              single value throughout.
61
62       -I, --stripesize StripeSize
63              Gives the  number  of  kilobytes  for  the  granularity  of  the
64              stripes.   Not applicable to LVs using the original metadata LVM
65              format, which must use a single value throughout.
66              StripeSize must be 2^n (n = 2 to 9)
67
68       -n, --nofsck
69              Do not perform fsck before extending filesystem when  filesystem
70              requires  it.  You  may need to use --force to proceed with this
71              option.
72
73       --noudevsync
74              Disable udev synchronisation. The  process  will  not  wait  for
75              notification  from  udev.   It will continue irrespective of any
76              possible udev processing in the background.  You should only use
77              this if udev is not running or has rules that ignore the devices
78              LVM2 creates.
79
80       -r, --resizefs
81              Resize underlying filesystem together with  the  logical  volume
82              using fsadm(8).
83
84       --use-policies
85              Resizes  the  logical volume according to configured policy. See
86              lvm.conf(5) for some details.
87
88

Examples

90       Extends the size of the logical volume "vg01/lvol10" by 54MiB on physi‐
91       cal volume /dev/sdk3. This is only possible if /dev/sdk3 is a member of
92       volume group vg01 and there are enough free physical extents in it:
93
94       lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3
95
96       Extends the size of logical volume "vg01/lvol01" by the amount of  free
97       space  on  physical  volume /dev/sdk3. This is equivalent to specifying
98       "-l +100%PVS" on the command line:
99
100       lvextend /dev/vg01/lvol01 /dev/sdk3
101
102       Extends a logical volume "vg01/lvol01" by 16MiB using physical  extents
103       /dev/sda:8-9 and /dev/sdb:8-9 for allocation of extents:
104
105       lvextend -L+16M vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9
106
107

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

Examples

SEE ALSO