NAME
lvdisplay — display information about LVM logical volumes
SYNOPSIS
/usr/sbin/lvdisplay
[-F]
[-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.
- -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...].
- -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
The access permission and quiesce mode:
The access permission is either:
read-only
or
read/write.
If the VG containing the LV is quiesced,
the quiesce mode is displayed on the same line.
The quiesce mode is either:
read/write-quiesced
or
write-quiesced.
- LV Status
State of the logical volume:
- available/stale
Available but contains physical extents that are not current.
- available/syncd
Available with no stale extents.
- 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 following a system crash.
The user of the
logical volume is responsible for ensuring mirror consistency.
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
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 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:
- 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.
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
lvdisplay
command, the lines format is:
- LINE 1
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
- LINE 2
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.
- LINE n
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
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
Printable version
