Manpages

Manpage of LVDISPLAY

LVDISPLAY

Section: Maintenance Commands (8)
Updated: LVM TOOLS
Index
Return to Main Contents
 

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>


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
Examples
DIAGNOSTICS
ENVIRONMENT VARIABLES
See also
AUTHOR

This document was created by man2html, using the manual pages.
Time: 01:52:35 GMT, March 05, 2024