pv_path The block device path name of a physical volume.

Transcription

1 NAME pvdisplay - display information about physical volumes in LVM volume groups SYNOPSIS /usr/sbin/pvdisplay [-v] [-d] [-b BlockList ] pv_path... /usr/sbin/pvdisplay -l [-u] pv_path... /usr/sbin/pvdisplay -F [-d] [-v] 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 processed in the order they are listed on the command line. DESCRIPTION The pvdisplay command displays information about each physical volume specified by a pv_path parameter. Options pvdisplay 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 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. -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. -u If pv_path is an LVM disk, display the start and end of the user data in 1KB blocks. -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 Option If 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 HP-UX 11i Version 3: September Hewlett-Packard Company 1

2 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 Current pre-allocated PE Number of pre-allocated physical extents on the physical volume that are allocated to logical volumes. Note that this field is only displayed for volume group version 2.2 and higher. 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. Autoswitch Autoswitch behavior for multiported physical volumes accessed through multiple paths. When set to On (default), LVM is directed to automatically switch to the highest priority (as defined by the order of the paths in the /etc/lvmtab file) link whenever it becomes available. When set to Off, LVM will only switch links under manual instruction or when the current one fails. 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 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. Proactive Polling (See WARNINGS section). LVM s proactive polling of alternate links. When set to On (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 Proactive Polling is 2 Hewlett-Packard Company 2 HP-UX 11i Version 3: September 2010

3 set to Off. Display With -v Option If -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. Unshared LE of LV Number of logical extents within the snapshot logical volume that are unshared on this physical volume. Note that this field is only displayed for volume group version 2.2 and higher and also if the physical volume contains any logical extents associated with the snapshot logical 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, orstale. The state can be pre-allocated for volume group version 2.2 and higher. 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. Note that for the pre-allocated extent, the index will be displayed as NO_LXINDEX. Display With -d Option If -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. Data End The block number (KB) of the last block of 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, if -d is not specified, is as follows: HP-UX 11i Version 3: September Hewlett-Packard Company 3

4 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 -d 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 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 Option If -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 Status Offset LV Name The block number relative to the physical volume. The current status of the block: free, used, structure, spared, or unknown 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 -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. If -u option is specified along with the -l option and the disk specified in pv_path is controlled by LVM, pvdisplay 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, pvdisplay displays Bootable=yes; otherwise, it displays Bootable=no. The format is as follows. LVM_Disk=yes:Data_Start=value:Data_End=value:Bootable=value The pvdisplay command returns 1 if any of the physical volumes specified are under LVM control; otherwise it returns 0. EXTERNAL INFLUENCES Environment Variables LANG 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)). EXAMPLES Display the status and characteristics of a physical volume: 4 Hewlett-Packard Company 4 HP-UX 11i Version 3: September 2010

5 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 WARNINGS The information about the LVM s Proactive Polling 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). HP-UX 11i Version 3: September Hewlett-Packard Company 5

6 (Notes) (Notes) 6 Hewlett-Packard Company 1 HP-UX 11i Version 3: September 2010