Back to main site | Back to man page index

LVEXTEND(8)                                    System Manager's Manual                                    LVEXTEND(8)



NAME
       lvextend — extend the size of a logical volume

SYNOPSIS
       lvextend  [--alloc  AllocationPolicy]  [-A|--autobackup  {y|n}]  [--commandprofile  ProfileName]  [-d|--debug]
       [-h|-?|--help] [-f|--force] [-i|--stripes Stripes [-I|--stripesize  StripeSize]]  {-l|--extents  [+]LogicalEx‐
       tentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]   |   -L|--size   [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}  [-n|--nofsck]
       [--noudevsync] [-r|--resizefs] [--reportformat {basic|json}] [--use-policies] [-t|--test] [-v|--verbose] Logi‐
       calVolumePath [PhysicalVolumePath[:PE[-PE]]...]

DESCRIPTION
       lvextend allows you to extend the size of a logical volume.  Extension of snapshot logical volumes (see lvcre‐
       ate(8) for information to create snapshots) is supported as well.  But to change the number  of  copies  in  a
       mirrored logical volume use lvconvert(8).

OPTIONS
       See lvm(8) for common options.

       -f, --force
              Proceed with size extension without prompting.

       -l, --extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]
              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.
              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 %VG, relative to the existing size of the Logical Volume with the suffix %LV, of the remain‐
              ing free space for the specified PhysicalVolume(s) with the suffix %PVS, as a percentage of the remain‐
              ing  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.   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.

       -L, --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.

       -i, --stripes Stripes
              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.

       -I, --stripesize StripeSize
              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.
              StripeSize must be 2^n (n = 2 to 9)

       -n, --nofsck
              Do  not  perform  fsck  before  extending  filesystem  when filesystem requires it. You may need to use
              --force to proceed with this option.

       --noudevsync
              Disable udev synchronisation. The process will not wait for notification from udev.  It  will  continue

       sible if /dev/sdk3 is a member of volume group vg01 and there are enough free physical extents in it:

       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:

       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 allo‐
       cation of extents:

       lvextend -L+16M vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9


SEE ALSO
       fsadm(8), lvm(8), lvm.conf(5), lvcreate(8), lvconvert(8), lvreduce(8), lvresize(8), lvchange(8)



Sistina Software UK                    LVM TOOLS 2.02.166(2)-RHEL7 (2016-11-16)                           LVEXTEND(8)