unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 pvdisplay(1M)						       pvdisplay(1M)




 NAME
      pvdisplay - display information about physical volumes within LVM
      volume group

 SYNOPSIS
      /usr/sbin/pvdisplay [-v] [-b BlockList] pv_path ...

 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.

	   -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.

	   -b BlockList
		     For each block in BlockList, display information about
		     the block.	 BlockList is a comma separated list of
		     blocks in DEV_BSIZE units.

    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.




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 pvdisplay(1M)						       pvdisplay(1M)




			       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



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 pvdisplay(1M)						       pvdisplay(1M)




							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 IO timeout used by the disk driver when
			       accessing the physical volume.  A value of
			       default, indicates that the driver default IO
			       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 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



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 pvdisplay(1M)						       pvdisplay(1M)




			       to manually move the data back to the
			       original physical volume (see pvmove(1M))
			       once it has been repaired.

    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

      --- 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,
			       used, 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 -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	       The block number relative to the physical
			       volume.



 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 pvdisplay(1M)						       pvdisplay(1M)




	   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.

 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:

	   pvdisplay /dev/dsk/c1t0d0

      Display the status, characteristics, and allocation map of a physical
      volume:

	   pvdisplay -v /dev/dsk/c2t0d0

 SEE ALSO
      lvdisplay(1M), pvchange(1M), vgdisplay(1M).
























 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000