lvdisplay(1M)lvdisplay(1M)NAMElvdisplay - 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 pro‐
cessed 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 format‐
ted as value...].
For each logical volume,
display the physical volume distribution, and the map‐
ping 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 qui‐
esced, 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 Mir‐
ror 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 fol‐
lowing 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 vol‐
ume.
Number of physical extents allocated to the logical vol‐
ume.
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:
Phys‐
i‐
cal
extents
are
allo‐
cated
in
an
ascend‐
ing
order
with‐
out
any
gap
between
adja‐
cent
extents.
All
phys‐
i‐
cal
extents
of
a
given
mir‐
ror
are
con‐
tained
in
a
sin‐
gle
phys‐
i‐
cal
vol‐
ume.
Dis‐
trib‐
uted
allo‐
ca‐
tion
is
turned
on
and any
two
con‐
sec‐
u‐
tive
log‐
i‐
cal
extents
are
guar‐
an‐
teed
to
be
located
on
dif‐
fer‐
ent
phys‐
i‐
cal
vol‐
umes.
See
lvcre‐
ate(1M)
for
more
infor‐
ma‐
tion.
Dis‐
trib‐
uted
allo‐
ca‐
tion
is
turned
on
but any
two
con‐
sec‐
u‐
tive
log‐
i‐
cal
extents
are
NOT
guar‐
an‐
teed
to
be
located
on
dif‐
fer‐
ent
phys‐
i‐
cal
vol‐
umes.
See
lvchange(1M)
for
more
infor‐
ma‐
tion.
Phys‐
i‐
cal
extents
that
belong
to
the
same
log‐
i‐
cal
extent
can
be
allo‐
cated
on
the
same
phys‐
i‐
cal
vol‐
ume
or
phys‐
i‐
cal
vol‐
ume
group.
Mir‐
ror
copies
for
a
log‐
i‐
cal
extent are
not
allo‐
cated
on
the
same
phys‐
i‐
cal
vol‐
ume
group.
Mir‐
ror
copies
for
a
log‐
i‐
cal
extent are
not
allo‐
cated
on
the
same
phys‐
i‐
cal
vol‐
ume.
The IO timeout used by
LVM for all IO to this
logical volume. A value
of
default,
indi‐
cates
that
the
sys‐
tem
will
use
the
value
of
"for‐
ever".
(Note:
the
actual
dura‐
tion
of
a
request
may
exceed
this
time‐
out
value
when
the
under‐
ly‐
ing
phys‐
i‐
cal
vol‐
ume(s)
have
time‐
outs
which
either
exceed
this
value
or
are
not
inte‐
ger
mul‐
ti‐
ples
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 mapping of each
logical extent of the logical
volume on the physical extents
of the physical volume.
The distribution
of logical vol‐
ume
lv_path across the
physical volumes of the
volume group, displayed
in the following col‐
umns:
The block device path
name of the physical
volume
where
the
log‐
i‐
cal
extents
are
allo‐
cated.
The Physical Volume
Number in VG (if
option
is
spec‐
i‐
fied).
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 fol‐
lowing columns:
Logical extent number.
The block device path
name of the physical
volume
that
cor‐
re‐
sponds
to
the
loca‐
tion
of
the
first
phys‐
i‐
cal
extent
of
the
log‐
i‐
cal
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
cor‐
re‐
sponds
to
the
loca‐
tion
of
the
sec‐
ond
phys‐
i‐
cal
extent
(first
copy)
of
the
log‐
i‐
cal
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
cor‐
re‐
sponds
to
the
loca‐
tion
of
the
third
phys‐
i‐
cal
extent
(sec‐
ond
copy)
of
the
log‐
i‐
cal
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 (appli‐
cable for logical vol‐
umes created within
volume groups versions
2.0 or higher only),
then a second line of
physical extent(s) is
displayed for the logi‐
cal extent. The rest
of the line contains
the following columns:
The following columns
are displayed if there
are at least three mir‐
ror copies:
Logical extent number.
The block device path
name of the physical
volume that corresponds
to
the
loca‐
tion
of
the
fourth
phys‐
i‐
cal
extent(third
copy)
of
the
log‐
i‐
cal
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 mir‐
ror copies:
The block device path
name of the physical
volume that corresponds
to
the
loca‐
tion
of
the
fifth
phys‐
i‐
cal
extent
(fourth
copy)
of
the
log‐
i‐
cal
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
loca‐
tion
of
the
sixth
phys‐
i‐
cal
extent(fifth
copy)of
the
log‐
i‐
cal
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 sepa‐
rated fields formatted as
value...]. The option is
designed to be used by
scripts. The resulting com‐
mand 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_per‐
mission=value:lv_sta‐
tus=value: mir‐
ror_copies=value:con‐
sistency_recov‐
ery=value:sched‐
ule=value:
lv_size=value:cur‐
rent_le=value:allo‐
cated_pe=value:stripes=value:
stripe_size=value:bad_block=value:allo‐
ca‐
tion=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:sta‐
tus_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 internationaliza‐
tion 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 charac‐
teristics, status and distri‐
bution map:
Display all the available
information about a logical
volume, but display instead of
in the status and distribution
map.
SEE ALSOlvchange(1M), lvcreate(1M),
lvextend(1M), lvmadm(1M),
lvreduce(1M), lvm(7), pvdis‐
play(1M), vgdisplay(1M).
lvdisplay(1M)