pvdisplay(1M) pvdisplay(1M)
NAME
pvdisplay - display information about physical volumes in LVM volume groups
SYNOPSIS
BlockList] pv_path ...
pv_path ...
pv_path ...
Remarks
If physical volume input arguments belonging to a combination of volume groups version 1.0 and 2.0 or higher, the arguments may not be pro-
cessed in the order they are listed on the command line.
DESCRIPTION
The command displays information about each physical volume specified by a pv_path parameter.
Options
recognizes the following options:
pv_path The block device path name of a physical volume.
For each block in
BlockList, display information about the block. BlockList is a comma separated list of blocks in units.
For each physical volume,
display the offset to the start and end of the user data in 1KB 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.
Produce a compact listing of fields described in
The output is a list of colon separated fields formatted as value...].
Check whether pv_path refers to a disk device under HP Logical Volume Manager (LVM) control.
If pv_path is an LVM disk, display the start and end of the user data in 1KB blocks.
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 Option
If you omit the option, displays the characteristics of each physical volume specified by pv_path:
The block device path name of the physical volume
The path name of the volume group
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 physical 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, its 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 in unavailable.
The physical volume is a spare, "standing by" that is not currently available
to capture data from a failed physical volume.
Allocation permission for the physical volume
Number of volume group descriptors on the physical volume
Number of logical volumes using the physical volume
Size of physical extents on the volume, in megabytes (MB)
Total number of physical extents on the physical volume
Number of free physical extents on the physical volume
Number of physical extents on the physical volume
that are allocated to logical volumes
Number of physical extents on the physical volume that are not current
The I/O timeout used by the disk driver when accessing the physical volume.
A value of indicates that the driver default I/O timeout is being used.
Autoswitch behavior for multiported physical volumes accessed through
multiple paths. When set to (default), LVM is directed to automatically switch to the highest priority (as defined by the
order of the paths in the file) link whenever it becomes available. When set to LVM will only switch links under manual
instruction or when the current one fails.
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 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 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.
(See section). LVM's proactive polling of alternate links. When set to (default), LVM will periodically test alternate links and
help to identify faulty paths before user I/O is affected. No periodic testing of alternate paths will be performed when is
set to
Display With -v Option
If is specified, lists additional information for each logical volume and for each physical extent on the physical volume:
The logical volumes that have extents allocated on
pv_path, displayed in column format:
The block device path name of the logical volume which has extents allocated on pv_path.
Number of logical extents within the logical volume
that are contained on this physical volume
Number of physical extents within the logical volume
that are contained on this physical volume
The following information for each physical extent,
displayed in column format:
Physical extent number
Current state of the physical extent:
or
The block device path name of the logical volume
to which the extent is allocated
Index of the logical extent to which the physical extent is allocated
Display With -d Option
If is specified, displays the following additional details for each physical volume:
Starting block number (KB) of the user data.
Displays unavailable if the PV is unavailable.
The block number (KB) of the last block of user data.
Displays unavailable if the PV is unavailable.
Specify if the
pv_path is a bootable physical volume.
PV was setup as a bootable physical volume using
pvcreate.
Physical volume is not a bootable physical volume.
Physical volume is unavailable.
Display the number of bad blocks that were relocated.
Displays unavailable if the PV is unavailable.
Compact Listing (-F Option)
The option generates a compact and parsable listing of the command output 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, if
is not specified, 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:proactive_polling=value
The format of Line 1, if is specified, 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::data_start=value:
data_end=value:boot_disk=value:relocated_blocks=value:
proactive_polling=value
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.
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 Option
If is specified, lists additional information for each block specified in BlockList.
The use of blocks on
pv_path, displayed in column format:
The block number relative to the physical volume.
The current status of the block:
or
The offset of the block relative to the logical volume.
The block device path name of the logical volume
to which the block is allocated.
Display With -l Option
If is specified, 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.
If option is specified along with the option and the disk specified in pv_path is controlled by LVM, displays the starting and ending block
number of the user data on the disk in 1KB blocks. If the pv_path is a bootable physical volume, displays otherwise, it displays The for-
mat is as follows.
The command returns 1 if any of the physical volumes specified are under LVM control; otherwise it returns 0.
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 the status and characteristics of a physical volume:
Display the status, characteristics, and allocation map of a physical volume:
Check whether the physical volume belongs to LVM:
Check if the physical volume has relocated blocks:
WARNINGS
The information about the LVM's for alternate links of a physical volume will be displayed only if the kernel has been updated to support
this functionality.
SEE ALSO
lvdisplay(1M), pvchange(1M), pvcreate(1M), vgdisplay(1M), intro(7), lvm(7).
pvdisplay(1M)