vgdisplay(1M)vgdisplay(1M)NAMEvgdisplay - display information about LVM volume groups
SYNOPSIS
[vg_name...]
vg_vers | vg_name ...]
Remarks
If a combination of volume groups version 1.0 and 2.0 or higher argu‐
ments are supplied, the arguments may not be processed in the order
they are listed on the command line.
DESCRIPTION
The command displays information about volume groups. For each vg_name
specified, displays information for that volume group only. If no
vg_name is specified, displays names and corresponding information for
all defined volume groups. If the volume group version is specified,
displays names and corresponding information for all volume groups
belonging to the specified volume group version.
The volume group must be activated (see vgchange(1M)) before it can be
displayed.
Options and Arguments
recognizes the following options and arguments:
vg_name The path name of the volume group, for example,
Display volume group information for all volume groups
corresponding to the volume group version vg_vers.
Produce a compact listing of fields described in
The output is a list of colon separated fields format‐
ted as value...].
For each volume group,
display additional information about logical volumes,
physical volumes, and physical volume groups.
Display Without -v Option
If you omit the option, only the following information is displayed:
The path name of the volume group.
Current access mode and quiesce mode of the volume group.
The access mode is either or If the volume group is qui‐
esced, the quiesce mode is displayed on the same line.
The quiesce mode is either or
State of the volume group:
always as after a command, since deactivated volume
groups are not displayed.
Maximum number of logical volumes allowed in the volume group.
Current number of logical volumes in the volume group.
Number of logical volumes currently open in the volume group.
Maximum number of physical volumes allowed in the volume group.
Current number of physical volumes in the volume group.
Number of physical volumes that are currently active.
Maximum number (limit) of physical extents that can be allocated
from any of the physical volumes in the volume group.
Number of Volume Group Descriptor Areas within the volume group.
Size of each physical extent in Megabytes.
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. (This
does not include physical extents belonging to stand-by
spare physical volumes; presence of these is only possi‐
ble if you are using mirrored disks -- see below).
Number of physical extents currently allocated to logical vol‐
umes.
Number of physical extents not allocated (not including physical
extents
belonging to stand-by spares).
Total number of physical volume groups within the volume group.
Total number of physical volumes that are designated as spares
for this
volume group. This will include both stand-by and active
spares -- see below.
Total number of spare physical volumes that are active in place
of (containing
all data from) a failed physical volume.
Volume Group version.
The maximum size of the volume group.
The units for this display are determined by a suffix:
(megabytes), (gigabytes), (terabytes), (petabytes). For
example: 256 terabytes would be 256t.
For version 1.0 volume groups, it may not be possible to
achieve the VG Max Size as it may be limited by the size
of each physical volume in the volume group.
The maximum number of extents in the
volume group (VG Max Size/PE size).
For version 1.0 volume groups, it may not be possible to
achieve the VG Max Extents as it may be limited by the
size of each physical volume in the volume group.
Display With -v Option
If you specify the option, lists the following additional information
for each logical volume, for each physical volume, and for each physi‐
cal volume group in the volume group:
Information about logical volumes belonging to
vg_name:
The block device path name of a logical volume in the volume
group.
State of the logical volume:
Logical volume available but contains physical extents
that are not current.
Logical volume available with no stale extents.
Logical volume is not available for use.
Size of the logical volume.
Number of logical extents in the logical volume.
Number of physical extents used by the logical volume.
Number of physical volumes used by the logical volume.
Information about physical volumes belonging to
vg_name:
The block device path name of a physical volume in the group.
When an alternate link to a physical volume has been added, is
displayed next to the device path name. (See vgextend(1M) for
definition.)
State of the physical volume: (
spare physical volumes are only relevant if you have
installed HP MirrorDisk/UX software):
The physical volume is available and is not a spare phys‐
ical volume.
The physical volume is available. However, its data still
resides on an
active spare.
The physical volume is available and is an active spare
physical volume.
(An active spare is a spare that has taken over
for a failed physical volume.)
The physical volume is a spare "standing by" in case of a
failure on any other
physical volume in this volume group. It can only
be used to capture data from a failed physical
volume.
The physical volume is unavailable and is not a spare
physical volume.
The physical volume is unavailable. However, it's data
now resides on an
active spare, and its data is available if the
active spare is available.
The physical volume is unavailable and it's an active
spare. Thus, the data
on this physical volume is unavailable.
The physical volume is a spare "standing by" that is not
currently available
to capture data from a failed physical volume.
Total number of physical extents on the physical volume.
Number of free physical extents on the physical volume.
If the physical volume represents an active spare, this
field will show the name of the failed physical volume
whose data now resides on this spare. This information
can be used to manually move the data back to the origi‐
nal physical volume once it has been repaired (see
pvmove(1M)). If it cannot be determined which physical
volume that the data came from, this field will instead
display A missing PV would indicate that when the volume
group was last activated or reactivated (see
vgchange(1M)), the "failed" physical volume was not able
to attach to the volume group.
If the physical volume represents a failed physical volume, this
field will
show the name of the active spare physical volume that
now contains the data that originally residing on this
volume. This information can be used to manually move the
data back to the original physical volume (see
pvmove(1M)) once it has been repaired.
For multiported devices accessed via multiple paths, this field
indicates the autoswitch behavior for the physical volume
(see pvchange(1M)).
LVM will automatically switch from the path it is using
whenever a
better path to the physical volume is available.
LVM will switch paths when a better path recovers
(after it had failed earlier), or if the current
path fails and another path is available. This
is the default.
LVM will automatically switch to using the best available
path only
when the path currently in use is unavailable.
LVM will continue using a specific path for the
physical volume as long as it works, regardless
of whether another better path recovers from a
failure.
This specifies LVM's proactive polling behavior on alternate
paths
of a physical volume.
LVM will periodically test alternate paths of a physical
volume and
help to identify faulty paths before user I/O is
affected. This is the default.
No periodic testing of alternate paths of a physical vol‐
ume will be performed.
Information about physical volume groups belonging to
vg_name:
Name of a physical volume group in the volume group.
The block device path name of a physical volume in the physical
volume group.
Compact listing (-F Option)
The option generates a compact and parsable listing of the command out‐
put in colon separated fields formatted as value...]. The option is
designed to be used by scripts. The resulting command output may be
split across multiple lines. The output may include new keys and/or
values in the future. If a key is deprecated, its associated value is
set to For the current version of the command, the lines format is:
The format of Line 1 is as follows:
For volume groups version 2.0 or higher two additional fields
are added to the LINE 1 format after the vg_version field.
vg_name=value:vg_write_access=value:vg_status=value:max_lv=value:
cur_lv=value:open_lv=value:max_pv=value:cur_pv=value:act_pv=value:
max_pe_per_pv=value:vgda=value:pe_size=value:total_pe=value:
alloc_pe=value:free_pe=value:total_pvg=value:total_spare_pvs=value:
total_spare_pvs_in_use=value:vg_version=value:vg_max_size=value:
vg_max_extents=value:
The format of Line 2 is as follows:
cluster:server=value:client=value[:...]
The format of Line 3 is as follows:
lv_name=value:lv_status=value:lv_size=value:current_le=value:
allocated_pe=value:used_pv=value
The above line may be repeated with different values.
The format of Line
m is as follows:
pv_name=value[,value]:pv_status=value:total_pe=value:free_pv=value:
spared_from_pv=value:spared_to_pv=value:autoswitch=value:
proactive_polling=value
The above line may be repeated with different values.
The format of Line
n is as follows:
pvg_name=value:pv_name=value[,value...]
The above line may be repeated with different values.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If 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:
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:
Display information about all the volume groups within the system that
are of version 2.0:
SEE ALSOlvdisplay(1M), lvmadm(1M), pvdisplay(1M), vgchange(1M), vgcreate(1M).
vgdisplay(1M)