external/gpl2/lvm2/dist/man/lvextend.8

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