NAME

vgdisplay − display information about LVM volume groups

SYNOPSIS

/sbin/vgdisplay [-v] [vg_name ...]

DESCRIPTION

The vgdisplay command displays information about volume groups.  For each vg_name specified, vgdisplay displays information for that volume group only.  If no vg_name is specified, vgdisplay displays names and corresponding information for all defined volume groups. 

The volume group must be activated (see vgchange(1M)) before it can be displayed.

Options and Arguments

vgdisplay recognizes the following option and argument:

vg_name
The path name of the volume group, for example, /dev/vg00. 

-v For each volume group, display additional information about each logical volume, physical volume, and physical volume group. 

Display Without −v Option

If you omit the -v option, only the following information is displayed:

--- Volume groups ---

VG Name The path name of the volume group. 

VG Write Access Current access mode of the volume group.  Possible values are read/write and read-only. 

VG Status State of the volume group: always available, as after a vgchange -a y command, since deactivated volume groups are not displayed. 

Max LV Maximum number of logical volumes allowed in the volume group. 

Cur LV Current number of logical volumes in the volume group. 

Open LV Number of logical volumes currently open in the volume group. 

Max PV Maximum number of physical volumes allowed in the volume group. 

Cur PV Current number of physical volumes in the volume group. 

Act PV Number of physical volumes that are currently active. 

Max PE per PV Maximum number (limit) of physical extents that can be allocated from any of the physical volumes in the volume group. 

VGDA Number of Volume Group Descriptor Areas within the volume group. 

PE Size Size of each physical extent. 

Total PE Total number of physical extents within the volume group: the sum of the number of physical extents belonging to each available physical volume in the volume group. 

Alloc PE Number of physical extents currently allocated to logical volumes. 

Free PE Number of physical extents not allocated. 

Total PVG Total number of physical volume groups within the volume group. 

Display With −v Option

If you specify the -v option, vgdisplay lists the following additional information for each logical volume, for each physical volume, and for each physical volume group in the volume group:

--- Logical volumes ---

Information about logical volumes belonging to vg_name:

LV Name The block device path name of a logical volume in the volume group. 

LV Status State of the logical volume:

available/stale Logical volume available but contains physical extents that are not current. 

available/syncd Logical volume available and synchronized. 

available Logical volume available; stale/syncd state cannot be confidently determined because logical volumes have both the Mirror Write Cache and Mirror Consistency Recovery turned off. 

unavailable Logical volume is not available for use. 

LV Size (Mbytes) Size of the logical volume. 

Current LE Number of logical extents in the logical volume. 

Allocated PE Number of physical extents used by the logical volume. 

Used PV Number of physical volumes used by the logical volume. 

--- Physical volumes ---

Information about physical volumes belonging to vg_name:

PV Name The block device path name of a physical volume in the group.  When an alternate link to a physical volume has been added, "Alternate Link" is displayed next to the device path name. 

PV Status State of the physical volume. 

Total PE Total number of physical extents on the physical volume. 

Free PE Number of free physical extents on the physical volume. 

--- Physical volume groups ---

Information about physical volume groups belonging to vg_name:

PVG Name Name of a physical volume group in the volume group. 

PV Name The block device path name of a physical volume in the physical volume group. 

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

If LANG is not specified or is null, it defaults to "C" (see lang(5)).

If any internationalization variable contains an invalid setting, all internationalization variables default to "C" (see environ(5)).

EXAMPLES

Display information about all the volume groups within the system:

vgdisplay

Display all of the information about one volume group, including the characteristics and status of both the logical and physical extents of the volume group:

vgdisplay -v /dev/vg02

SEE ALSO

lvdisplay(1M), pvdisplay(1M), vgchange(1M), vgcreate(1M). 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996