LVDISPLAY(8)						      System Manager's Manual						      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 com-
	      plete path.

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

AUTHOR

       Heinz Mauelshagen <Linux-LVM@Sistina.com>

Heinz Mauelshagen						     LVM TOOLS							      LVDISPLAY(8)