NAME | SYNOPSIS | DESCRIPTION | OPTIONS | Examples | SEE ALSO | COLOPHON

LVREDUCE(8)                System Manager's Manual               LVREDUCE(8)

NAME         top

       lvreduce — reduce the size of a logical volume

SYNOPSIS         top

       lvreduce [-A|--autobackup {y|n}] [--commandprofile ProfileName]
       [-d|--debug] [-h|--help] [-t|--test] [-v|--verbose] [--version]
       [-f|--force] [--noudevsync] {-l|--extents
       [-]LogicalExtentsNumber[%{VG|LV|FREE|ORIGIN}] | -L|--size
       [-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]} [-n|--nofsck] [--reportformat
       {basic|json}] [-r|--resizefs] LogicalVolume{Name|Path}

DESCRIPTION         top

       lvreduce allows you to reduce the size of a logical volume.  Be
       careful when reducing a logical volume's size, because data in the
       reduced part is lost!!!
       You should therefore ensure that any filesystem on the volume is
       resized before running lvreduce so that the extents that are to be
       removed are not in use.
       Shrinking snapshot logical volumes (see lvcreate(8) for information
       to create snapshots) is supported as well.  But to change the number
       of copies in a mirrored logical volume use lvconvert(8).
       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.

OPTIONS         top

       See lvm(8) for common options.

       -f, --force
              Force size reduction without prompting even when it may cause
              data loss.

       -l, --extents [-]LogicalExtentsNumber[%{VG|LV|FREE|ORIGIN}]
              Reduce or set the logical volume size in units of logical
              extents.  With the - sign the value will be subtracted from
              the logical volume's actual size and without it the value will
              be taken as an absolute size.  The total number of physical
              extents freed will be greater than this logical value if, for
              example, the volume is mirrored.  The number can also be
              expressed as a percentage of the total space in the Volume
              Group with the suffix %VG, relative to the existing size of
              the Logical Volume with the suffix %LV, as a percentage of the
              remaining free space in the Volume Group with the suffix
              %FREE, or (for a snapshot) as a percentage of the total space
              in the Origin Logical Volume with the suffix %ORIGIN.  The
              resulting value for the subtraction is rounded downward, for
              the absolute size it is rounded upward.  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.

       -L, --size [-]LogicalVolumeSize[bBsSkKmMgGtTpPeE]
              Reduce or set the logical volume size in units of megabytes.
              A size suffix of k for kilobyte, m for megabyte, g for
              gigabytes, t for terabytes, p for petabytes or e for exabytes
              is optional.  With the - sign the value will be subtracted
              from the logical volume's actual size and without it it will
              be taken as an absolute size.

       -n, --nofsck
              Do not perform fsck before resizing filesystem when filesystem
              requires it. You may need to use --force to proceed with this
              option.

       --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.

       -r, --resizefs
              Resize underlying filesystem together with the logical volume
              using fsadm(8).

Examples         top

       Reduce the size of logical volume lvol1 in volume group vg00 by 3
       logical extents:

       lvreduce -l -3 vg00/lvol1

SEE ALSO         top

       fsadm(8), lvchange(8), lvconvert(8), lvcreate(8), lvextend(8),
       lvm(8), lvresize(8), vgreduce(8)

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for this
       manual page, send it to linux-lvm@redhat.com.  This page was obtained
       from the project's upstream Git repository 
       ⟨https://git.fedorahosted.org/git/lvm2.git⟩ on 2017-03-13.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

Sistina Software UKLVM TOOLS 2.02.169(2)-git (2016-11-30)        LVREDUCE(8)