contrib/lvm2/dist/man/lvextend.8.in

   1 .TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 lvextend \- extend the size of a logical volume
   4 .SH SYNOPSIS
   5 .B lvextend
   6 [\-\-alloc AllocationPolicy]
   7 [\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help]
   8 [\-\-noudevsync]
   9 [\-i|\-\-stripes Stripes [\-I|\-\-stripesize StripeSize]]
  10 {\-l|\-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE}] |
  11 \-L|\-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
  12 [\-t|\-\-test]
  13 [\-v|\-\-verbose] LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]
  14 .SH DESCRIPTION
  15 lvextend allows you to extend the size of a logical volume.
  16 Extension of snapshot logical volumes (see
  17 .B lvcreate(8)
  18 for information to create snapshots) is supported as well.
  19 But to change the number of copies in a mirrored logical
  20 volume use
  21 .BR lvconvert (8).
  22 .SH OPTIONS
  23 See \fBlvm\fP for common options.
  24 .TP
  25 .I \-\-noudevsync
  26 Disable udev synchronisation. The
  27 process will not wait for notification from udev.
  28 It will continue irrespective of any possible udev processing
  29 in the background.  You should only use this if udev is not running
  30 or has rules that ignore the devices LVM2 creates.
  31 .TP
  32 .I \-l, \-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE}]
  33 Extend or set the logical volume size in units of logical extents.
  34 With the + sign the value is added to the actual size
  35 of the logical volume and without it, the value is taken as an absolute one.
  36 The number can also be expressed as a percentage of the total space
  37 in the Volume Group with the suffix %VG, relative to the existing
  38 size of the Logical Volume with the suffix %LV, of the remaining
  39 free space for the specified PhysicalVolume(s) with the suffix %PVS,
  40 or as a percentage of the remaining free space in the Volume Group
  41 with the suffix %FREE.
  42 .TP
  43 .I \-L, \-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
  44 Extend or set the logical volume size in units of megabytes.
  45 A size suffix of M for megabytes,
  46 G for gigabytes, T for terabytes, P for petabytes
  47 or E for exabytes is optional.
  48 With the + sign the value is added to the actual size
  49 of the logical volume and without it, the value is taken as an absolute one.
  50 .TP
  51 .I \-i, \-\-stripes Stripes
  52 Gives the number of stripes for the extension.
  53 Not applicable to LVs using the original metadata LVM format, which must
  54 use a single value throughout.
  55 .TP
  56 .I \-I, \-\-stripesize StripeSize
  57 Gives the number of kilobytes for the granularity of the stripes.
  58 Not applicable to LVs using the original metadata LVM format, which must
  59 use a single value throughout.
  60 .br
  61 StripeSize must be 2^n (n = 2 to 9)
  62 .SH Examples
  63 "lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3" tries to extend the size of
  64 that logical volume by 54MB on physical volume /dev/sdk3.
  65 This is only possible if /dev/sdk3 is a member of volume group vg01 and
  66 there are enough free physical extents in it.
  67
  68 "lvextend /dev/vg01/lvol01 /dev/sdk3" tries to extend the size of that
  69 logical volume by the amount of free space on physical volume /dev/sdk3.
  70 This is equivalent to specifying "-l +100%PVS" on the command line.
  71
  72 .br
  73 "lvextend -L+16M vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9"
  74 .br
  75 tries to extend a logical volume "vg01/lvol01" by 16MB using physical extents
  76 /dev/sda:8-9 and /dev/sdb:8-9 for allocation of extents.
  77
  78 .SH SEE ALSO
  79 .BR lvm (8),
  80 .BR lvcreate (8),
  81 .BR lvconvert (8),
  82 .BR lvreduce (8),
  83 .BR lvresize (8),
  84 .BR lvchange (8)