lvdisplay(1M)															     lvdisplay(1M)

NAME

       lvdisplay - display information about LVM logical volumes

SYNOPSIS

       lv_path ...

   Remarks
       If  the	logical  volume  input arguments belong to a combination of volume groups versions 1.0 and 2.0 or higher, the arguments may not be
       processed in the order they are listed on the command line.

       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 command displays the characteristics and status of each logical volume specified by lv_path.

   Options and Arguments
       recognizes the following options and arguments:

	      lv_path	The block device path name of a logical volume, for example,

	      Produce a compact listing of fields described in
			The output is a list of colon separated fields formatted as value...].

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

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

			Use this option with the option.

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

	      The block device path name of the logical volume.

	      The path name of the volume group.

	      The access permission and quiesce mode:
				  The access permission is either: or If the VG containing the LV is quiesced, the quiesce mode  is  displayed	on
				  the same line.  The quiesce mode is either: or

	      State of the logical volume:
				  Available but contains physical extents that are not current.

				  Available with no stale extents.

				  Not available for use.

	      Number of mirror copies.

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

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

				  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.

				  No mirror consistency recovery during volume group activation
					    on this logical volume following a system crash.  The user of the logical volume  is  responsible  for
					    ensuring mirror consistency.  Implies that Mirror Write Cache is off.

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

	      Size of the logical volume in megabytes (MB).

	      Number of logical extents currently in the logical volume.

	      Number of physical extents allocated to the logical volume.

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

	      The size of each stripe in kilobytes (KB).

	      Bad block relocation policy.

	      Current allocation state, displayed as one of:
								    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 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.

				  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.

				  Physical extents
					 that belong to the same logical extent can be allocated on the same physical volume  or  physical  volume
					 group.

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

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

	      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 option, also lists the distribution of each logical volume across the physical volumes of the volume group and the map-
       ping of each logical extent of the logical volume on the physical extents of the physical volume.

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

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

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

	      Number of logical extents allocated on the physical volume.

	      Number of physical extents allocated on the physical volume.

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

	      Logical extent number.

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

	      First physical extent number allocated to the logical extent.

	      Status of the first physical extent:
				  or

	      The following columns are displayed if there is at least one mirror copy:

	      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.

	      Second physical extent number allocated to the logical extent.

	      Status of the second physical extent:
				  or

	      The following columns are displayed if there are at least two mirror copies:

	      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.

	      Third physical extent number allocated to the logical extent.

	      Status of the third physical extent:
				  or

	      If there are more than 3 physical extents associated with one logical extent (applicable for logical volumes created  within  volume
	      groups  versions 2.0 or higher only), then a second line of physical extent(s) is displayed for the logical extent.  The rest of the
	      line contains the following columns:

	      The following columns are displayed if there are at least three mirror copies:

	      Logical extent number.

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

	      Fourth physical extent number allocated to the logical extent.

	      Status of the fourth physical extent:
				  or

	      The following columns are displayed if there are at least four mirror copies:

	      The block device path name of the physical volume that corresponds
				  to the location of the fifth physical extent (fourth copy) of the logical extent.

	      Fifth physical extent number allocated to the logical extent.

	      Status of the fifth physical extent:
				  or

	      The following columns are displayed if there are five mirror copies:

	      The block device path name of the physical volume that corresponds to
				  the location of the sixth physical extent(fifth copy)of the logical extent.

	      Sixth physical extent number allocated to the logical extent.

	      Status of the sixth physical extent:
				  or

   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 is as follows:

	      lv_name=value:vg_name=value:lv_permission=value:lv_status=value:	    mirror_copies=value:consistency_recovery=value:schedule=value:
	      lv_size=value:current_le=value:allocated_pe=value:stripes=value:	 stripe_size=value:bad_block=value:allocation=value:used_pv=value:
	      io_timeout=value

       The format of Line 2 is as follows:

	      pv_name=value:le_on_pv=value:pe_on_pv=value

       The above line may be repeated with different values.

       The format of Line
	      n is as follows:

	      le=value:pv1=value:pe1=value:status_1=value[:...:pvN=value:peN=value: status_N=value]

       The above line may be repeated with different values.

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

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

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

SEE ALSO

       lvchange(1M), lvcreate(1M), lvextend(1M), lvmadm(1M), lvreduce(1M), lvm(7), pvdisplay(1M), vgdisplay(1M).

																     lvdisplay(1M)