lvdisplay

LVDISPLAY(8)                                                      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 logi-
       cal 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>



Heinz Mauelshagen                  LVM TOOLS                      LVDISPLAY(8)