Provided by: lvm2_2.02.133-1ubuntu10_amd64 bug

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
       [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]      |      -L|--size
       [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}   [-n|--nofsck]  [--noudevsync]
       [-r|--resizefs]     [--use-policies]     [-t|--test]     [-v|--verbose]
       LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]

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 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  remaining  free  space  for  the  specified
              PhysicalVolume(s)  with  the suffix %PVS, as a percentage of the
              remaining 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 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.

       -r, --resizefs
              Resize underlying filesystem together with  the  logical  volume
              using fsadm(8).

       --use-policies
              Resizes  the  logical volume according to configured policy. See
              lvm.conf(5) for some details.

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:

       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 allocation 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)