pvdisplay(1M)pvdisplay(1M)NAMEpvdisplay - 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 phys‐
ical 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 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, 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 phys‐
ical 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 when‐
ever 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 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 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 alter‐
nate 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 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, 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 speci‐
fied 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 format 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 vol‐
ume will be displayed only if the kernel has been updated to support
this functionality.
SEE ALSOlvdisplay(1M), pvchange(1M), pvcreate(1M), vgdisplay(1M), intro(7),
lvm(7).
pvdisplay(1M)
