 |
» |
|
|
|
NAMEvgdisplay — display information about LVM volume groups SYNOPSIS/usr/sbin/vgdisplay
[-F]
[-v]
[vg_name...] DESCRIPTIONThe
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 Argumentsvgdisplay
recognizes the following options and arguments:
- vg_name
The path name of the volume group,
for example,
/dev/vg00. - -F
Produce a compact listing of fields described in
Compact Listing (-F Option).
The output is a list of colon separated fields formatted as
key=value
[,
value...]. - -v
For each volume group,
display additional information about logical volumes,
physical volumes, and physical volume groups.
Display Without -v OptionIf 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 and quiesce mode of the volume group.
The access mode is either
read/write
or
read-only.
If the volume group is quiesced,
the quiesce mode is displayed on the same line.
The quiesce mode is either
read/write-quiesced
or
write-quiesced. - 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 in Megabytes. - 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
Total number of spare physical volumes that are active in place of (containing
all data from) a failed physical volume.
Display With -v OptionIf 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 with no stale extents. - unavailable
Logical volume is not available for use.
- LV Size (Megabytes)
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. (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 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. - 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.
Compact listing (-F Option)The
-F
option generates a compact and parsable listing of the command
output in colon separated fields formatted as
key=value
[,
value...].
The
-F
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
NAM (key=NAM
).
For the current version of the
vgdisplay
command, the lines format is:
- LINE 1
The format of Line 1 is as follows:
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 - LINE 2
The format of Line 2 is as follows: cluster:server=value:client=value[:...] - LINE 3
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. - LINE m
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 - ...
The above line may be repeated with different values. - LINE n
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 INFLUENCESEnvironment VariablesLANG
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)). EXAMPLESDisplay 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:
|
Printable version
