1LVREDUCE(8)                 System Manager's Manual                LVREDUCE(8)
2
3
4

NAME

6       lvreduce — reduce the size of a logical volume
7

SYNOPSIS

9       lvreduce   [-A|--autobackup   {y|n}]   [--commandprofile   ProfileName]
10       [-d|--debug]   [-h|--help]   [-t|--test]   [-v|--verbose]   [--version]
11       [-f|--force]    [--noudevsync]    {-l|--extents   [-]LogicalExtentsNum‐
12       ber[%{VG|LV|FREE|ORIGIN}] | [-L|--size  [-]LogicalVolumeSize[bBsSkKmMg‐
13       GtTpPeE]} [-n|--nofsck] [-r|--resizefs] LogicalVolume{Name|Path}
14

DESCRIPTION

16       lvreduce allows you to reduce the size of a logical volume.  Be careful
17       when reducing a logical volume's size, because data in the reduced part
18       is lost!!!
19       You  should  therefore  ensure  that  any  filesystem  on the volume is
20       resized before running lvreduce so that the  extents  that  are  to  be
21       removed are not in use.
22       Shrinking  snapshot logical volumes (see lvcreate(8) for information to
23       create snapshots) is supported as well.  But to change  the  number  of
24       copies in a mirrored logical volume use lvconvert(8).
25       Sizes  will be rounded if necessary - for example, the volume size must
26       be an exact number of extents and the size of a striped segment must be
27       a multiple of the number of stripes.
28

OPTIONS

30       See lvm(8) for common options.
31
32       -f, --force
33              Force  size  reduction  without prompting even when it may cause
34              data loss.
35
36       -l, --extents [-]LogicalExtentsNumber[%{VG|LV|FREE|ORIGIN}]
37              Reduce or set the  logical  volume  size  in  units  of  logical
38              extents.   With the - sign the value will be subtracted from the
39              logical volume's actual size and without it the  value  will  be
40              taken as an absolute size.  The total number of physical extents
41              freed will be greater than this logical value if,  for  example,
42              the  volume  is mirrored.  The number can also be expressed as a
43              percentage of the total space in the Volume Group with the  suf‐
44              fix  %VG,  relative  to  the existing size of the Logical Volume
45              with the suffix %LV, as a percentage of the remaining free space
46              in  the  Volume Group with the suffix %FREE, or (for a snapshot)
47              as a percentage of the total space in the Origin Logical  Volume
48              with  the  suffix %ORIGIN.  The resulting value for the subtrac‐
49              tion is rounded downward, for the absolute size  it  is  rounded
50              upward.   N.B. In a future release, when expressed as a percent‐
51              age with VG or FREE, the number will be treated as  an  approxi‐
52              mate  total  number  of  physical extents to be freed (including
53              extents used by any mirrors, for example).  The  code  may  cur‐
54              rently release more space than you might otherwise expect.
55
56       -L, --size [-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
57              Reduce  or set the logical volume size in units of megabytes.  A
58              size suffix of k for kilobyte, m for megabyte, g for  gigabytes,
59              t  for terabytes, p for petabytes or e for exabytes is optional.
60              With the - sign the value will be subtracted  from  the  logical
61              volume's actual size and without it it will be taken as an abso‐
62              lute size.
63
64       -n, --nofsck
65              Do not perform fsck before resizing filesystem  when  filesystem
66              requires  it.  You  may need to use --force to proceed with this
67              option.
68
69       --noudevsync
70              Disable udev synchronisation. The  process  will  not  wait  for
71              notification  from  udev.   It will continue irrespective of any
72              possible udev processing in the background.  You should only use
73              this if udev is not running or has rules that ignore the devices
74              LVM2 creates.
75
76       -r, --resizefs
77              Resize underlying filesystem together with  the  logical  volume
78              using fsadm(8).
79

Examples

81       Reduce the size of logical volume lvol1 in volume group vg00 by 3 logi‐
82       cal extents:
83
84       lvreduce -l -3 vg00/lvol1
85

SEE ALSO

87       fsadm(8), lvchange(8), lvconvert(8), lvcreate(8), lvextend(8),  lvm(8),
88       lvresize(8), vgreduce(8)
89
90
91
92Sistina Software UKLVM TOOLS 2.02.143(2)-RHEL6 (2016-12-13)        LVREDUCE(8)
Impressum