external/gpl2/lvm2/dist/man/lvdisplay.8

   1 .\"    $NetBSD$
   2 .\"
   3 .TH LVDISPLAY 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Sistina Software UK" \" -*- nroff -*-
   4 .SH NAME
   5 lvdisplay \- display attributes of a logical volume
   6 .SH SYNOPSIS
   7 .B lvdisplay
   8 [\-c|\-\-colon] [\-d|\-\-debug] [\-h|\-?|\-\-help]
   9 [\-\-ignorelockingfailure]
  10 [\-\-maps] [\-P|\-\-partial]
  11 [\-v|\-\-verbose] LogicalVolumePath [LogicalVolumePath...]
  12 .SH DESCRIPTION
  13 lvdisplay allows you to see the attributes of a logical volume
  14 like size, read/write status, snapshot information etc.
  15 .P
  16 \fBlvs\fP (8) is an alternative that provides the same information
  17 in the style of \fBps\fP (1).  \fBlvs\fP is recommended over
  18 \fBlvdisplay\fP.
  19
  20 .SH OPTIONS
  21 See \fBlvm\fP for common options.
  22 .TP
  23 .I \-c, \-\-colon
  24 Generate colon separated output for easier parsing in scripts or programs.
  25 N.B. \fBlvs\fP (8) provides considerably more control over the output.
  26 .nf
  27
  28 The values are:
  29
  30 * logical volume name
  31 * volume group name
  32 * logical volume access
  33 * logical volume status
  34 * internal logical volume number
  35 * open count of logical volume
  36 * logical volume size in sectors
  37 * current logical extents associated to logical volume
  38 * allocated logical extents of logical volume
  39 * allocation policy of logical volume
  40 * read ahead sectors of logical volume
  41 * major device number of logical volume
  42 * minor device number of logical volume
  43
  44 .fi
  45 .TP
  46 .I \-m, \-\-maps
  47 Display the mapping of logical extents to physical volumes and
  48 physical extents.
  49 .SH Examples
  50 "lvdisplay -v /dev/vg00/lvol2" shows attributes of that logical volume.
  51 If snapshot
  52 logical volumes have been created for this original logical volume,
  53 this command shows a list of all snapshot logical volumes and their
  54 status (active or inactive) as well.
  55
  56 "lvdisplay /dev/vg00/snapshot" shows the attributes of this snapshot
  57 logical volume and also which original logical volume
  58 it is associated with.
  59
  60 .SH SEE ALSO
  61 .BR lvm (8),
  62 .BR lvcreate (8),
  63 .BR lvscan (8)