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)