LVDISPLAY(8)

NAME
lvdisplay - display attributes of a logical volume

SYNOPSIS
lvdisplay [-c|--colon] [-d|--debug] [-D|--disk] [-h|--help] [-v[v]|--verbose] LogicalVolumePath [LogicalVolumePath...]

DESCRIPTION
lvdisplay allows you to see the attributes of a logical volume like size, read/write status, snapshot information etc.

  OPTIONS

-c, --colon
    Generate colon seperated output for easier parsing in scripts or programs.
    The values are:
    * logical volume name
    * volume group name
    * logical volume access
    * logical volume status
    * internal logical volume number
    * open count of logical volume
    * logical volume size in kilobytes
    * current logical extents associated to logical volume
    * allocated logical extents of logical volume
    * allocation policy of logical volume
    * read ahead sectors of logical volume
    * major device number of logical volume
    * minor device number of logical volume

-d, --debug
    Enables additional debugging output (if compiled with DEBUG).

-D, --disk
    Show attributes of the volume group descriptor array on disk(s). Without this switch they are derived from kernel space. Useful, if the volume group isn't active.

-h, --help
    Print a usage message on standard output and exit successfully.

-v, --verbose
    Display the mapping of logical extents to physical volumes and physical extents.

-vv, --verbose --verbose
    Like -v with verbose runtime information.

Examples
"lvdisplay -v /dev/vg00/lvol2" shows attributes of that logical volume and its mapping of logical to physical extents. In case snapshot logical volumes have been created for this original logical volume, this command shows a list of all snapshot logical volumes and their status (active or inactive) as well. "lvdisplay /dev/vg00/snapshot" shows the attributes of this snapshot logical volume and also which original logical volume it is associated with.

DIAGNOSTICS
lvdisplay returns an exit code of 0 for success or > 0 for error:
1  no logical volume name(s) on command line
95 driver/module not in kernel
96 invalid I/O protocol version
97 error locking logical volume manager
98 invalid lvmtab (run vgscan(8))
99 invalid command line

ENVIRONMENT VARIABLES

LVM_VG_NAME
    The default Volume Group Name to use. Setting this variable enables you to enter just the Logical Volume Name rather than its complete path.

See also
lvm(8), lvcreate(8), lvscan(8), lvmsadc(8),
lvmsar(8)

AUTHOR
Heinz Mauelshagen <Linux-LVM@Sistina.com>