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

   1 .TH LVREDUCE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 lvreduce \- reduce the size of a logical volume
   4 .SH SYNOPSIS
   5 .B lvreduce
   6 [\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-f|\-\-force]
   7 [\-h|\-?|\-\-help]
   8 [\-\-noudevsync]
   9 {\-l|\-\-extents [\-]LogicalExtentsNumber[%{VG|LV|FREE}] |
  10 \-L|\-\-size [\-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]}
  11 [\-t|\-\-test]
  12 [\-v|\-\-verbose] LogicalVolume[Path]
  13 .SH DESCRIPTION
  14 lvreduce allows you to reduce the size of a logical volume.
  15 Be careful when reducing a logical volume's size, because data in the
  16 reduced part is lost!!!
  17 .br
  18 You should therefore ensure that any filesystem on the volume is
  19 resized
  20 .I before
  21 running lvreduce so that the extents that are to be removed are not in use.
  22 .br
  23 Shrinking snapshot logical volumes (see
  24 .B lvcreate(8)
  25 for information to create snapshots) is supported as well.
  26 But to change the number of copies in a mirrored logical
  27 volume use
  28 .B lvconvert (8).
  29 .br
  30 Sizes will be rounded if necessary - for example, the volume size must
  31 be an exact number of extents and the size of a striped segment must
  32 be a multiple of the number of stripes.
  33 .br
  34 .SH OPTIONS
  35 See \fBlvm\fP for common options.
  36 .TP
  37 .I \-f, \-\-force
  38 Force size reduction without any question.
  39 .TP
  40 .I \-\-noudevsync
  41 Disable udev synchronisation. The
  42 process will not wait for notification from udev.
  43 It will continue irrespective of any possible udev processing
  44 in the background.  You should only use this if udev is not running
  45 or has rules that ignore the devices LVM2 creates.
  46 .TP
  47 .I \-l, \-\-extents [\-]LogicalExtentsNumber[%{VG|LV|FREE}]
  48 Reduce or set the logical volume size in units of logical extents.
  49 With the - sign the value will be subtracted from
  50 the logical volume's actual size and without it the will be taken as
  51 an absolute size.
  52 The number can also be expressed as a percentage of the total space
  53 in the Volume Group with the suffix %VG or relative to the existing
  54 size of the Logical Volume with the suffix %LV or as a percentage of the remaining
  55 free space in the Volume Group with the suffix %FREE.
  56 .TP
  57 .I \-L, \-\-size [\-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
  58 Reduce or set the logical volume size in units of megabytes.
  59 A size suffix of k for kilobyte, m for megabyte,
  60 g for gigabytes, t for terabytes, p for petabytes
  61 or e for exabytes is optional.
  62 With the - sign the value will be subtracted from
  63 the logical volume's actual size and without it it will be taken as
  64 an absolute size.
  65 .SH Example
  66 "lvreduce -l -3 vg00/lvol1" reduces the size of logical volume lvol1
  67 in volume group vg00 by 3 logical extents.
  68 .SH SEE ALSO
  69 .BR lvchange (8),
  70 .BR lvconvert (8),
  71 .BR lvcreate (8),
  72 .BR lvextend (8),
  73 .BR lvm (8),
  74 .BR lvresize (8),
  75 .BR vgreduce (8)