2008-10-08 16:50:13 +04:00
.TH LVREDUCE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2002-01-04 23:35:19 +03:00
.SH NAME
2014-06-11 13:06:30 +04:00
lvreduce \(em reduce the size of a logical volume
2002-01-04 23:35:19 +03:00
.SH SYNOPSIS
.B lvreduce
2011-09-07 12:50:35 +04:00
.RB [ \- A | \- \- autobackup
.RI { y | n }]
2014-05-21 16:53:56 +04:00
.RB [ \- \- commandprofile
.IR ProfileName ]
2011-09-07 12:50:35 +04:00
.RB [ \- d | \- \- debug ]
.RB [ \- h | \- \- help ]
.RB [ \- t | \- \- test ]
.RB [ \- v | \- \- verbose ]
.RB [ \- \- version ]
.RB [ \- f | \- \- force ]
.RB [ \- \- noudevsync ]
2012-04-11 16:42:10 +04:00
.RB { \- l | \- \- extents
2016-03-04 23:59:04 +03:00
.RI [ \- ] LogicalExtentsNumber [ % { VG | LV | FREE | ORIGIN }]
.RB |
.BR \- L | \- \- size
2011-09-07 12:50:35 +04:00
.RI [ \- ] LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]}
.RB [ \- n | \- \- nofsck ]
2016-06-24 15:51:20 +03:00
.RB [ \- \- reportformat
.RB { basic | json }]
2011-09-07 12:50:35 +04:00
.RB [ \- r | \- \- resizefs ]
.IR LogicalVolume { Name | Path }
2002-01-04 23:35:19 +03:00
.SH DESCRIPTION
lvreduce allows you to reduce the size of a logical volume.
Be careful when reducing a logical volume's size, because data in the
2012-04-11 16:42:10 +04:00
reduced part is lost!!!
.br
You should therefore ensure that any filesystem on the volume is
2002-01-04 23:35:19 +03:00
resized
2004-12-09 19:59:18 +03:00
.I before
2002-01-04 23:35:19 +03:00
running lvreduce so that the extents that are to be removed are not in use.
2004-09-24 14:34:53 +04:00
.br
2002-01-04 23:35:19 +03:00
Shrinking snapshot logical volumes (see
2011-09-07 12:50:35 +04:00
.BR lvcreate (8)
2002-01-04 23:35:19 +03:00
for information to create snapshots) is supported as well.
2006-08-19 02:27:01 +04:00
But to change the number of copies in a mirrored logical
2012-04-11 16:42:10 +04:00
volume use
2011-09-07 12:50:35 +04:00
.BR lvconvert (8).
2004-11-16 21:09:32 +03:00
.br
Sizes will be rounded if necessary - for example, the volume size must
be an exact number of extents and the size of a striped segment must
be a multiple of the number of stripes.
2006-08-19 01:49:19 +04:00
.br
2002-01-04 23:35:19 +03:00
.SH OPTIONS
2012-04-11 16:42:10 +04:00
See \fB lvm\fP (8) for common options.
2002-01-04 23:35:19 +03:00
.TP
2011-09-07 12:50:35 +04:00
.BR \- f ", " \- \- force
2010-06-21 19:56:57 +04:00
Force size reduction without prompting even when it may cause data loss.
2002-01-04 23:35:19 +03:00
.TP
2011-09-07 12:50:35 +04:00
.IR \fB \- l ", " \fB \- \- extents " [" \- ] LogicalExtentsNumber [ % { VG | LV | FREE | ORIGIN }]
2002-01-04 23:35:19 +03:00
Reduce or set the logical volume size in units of logical extents.
2011-09-07 12:50:35 +04:00
With the \fI -\fP sign the value will be subtracted from
2010-02-03 06:58:08 +03:00
the logical volume's actual size and without it the value will be taken
as an absolute size.
2014-02-25 02:48:23 +04:00
The total number of physical extents freed will be greater than this logical
value if, for example, the volume is mirrored.
2006-09-26 13:35:43 +04:00
The number can also be expressed as a percentage of the total space
2011-09-07 12:50:35 +04:00
in the Volume Group with the suffix \fI %VG\fP , relative to the existing
size of the Logical Volume with the suffix \fI %LV\fP , as a percentage of the
remaining free space in the Volume Group with the suffix \fI %FREE\fP , or (for
2010-02-03 06:58:08 +03:00
a snapshot) as a percentage of the total space in the Origin Logical
2011-09-07 12:50:35 +04:00
Volume with the suffix \fI %ORIGIN\fP .
2013-12-17 22:26:10 +04:00
The resulting value for the subtraction is rounded downward, for the absolute
2012-01-05 19:38:18 +04:00
size it is rounded upward.
2014-02-25 02:48:23 +04:00
N.B. In a future release, when expressed as a percentage with VG or FREE, the
number will be treated as an approximate total number of physical extents to be
freed (including extents used by any mirrors, for example). The code may
currently release more space than you might otherwise expect.
2002-01-04 23:35:19 +03:00
.TP
2011-09-07 12:50:35 +04:00
.IR \fB \- L ", " \fB \- \- size " [" \- ] LogicalVolumeSize [ bBsSkKmMgGtTpPeE ]
2009-07-07 23:28:57 +04:00
Reduce or set the logical volume size in units of megabytes.
2011-09-07 12:50:35 +04:00
A size suffix of \fI k\fP for kilobyte, \fI m\fP for megabyte,
\fI g\fP for gigabytes, \fI t\fP for terabytes, \fI p\fP for petabytes
or \fI e\fP for exabytes is optional.
2012-04-11 16:42:10 +04:00
With the \fI \- \fP sign the value will be subtracted from
2003-11-14 19:17:55 +03:00
the logical volume's actual size and without it it will be taken as
2002-01-04 23:35:19 +03:00
an absolute size.
2010-06-17 15:25:43 +04:00
.TP
2011-09-07 12:50:35 +04:00
.BR \- n ", " \- \- nofsck
2010-06-17 15:25:43 +04:00
Do not perform fsck before resizing filesystem when filesystem
2012-04-11 16:42:10 +04:00
requires it. You may need to use \fB \- \- force\fR to proceed with
2010-06-21 19:56:57 +04:00
this option.
2010-06-17 15:25:43 +04:00
.TP
2012-04-11 16:42:10 +04:00
.BR \- \- noudevsync
Disable udev synchronisation. The
process will not wait for notification from udev.
It will continue irrespective of any possible udev processing
in the background. You should only use this if udev is not running
or has rules that ignore the devices LVM2 creates.
.TP
2011-09-07 12:50:35 +04:00
.BR \- r ", " \- \- resizefs
2012-04-11 16:42:10 +04:00
Resize underlying filesystem together with the logical volume using
2011-09-07 12:50:35 +04:00
.BR fsadm (8).
2012-04-11 16:42:10 +04:00
.SH Examples
2011-09-07 12:50:35 +04:00
Reduce the size of logical volume lvol1 in volume group vg00 by 3 logical extents:
.sp
2012-04-11 16:42:10 +04:00
.B lvreduce \- l \- 3 vg00/lvol1
2002-01-04 23:35:19 +03:00
.SH SEE ALSO
2010-06-17 15:25:43 +04:00
.BR fsadm (8),
2004-11-16 21:09:32 +03:00
.BR lvchange (8),
2012-04-11 16:42:10 +04:00
.BR lvconvert (8),
.BR lvcreate (8),
.BR lvextend (8),
.BR lvm (8),
2004-11-16 21:09:32 +03:00
.BR lvresize (8),
.BR vgreduce (8)