vgdisplay(1M) vgdisplay(1M)
NAME [Toc] [Back]
vgdisplay - display information about LVM volume groups
SYNOPSIS [Toc] [Back]
/usr/sbin/vgdisplay [-v] [vg_name ...]
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
vgdisplay recognizes the following options and arguments:
vg_name
The path name of the volume group, for example, /dev/vg00.
-v For each volume group, display additional information about
logical volumes, physical volumes, and physical volume
groups.
Display Without -v Option [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
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. (This
does not include physical extents belonging
to stand-by spare physical volumes; presence
of these is only possible if you are using
mirrored disks -- see below).
Alloc PE Number of physical extents currently
allocated to logical volumes.
Free PE Number of physical extents not allocated (not
including physical extents belonging to
stand-by spares).
Total PVG Total number of physical volume groups within
the volume group.
Total Spare PVs 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 Spare PVs in use [Toc] [Back]
Total number of spare physical volumes that
are active in place of (containing all data
from) a failed physical volume.
Display With -v Option [Toc] [Back]
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 ---
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
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
Hewlett-Packard Company - 3 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
device path name. (See vgextend(1M) for
definition.)
PV Status State of the physical volume: (NOTE: spare
physical volumes are only relevant if you
have installed HP MirrorDisk/UX software):
available The physical volume
is available and is
not a spare physical
volume.
available/data spared The physical volume
is available.
However, it's data
still resides on an
active spare.
available/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.)
available/standby spare 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.
unavailable The physical volume
is unavailable and
is not a spare
physical volume.
unavailable/data spared The physical volume
is unavailable.
However, it's data
now resides on an
active spare, and
its data is
available if the
Hewlett-Packard Company - 4 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
active spare is
available.
unavailable/active spare The physical volume
is unavailable and
it's an active
spare. Thus, the
data on this
physical volume is
unavailable.
unavailable/standby spare
The physical volume
is a spare "standing
by" that is not
currently available
to capture data from
a failed physical
volume.
Total PE Total number of physical extents on the
physical volume.
Free PE Number of free physical extents on the
physical volume.
Spared from PV 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
original 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 Missing PV. 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.
Spared to PV 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.
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
Autoswitch For multiported devices accessed via multiple
paths, this field indicates the autoswitch
behavior for the physical volume (see
pvchange(1M)).
On 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.
Off 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.
--- 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 [Toc] [Back]
Environment Variables
LANG determines the language in which messages are displayed.
Hewlett-Packard Company - 6 - HP-UX 11i Version 2: August 2003
vgdisplay(1M) vgdisplay(1M)
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 [Toc] [Back]
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 [Toc] [Back]
lvdisplay(1M), pvdisplay(1M), vgchange(1M), vgcreate(1M).
Hewlett-Packard Company - 7 - HP-UX 11i Version 2: August 2003 [ Back ] |
