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|ORIGIN}] |
  11 \-L|\-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
  12 [\-f|\-\-force]
  13 [\-n|\-\-nofsck]
  14 [\-r|\-\-resizefs]
  15 [\-t|\-\-test]
  16 [\-v|\-\-verbose] LogicalVolumePath [PhysicalVolumePath[:PE[-PE]]...]
  17 .SH DESCRIPTION
  18 lvextend allows you to extend the size of a logical volume.
  19 Extension of snapshot logical volumes (see
  20 .B lvcreate(8)
  21 for information to create snapshots) is supported as well.
  22 But to change the number of copies in a mirrored logical
  23 volume use
  24 .BR lvconvert (8).
  25 .SH OPTIONS
  26 See \fBlvm\fP for common options.
  27 .TP
  28 .I \-\-noudevsync
  29 Disable udev synchronisation. The
  30 process will not wait for notification from udev.
  31 It will continue irrespective of any possible udev processing
  32 in the background.  You should only use this if udev is not running
  33 or has rules that ignore the devices LVM2 creates.
  34 .TP
  35 .I \-l, \-\-extents [+]LogicalExtentsNumber[%{VG|LV|PVS|FREE|ORIGIN}]
  36 Extend or set the logical volume size in units of logical extents.
  37 With the + sign the value is added to the actual size
  38 of the logical volume and without it, the value is taken as an absolute one.
  39 The number can also be expressed as a percentage of the total space
  40 in the Volume Group with the suffix %VG, relative to the existing
  41 size of the Logical Volume with the suffix %LV, of the remaining
  42 free space for the specified PhysicalVolume(s) with the suffix %PVS,
  43 as a percentage of the remaining free space in the Volume Group
  44 with the suffix %FREE, or (for a snapshot) as a percentage of the total
  45 space in the Origin Logical Volume with the suffix %ORIGIN.
  46 .TP
  47 .I \-L, \-\-size [+]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
  48 Extend or set the logical volume size in units of megabytes.
  49 A size suffix of M for megabytes,
  50 G for gigabytes, T for terabytes, P for petabytes
  51 or E for exabytes is optional.
  52 With the + sign the value is added to the actual size
  53 of the logical volume and without it, the value is taken as an absolute one.
  54 .TP
  55 .I \-i, \-\-stripes Stripes
  56 Gives the number of stripes for the extension.
  57 Not applicable to LVs using the original metadata LVM format, which must
  58 use a single value throughout.
  59 .TP
  60 .I \-I, \-\-stripesize StripeSize
  61 Gives the number of kilobytes for the granularity of the stripes.
  62 Not applicable to LVs using the original metadata LVM format, which must
  63 use a single value throughout.
  64 .br
  65 StripeSize must be 2^n (n = 2 to 9)
  66 .TP
  67 .I \-f, \-\-force
  68 Proceed with size extension without prompting.
  69 .TP
  70 .I \-n, \-\-nofsck
  71 Do not perform fsck before extending filesystem when filesystem
  72 requires it. You may need to use \fB--force\fR to proceed with
  73 this option.
  74 .TP
  75 .I \-r, \-\-resizefs
  76 Resize underlying filesystem together with the logical volume using
  77 \fBfsadm\fR(8).
  78 .SH Examples
  79 "lvextend -L +54 /dev/vg01/lvol10 /dev/sdk3" tries to extend the size of
  80 that logical volume by 54MB on physical volume /dev/sdk3.
  81 This is only possible if /dev/sdk3 is a member of volume group vg01 and
  82 there are enough free physical extents in it.
  83
  84 "lvextend /dev/vg01/lvol01 /dev/sdk3" tries to extend the size of that
  85 logical volume by the amount of free space on physical volume /dev/sdk3.
  86 This is equivalent to specifying "-l +100%PVS" on the command line.
  87
  88 .br
  89 "lvextend -L+16M vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9"
  90 .br
  91 tries to extend a logical volume "vg01/lvol01" by 16MB using physical extents
  92 /dev/sda:8-9 and /dev/sdb:8-9 for allocation of extents.
  93
  94 .SH SEE ALSO
  95 .BR fsadm (8),
  96 .BR lvm (8),
  97 .BR lvcreate (8),
  98 .BR lvconvert (8),
  99 .BR lvreduce (8),
 100 .BR lvresize (8),
 101 .BR lvchange (8)