mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
31d68b7124
Sort order for -C|--columns as with other options, and use short capital name as the first (as with other options). Also drop multiple reference for pvs/lvs/vgs, since now the text for -C is really close to referrence of lvm anyway.
120 lines
3.4 KiB
Groff
120 lines
3.4 KiB
Groff
.TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvdisplay \- display attributes of a logical volume
|
|
.SH SYNOPSIS
|
|
.B lvdisplay
|
|
.RB [ \-a | \-\-all ]
|
|
.RB [ \-c | \-\-colon ]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-? | \-\-help ]
|
|
.RB [ \-\-ignorelockingfailure ]
|
|
.RB [ \-\-ignoreskippedcluster ]
|
|
.RB [ \-\-maps ]
|
|
.RB [ \-\-nosuffix ]
|
|
.RB [ \-P | \-\-partial ]
|
|
.RB [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ LogicalVolumePath
|
|
.RI [ LogicalVolumePath ...]]
|
|
.br
|
|
|
|
.B lvdisplay
|
|
.BR \-C | \-\-columns
|
|
.RB [ \-\-aligned ]
|
|
.RB [ \-a | \-\-all ]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-? | \-\-help ]
|
|
.RB [ \-\-ignorelockingfailure ]
|
|
.RB [ \-\-ignoreskippedcluster ]
|
|
.RB [ \-\-noheadings ]
|
|
.RB [ \-\-nosuffix ]
|
|
.RB [ \-o | \-\-options
|
|
.RI [ + ] Field [ ,Field ...]]
|
|
.RB [ \-O | \-\-sort
|
|
.RI [ + | - ] Key1 [ , [ + | - ] Key2 ...]]
|
|
.RB [ \-P | \-\-partial ]
|
|
.RB [ \-\-segments ]
|
|
.RB [ \-\-separator
|
|
.IR Separator ]
|
|
.RB [ \-\-unbuffered ]
|
|
.RB [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ LogicalVolumePath
|
|
.RI [ LogicalVolumePath ...]]
|
|
.SH DESCRIPTION
|
|
lvdisplay allows you to see the attributes of a logical volume
|
|
like size, read/write status, snapshot information etc.
|
|
.P
|
|
\fBlvs\fP(8) is an alternative that provides the same information
|
|
in the style of \fBps\fP(1).
|
|
\fBlvs\fP(8) is recommended over \fBlvdisplay\fP.
|
|
|
|
.SH OPTIONS
|
|
See \fBlvm\fP(8) for common options and \fBlvs\fP for options given with
|
|
\fB\-\-columns\fP.
|
|
.TP
|
|
.B \-\-all
|
|
Include information in the output about internal Logical Volumes that
|
|
are components of normally-accessible Logical Volumes, such as mirrors,
|
|
but which are not independently accessible (e.g. not mountable).
|
|
For example, after creating a mirror using
|
|
\fBlvcreate \-m1 \-\-mirrorlog disk\fP,
|
|
this option will reveal three internal Logical Volumes, with suffixes
|
|
mimage_0, mimage_1, and mlog.
|
|
.TP
|
|
.BR \-C ", " \-\-columns
|
|
Display output in columns, the equivalent of \fBlvs\fP(8).
|
|
Options listed are the same as options given in \fBlvs\fP(8).
|
|
.TP
|
|
.BR \-c ", " \-\-colon
|
|
Generate colon separated output for easier parsing in scripts or programs.
|
|
N.B. \fBlvs\fP(8) provides considerably more control over the output.
|
|
.nf
|
|
|
|
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 sectors
|
|
* 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
|
|
|
|
.fi
|
|
.TP
|
|
.BR \-m ", " \-\-maps
|
|
Display the mapping of logical extents to physical volumes and
|
|
physical extents. To map physical extents
|
|
to logical extents use:
|
|
.B pvs \-\-segments \-o+lv_name,seg_start_pe,segtype
|
|
.SH Examples
|
|
Shows attributes of that logical volume. If 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:
|
|
.sp
|
|
.B lvdisplay \-v /dev/vg00/lvol2
|
|
|
|
Shows the attributes of this snapshot logical volume and also which
|
|
original logical volume it is associated with:
|
|
.sp
|
|
.B lvdisplay /dev/vg00/snapshot
|
|
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR lvcreate (8),
|
|
.BR lvs (8),
|
|
.BR lvscan (8),
|
|
.BR pvs (8)
|