lvdisplay(1M) lvdisplay(1M)
NAME [Toc] [Back]
lvdisplay - display information about LVM logical volumes
SYNOPSIS [Toc] [Back]
/usr/sbin/lvdisplay [-k] [-v] lv_path ...
Remarks [Toc] [Back]
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 [Toc] [Back]
The lvdisplay command displays the characteristics and status of each
logical volume specified by lv_path.
Options and Arguments [Toc] [Back]
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 [Toc] [Back]
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 11i Version 2: August 2003
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 [Toc] [Back]
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 11i Version 2: August 2003
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) [Toc] [Back]
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 11i Version 2: August 2003
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) [Toc] [Back]
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 [Toc] [Back]
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 11i Version 2: August 2003
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 [Toc] [Back]
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 [Toc] [Back]
Display information about a logical volume:
Hewlett-Packard Company - 5 - HP-UX 11i Version 2: August 2003
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 [Toc] [Back]
lvchange(1M), lvcreate(1M), lvextend(1M), lvreduce(1M), pvdisplay(1M),
vgdisplay(1M).
Hewlett-Packard Company - 6 - HP-UX 11i Version 2: August 2003 [ Back ] |
