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

   1 .\"    $NetBSD$
   2 .\"
   3 .TH LVRESIZE 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Sistina Software UK" \" -*- nroff -*-
   4 .SH NAME
   5 lvresize \- resize a logical volume
   6 .SH SYNOPSIS
   7 .B lvresize
   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 lvresize allows you to resize a logical volume.
  17 Be careful when reducing a logical volume's size, because data in the reduced
  18 part is lost!!!
  19 You should therefore ensure that any filesystem on the volume is
  20 shrunk first so that the extents that are to be removed are not in use.
  21 Resizing snapshot logical volumes (see
  22 .B lvcreate(8)
  23 for information about creating snapshots) is supported as well.
  24 But to change the number of copies in a mirrored logical
  25 volume use
  26 .BR lvconvert (8).
  27 .SH OPTIONS
  28 See \fBlvm\fP for common options.
  29 .TP
  30 .I \-l, \-\-extents [+|-]LogicalExtentsNumber[%{VG|LV|PVS|FREE}]
  31 Change or set the logical volume size in units of logical extents.
  32 With the + or - sign the value is added to or subtracted from the actual size
  33 of the logical volume and without it, the value is taken as an absolute one.
  34 The number can also be expressed as a percentage of the total space
  35 in the Volume Group with the suffix %VG, relative to the existing
  36 size of the Logical Volume with the suffix %LV, as a percentage of
  37 the remaining free space of the PhysicalVolumes on the command line with the
  38 suffix %PVS, or as a percentage of the remaining free space in the
  39 Volume Group with the suffix %FREE.
  40 .TP
  41 .I \-L, \-\-size [+|-]LogicalVolumeSize[kKmMgGtTpPeE]
  42 Change or set the logical volume size in units of megabytes.
  43 A size suffix of M for megabytes,
  44 G for gigabytes, T for terabytes, P for petabytes
  45 or E for exabytes is optional.
  46 With the + or - sign the value is added to or subtracted from
  47 the actual size of the logical volume and without it, the value is taken as an
  48 absolute one.
  49 .TP
  50 .I \-i, \-\-stripes Stripes
  51 Gives the number of stripes to use when extending a Logical Volume.
  52 Defaults to whatever the last segment of the Logical Volume uses.
  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 Defaults to whatever the last segment of the Logical Volume uses.
  59 Not applicable to LVs using the original metadata LVM format, which
  60 must use a single value throughout.
  61 .br
  62 StripeSize must be 2^n (n = 2 to 9)
  63 .SH SEE ALSO
  64 .BR lvm (8),
  65 .BR lvconvert (8),
  66 .BR lvcreate (8),
  67 .BR lvreduce (8),
  68 .BR lvchange (8)