VGREDUCE(8)

NAME
vgreduce - reduce a volume group

SYNOPSIS
vgreduce [-a|--all] [-A|--autobackup{y|n}] [-d|--debug] [-h|--help] [-v|--verbose] VolumeGroupName [PhysicalVolumePath...]

DESCRIPTION
vgreduce allows you to remove one or more unused physical volumes from a volume group.

  OPTIONS

-a, --all
    Removes all empty physical volumes if none are given on command line.

-A, --autobackup y/n
    Controls automatic backup of VG metadata after the change ( see vgcfgbackup(8) ). Default is yes.

-d, --debug
    Enables additional debugging output (if compiled with DEBUG).

-h, --help
    Print a usage message on standard output and exit successfully.

-v, --verbose
    Gives verbose runtime information about vgreduce's activities.

DIAGNOSTICS
vgreduce returns an exit code of 0 for success and > 0 for error:
1  neither volume group name nor physical volume path(s) on command line
2  invalid volume group name
3  error checking existence of volume group
4  volume group must be active
5  error reading VGDA
6  volume group is not reducable (see vgchange(8))
7  no physical volume path(s) on command line
8  realloc error
9  malloc error
10 no empty physical volume to reduce volume group by
11 error setting up VGDA for reduce
12 error reducing VGDA in kernel
13 error writing VGDA to physical volume(s)
95 driver/module not in kernel
96 invalid I/O protocol version
97 error locking logical volume manager
98 invalid lvmtab (run vgscan(8))
99 invalid command line

ENVIRONMENT VARIABLES

LVM_AUTOBACKUP
    If this variable is set to "no" then the automatic backup of VG metadata is turned off.

LVM_VG_MAX_BACKUPS
    This variable determines the backup history depth of kept VGDA copy files in /etc/lvmconf. It can be set to a positive number between 0 and 999. The higher this number is, the more changes you can restore using vgcfgrestore(8).

See also
lvm(8), vgextend(8)

AUTHOR
Heinz Mauelshagen <Linux-LVM@Sistina.com>