 |
» |
|
|
|
NAMEpvdisplay — display information about physical volumes in LVM volume group SYNOPSIS/usr/sbin/pvdisplay
[-v]
[-d]
[-b
BlockList]
pv_path ... /usr/sbin/pvdisplay
-l
pv_path ... /usr/sbin/pvdisplay
-F
[-d]
[-v]
pv_path ... DESCRIPTIONThe
pvdisplay
command displays information about each physical volume specified by a
pv_path
parameter. Optionspvdisplay
recognizes the following options:
- pv_path
The block device path name of a physical volume. - -b BlockList
For each block in
BlockList,
display information about the block.
BlockList
is a comma separated list of blocks in
DEV_BSIZE
units. - -d
For each physical volume,
display the offset to the start of the user data in 1024
byte blocks from the beginning of the PV, specify if
pv_path
is a bootable physical volume, and display the number of bad blocks
that were relocated.
These details are displayed in addition to other information. - -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...]. - -l
Check whether
pv_path
refers to a disk device under HP Logical Volume Manager (LVM)
control. - -v
For each physical volume,
display the logical volumes that have extents allocated on the physical volume
and the usage of all the physical extents.
Display Without -v OptionIf you omit the
-v
option,
pvdisplay
displays the characteristics of each physical volume specified by
pv_path:
- --- Physical volumes ---
- PV Name
The block device path name of the physical volume - VG Name
The path name of the volume group - 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, its 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, its 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 in 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.
- Allocatable
Allocation permission for the physical volume - VGDA
Number of volume group descriptors on the physical volume - Cur LV
Number of logical volumes using the physical volume - PE Size (Mbytes)
Size of physical extents on the volume, in megabytes (MB) - Total PE
Total number of physical extents on the physical volume - Free PE
Number of free physical extents on the physical volume - Allocated PE
Number of physical extents on the physical volume
that are allocated to logical volumes - Stale PE
Number of physical extents on the physical volume that are not current - IO Timeout
The I/O timeout used by the disk driver when accessing the physical volume.
A value of
default,
indicates that the driver default I/O timeout is
being used. - 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 physical volume 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
resided 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.
Display With -v OptionIf
-v
is specified,
pvdisplay
lists additional information for each logical volume
and for each physical extent on the physical volume:
- --- Distribution of physical volume ---
The logical volumes that have extents allocated on
pv_path,
displayed in column format:
- LV Name
The block device path name of the logical volume which has extents allocated on
pv_path. - LE of LV
Number of logical extents within the logical volume
that are contained on this physical volume - PE for LV
Number of physical extents within the logical volume
that are contained on this physical volume
- --- Physical extents ---
The following information for each physical extent,
displayed in column format:
- PE
Physical extent number - Status
Current state of the physical extent:
free,
current,
or
stale - LV
The block device path name of the logical volume
to which the extent is allocated - LE
Index of the logical extent to which the physical extent is allocated
Display With -d OptionIf
-d
is specified,
pvdisplay
displays the following additional details for each physical volume:
- Data Start
Starting block number (KB) of the user data.
Displays
unavailable
if the PV is unavailable. - Boot Disk
Specify if the
pv_path
is a bootable physical volume.
- yes
PV was setup as a bootable physical volume using
pvcreate. - no
Physical volume is not a bootable physical volume. - unavailable
Physical volume is unavailable.
- Relocated Blocks
Display the number of bad blocks that were relocated.
Displays
unavailable
if the PV is unavailable.
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
pvdisplay
command, the lines format is:
- LINE 1
The format of Line 1 is as follows: pv_name=value[,value ...]:vg_name=value:pv_status=value:
allocatable=value:vgda=value:cur_lv=value:pe_size=value:
total_pe=value:io_timeout=value:spared_from=value:
spared_to=value:autoswitch=value - LINE 2
The format of Line 2 is as follows: lv_name=value:le_of_lv=value:pe_for_lv=value - ...
The above line may be repeated with different values. - LINE n
The format of Line
n
is as follows: pe=value:pe_status=value:lv=value:le=value - ...
The above line may be repeated with different values.
Display With -b OptionIf
-b
is specified,
pvdisplay
lists additional information for each block specified in
BlockList.
- --- Block Mapping ---
The use of blocks on
pv_path,
displayed in column format:
- Block
The block number relative to the physical volume. - Status
The current status of the block:
free,
used,
structure,
spared,
or
unknown - Offset
The offset of the block relative to the logical volume. - LV Name
The block device path name of the logical volume
to which the block is allocated.
Display With -l OptionIf
-l
is specified,
pvdisplay
displays "LVM_Disk=yes" if the physical volume specified by
pv_path
is under LVM control. If the physical volume is not
under LVM control, it displays "LVM_Disk=no" instead. The
pvdisplay
command returns 1 if any of the physical volumes specified
are under LVM control; otherwise it returns 0. 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 the status and characteristics of a physical volume:
pvdisplay /dev/dsk/c1t0d0 Display the status, characteristics, and allocation map of a physical volume:
pvdisplay -v /dev/dsk/c2t0d0 Check whether the physical volume belongs to LVM:
pvdisplay -l /dev/dsk/c2t0d0 Check if the physical volume has relocated blocks:
pvdisplay -d /dev/dsk/c2t0d0 |
Printable version
