man/lvdisplay.8.in

   1 .TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 lvdisplay \- display attributes of a logical volume
   4 .SH SYNOPSIS
   5 .B lvdisplay
   6 [\-a|\-\-all]
   7 [\-c|\-\-colon] [\-d|\-\-debug] [\-h|\-?|\-\-help]
   8 [\-\-ignorelockingfailure]
   9 [\-\-maps]
  10 [\-\-nosuffix]
  11 [\-P|\-\-partial]
  12 [\-\-units hHbBsSkKmMgGtTpPeE]
  13 [\-v|\-\-verbose]
  14 [\-\-version] [LogicalVolumePath [LogicalVolumePath...]]
  15 .br
  16
  17 .br
  18 .B lvdisplay \-\-columns | \-C
  19 [\-\-aligned]
  20 [\-a|\-\-all]
  21 [\-d|\-\-debug] [\-h|\-?|\-\-help]
  22 [\-\-ignorelockingfailure]
  23 [\-\-noheadings]
  24 [\-\-nosuffix]
  25 [\-o|\-\-options [+]Field[,Field]]
  26 [\-O|\-\-sort [+|-]Key1[,[+|-]Key2[,...]]]
  27 [\-P|\-\-partial]
  28 [\-\-segments]
  29 [\-\-separator Separator]
  30 [\-\-unbuffered]
  31 [\-\-units hHbBsSkKmMgGtTpPeE]
  32 [\-v|\-\-verbose]
  33 [\-\-version] [LogicalVolumePath [LogicalVolumePath...]]
  34 .SH DESCRIPTION
  35 lvdisplay allows you to see the attributes of a logical volume
  36 like size, read/write status, snapshot information etc.
  37 .P
  38 \fBlvs\fP (8) is an alternative that provides the same information
  39 in the style of \fBps\fP (1).  \fBlvs\fP is recommended over
  40 \fBlvdisplay\fP.
  41
  42 .SH OPTIONS
  43 See \fBlvm\fP for common options and \fBlvs\fP for options given with
  44 \fB\-\-columns\fP.
  45 .TP
  46 .I \-\-all
  47 Include information in the output about internal Logical Volumes that
  48 are components of normally-accessible Logical Volumes, such as mirrors,
  49 but which are not independently accessible (e.g. not mountable).
  50 For example, after creating a mirror using 'lvcreate -m1 --mirrorlog disk',
  51 this option will reveal three internal Logical Volumes, with suffixes
  52 mimage_0, mimage_1, and mlog.
  53 .TP
  54 .I \-c, \-\-colon
  55 Generate colon separated output for easier parsing in scripts or programs.
  56 N.B. \fBlvs\fP (8) provides considerably more control over the output.
  57 .nf
  58
  59 The values are:
  60
  61 * logical volume name
  62 * volume group name
  63 * logical volume access
  64 * logical volume status
  65 * internal logical volume number
  66 * open count of logical volume
  67 * logical volume size in sectors
  68 * current logical extents associated to logical volume
  69 * allocated logical extents of logical volume
  70 * allocation policy of logical volume
  71 * read ahead sectors of logical volume
  72 * major device number of logical volume
  73 * minor device number of logical volume
  74
  75 .fi
  76 .TP
  77 .I \-m, \-\-maps
  78 Display the mapping of logical extents to physical volumes and
  79 physical extents.  To map physical extents
  80 to logical extents use
  81 .BR
  82 \fBpvs --segments -o+lv_name,seg_start_pe,segtype\fP.
  83 .TP
  84 .I \-\-columns | \-C
  85 Display output in columns, the equivalent of \fBlvs\fP.  Options listed
  86 are the same as options given in \fBlvs (8)\fP.
  87 .SH Examples
  88 "lvdisplay -v /dev/vg00/lvol2" shows attributes of that logical volume.
  89 If snapshot
  90 logical volumes have been created for this original logical volume,
  91 this command shows a list of all snapshot logical volumes and their
  92 status (active or inactive) as well.
  93
  94 "lvdisplay /dev/vg00/snapshot" shows the attributes of this snapshot
  95 logical volume and also which original logical volume
  96 it is associated with.
  97
  98 .SH SEE ALSO
  99 .BR lvm (8),
 100 .BR lvcreate (8),
 101 .BR lvscan (8),
 102 .BR pvs (8)