NAME

lvdisplay − display information about LVM logical volumes

SYNOPSIS

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

Remarks

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

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

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

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. 

non-strict Physical extents that belong to the same logical extent can 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. 

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:

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:

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  —  HP-UX Release 10.20:  July 1996