external/gpl2/lvm2/dist/man/lvresize.8.in

   1 .TH LVRESIZE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 lvresize \- resize a logical volume
   4 .SH SYNOPSIS
   5 .B lvresize
   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 lvresize allows you to resize a logical volume.
  16 Be careful when reducing a logical volume's size, because data in the reduced
  17 part is lost!!!
  18 You should therefore ensure that any filesystem on the volume is
  19 shrunk first so that the extents that are to be removed are not in use.
  20 Resizing snapshot logical volumes (see
  21 .B lvcreate(8)
  22 for information about creating snapshots) is supported as well.
  23 But to change the number of copies in a mirrored logical
  24 volume use
  25 .BR lvconvert (8).
  26 .SH OPTIONS
  27 See \fBlvm\fP for common options.
  28 .TP
  29 .I \-\-noudevsync
  30 Disable udev synchronisation. The
  31 process will not wait for notification from udev.
  32 It will continue irrespective of any possible udev processing
  33 in the background.  You should only use this if udev is not running
  34 or has rules that ignore the devices LVM2 creates.
  35 .TP
  36 .I \-l, \-\-extents [+|-]LogicalExtentsNumber[%{VG|LV|PVS|FREE}]
  37 Change or set the logical volume size in units of logical extents.
  38 With the + or - sign the value is added to or subtracted from the actual size
  39 of the logical volume and without it, the value is taken as an absolute one.
  40 The number can also be expressed as a percentage of the total space
  41 in the Volume Group with the suffix %VG, relative to the existing
  42 size of the Logical Volume with the suffix %LV, as a percentage of
  43 the remaining free space of the PhysicalVolumes on the command line with the
  44 suffix %PVS, or as a percentage of the remaining free space in the
  45 Volume Group with the suffix %FREE.
  46 .TP
  47 .I \-L, \-\-size [+|-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
  48 Change 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 + or - sign the value is added to or subtracted from
  53 the actual size of the logical volume and without it, the value is taken as an
  54 absolute one.
  55 .TP
  56 .I \-i, \-\-stripes Stripes
  57 Gives the number of stripes to use when extending a Logical Volume.
  58 Defaults to whatever the last segment of the Logical Volume uses.
  59 Not applicable to LVs using the original metadata LVM format, which must
  60 use a single value throughout.
  61 .TP
  62 .I \-I, \-\-stripesize StripeSize
  63 Gives the number of kilobytes for the granularity of the stripes.
  64 Defaults to whatever the last segment of the Logical Volume uses.
  65 Not applicable to LVs using the original metadata LVM format, which
  66 must use a single value throughout.
  67 .br
  68 StripeSize must be 2^n (n = 2 to 9)
  69 .SH Examples
  70 .br
  71 "lvresize -L+16M vg1/lv1 /dev/sda:0-1 /dev/sdb:0-1"
  72 .br
  73 tries to extend a logical volume "vg1/lv1" by 16MB using physical extents
  74 /dev/sda:0-1 and /dev/sdb:0-1 for allocation of extents.
  75
  76 .SH SEE ALSO
  77 .BR lvm (8),
  78 .BR lvconvert (8),
  79 .BR lvcreate (8),
  80 .BR lvreduce (8),
  81 .BR lvchange (8)