unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 lvdisplay(1M)						       lvdisplay(1M)




 NAME
      lvdisplay - display information about LVM logical volumes

 SYNOPSIS
      /usr/sbin/lvdisplay [-k] [-v] lv_path  ...

    Remarks
      Mirrored disk information requires the installation of the optional HP
      MirrorDisk/UX software, which is not included in the standard HP-UX
      operating system.

 DESCRIPTION
      The lvdisplay command displays the characteristics and status of each
      logical volume specified by lv_path.

    Options and Arguments
      lvdisplay recognizes the following options and arguments:

	   lv_path   The block device path name of a logical volume, for
		     example, /dev/vg00/lvol1.

	   -v	     For each logical volume, display the physical volume
		     distribution, and the mapping of the logical extents
		     onto the physical extents of the physical volumes.

	   -k	     This option displays the same information as the -v
		     option, except in the column where PV Name is
		     displayed, the pvkey (Physical Volume Number in VG)
		     will be displayed instead.

		     Use this option with the -v option.

    Display Without -v Option
      If you omit the -v option, lvdisplay displays the following
      information for each logical volume:

      --- Logical volumes ---

	   LV Name	       The block device path name of the logical
			       volume.

	   VG Name	       The path name of the volume group.

	   LV Permission       Access permission: read-only or read/write.

	   LV Status	       State of the logical volume:

			       available/stale		Available but
							contains physical
							extents that are not
							current.



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






 lvdisplay(1M)						       lvdisplay(1M)




			       available/syncd		Available and
							synchronized.

			       available		Available but the
							stale or
							synchronized state
							cannot be
							confidently
							determined because
							both Mirror Write
							Cache and Mirror
							Consistency Recovery
							are turned off.

			       unavailable		Not available for
							use.

	   Mirror copies       Number of physical extents beyond the
			       original allocated for each logical extent;
			       i.e., the number of mirrors: 0, 1, or 2.

	   Consistency Recovery
			       Mode of mirror consistency recovery which
			       determines how LVM performs mirror
			       consistency recovery during volume group
			       activation:

			       MWC	 Recover mirror consistency by using
					 the Mirror Write Cache and Mirror
					 Consistency Record.  Implies that
					 Mirror Write Cache is on.

			       NOMWC	 Recover mirror consistency by going
					 through all logical extents and
					 copying data from a non-stale copy
					 to the other mirror copies.
					 Implies that Mirror Write Cache is
					 off.

			       NONE	 No mirror consistency recovery
					 during volume group activation on
					 this logical volume.  Implies that
					 Mirror Write Cache is off.

	   Schedule	       Striped, sequential or parallel scheduling
			       policy.	Striped policy is by default
			       parallel scheduling for mirrored I/O.

	   LV Size (Mbytes)    Size of the logical volume in megabytes (MB).





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






 lvdisplay(1M)						       lvdisplay(1M)




	   Current LE	       Number of logical extents currently in the
			       logical volume.

	   Allocated PE	       Number of physical extents allocated to the
			       logical volume.

	   Stripes	       The number of stripes.  If this field is 0,
			       then the logical volume is not striped.

	   Stripe Size (Kbytes)
			       The size of each stripe in kilobytes (KB).

	   Bad block	       Bad block relocation policy.

	   Allocation	       Current allocation state, displayed as one
			       of:

				    non-strict	   non-strict/contiguous
				    strict	   strict/contiguous
				    PVG-strict	   PVG-strict/contiguous
						   PVG-strict/distributed
						   PVG-strict/partially-
						   distributed

			       contiguous     Physical extents are allocated
					      in an ascending order without
					      any gap between adjacent
					      extents.	All physical extents
					      of a given mirror are
					      contained in a single physical
					      volume.

			       distributed    Distributed allocation is
					      turned on and any two
					      consecutive logical extents
					      are guaranteed to be located
					      on different physical volumes.
					      See lvcreate(1M) for more
					      information.

			       partially-distributed
					      Distributed allocation is
					      turned on but any two
					      consecutive logical extents
					      are NOT guaranteed to be
					      located on different physical
					      volumes.	See lvchange(1M) for
					      more information.

			       non-strict     Physical extents that belong
					      to the same logical extent can



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






 lvdisplay(1M)						       lvdisplay(1M)




					      be allocated on the same
					      physical volume or physical
					      volume group.

			       PVG-strict     Mirror copies for a logical
					      extent are not allocated on
					      the same physical volume
					      group.

			       strict	      Mirror copies for a logical
					      extent are not allocated on
					      the same physical volume.

	   IO Timeout (Seconds)
			       The IO timeout used by LVM for all IO to this
			       logical volume. A value of default, indicates
			       that the system	will use the value of
			       "forever". (Note: the actual duration of a
			       request may exceed this timeout value when
			       the underlying physical volume(s) have
			       timeouts which either exceed this value or
			       are not integer multiples thereof.)

    Display With -v Option
      If you specify the -v option, lvdisplay also lists the distribution of
      each logical volume across the physical volumes of the volume group
      and the mapping of each logical extent of the logical volume on the
      physical extents of the physical volume.

      --- Distribution of logical volume ---

	   The distribution of logical volume lv_path across the physical
	   volumes of the volume group, displayed in the following columns:

	   PV Name	       The block device path name of the physical
			       volume where the logical extents are
			       allocated.

	   PVNUM	       The Physical Volume Number in VG (if -k
			       option is specified).

	   LE on PV	       Number of logical extents allocated on the
			       physical volume.

	   PE on PV	       Number of physical extents allocated on the
			       physical volume.

      --- Logical extents ---

	   The mapping of logical extents onto physical extents, displayed
	   in the following columns:



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






 lvdisplay(1M)						       lvdisplay(1M)




	   LE		       Logical extent number.

	   PV1		       The block device path name of the physical
			       volume that corresponds to the location of
			       the first physical extent of the logical
			       extent.

	   PE1		       First physical extent number allocated to the
			       logical extent.

	   Status 1	       Status of the first physical extent: stale or
			       current.

	   The following columns are displayed for one or two mirror copies:

	   PV2		       The block device path name of the physical
			       volume that corresponds to the location of
			       the second physical extent (first copy) of
			       the logical extent.

	   PE2		       Second physical extent number allocated to
			       the logical extent.

	   Status 2	       Status of the second physical extent: stale
			       or current.

	   The following columns are displayed for two mirror copies:

	   PV3		       The block device path name of the physical
			       volume that corresponds to the location of
			       the third physical extent (second copy) of
			       the logical extent.

	   PE3		       Third physical extent number allocated to the
			       logical extent.

	   Status 3	       Status of the third physical extent: stale or
			       current.

 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 information about a logical volume:




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






 lvdisplay(1M)						       lvdisplay(1M)




	   lvdisplay /dev/vg01/lvol3

      Display all the available information about a logical volume,
      including the characteristics, status and distribution map:

	   lvdisplay -v /dev/vg01/lvol3

      Display all the available information about a logical volume, but
      display pvkey instead of PV Name in the status and distribution map.

	   lvdisplay -v -k /dev/vg01/lvol3

 SEE ALSO
      lvchange(1M), lvcreate(1M), lvextend(1M), lvreduce(1M), pvdisplay(1M),
      vgdisplay(1M).







































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