mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
135 lines
3.8 KiB
Groff
135 lines
3.8 KiB
Groff
.TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
lvdisplay \(em display attributes of a logical volume
|
|
.SH SYNOPSIS
|
|
.B lvdisplay
|
|
.RB [ \-a | \-\-all ]
|
|
.RB [ \-c | \-\-colon ]
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-? | \-\-help ]
|
|
.RB [ \-\-ignorelockingfailure ]
|
|
.RB [ \-\-ignoreskippedcluster ]
|
|
.RB [ \-\-maps ]
|
|
.RB [ \-\-nosuffix ]
|
|
.RB [ \-P | \-\-partial ]
|
|
.RB [ \-\-reportformat
|
|
.RB { basic | json }]
|
|
.RB [ \-S | \-\-select
|
|
.IR Selection ]
|
|
.RB [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ VolumeGroupName | LogicalVolume { Name | Path }\ ...]
|
|
.br
|
|
|
|
.B lvdisplay
|
|
.BR \-C | \-\-columns
|
|
.RB [ \-\-aligned ]
|
|
.RB [ \-\-binary ]
|
|
.RB [ \-a | \-\-all ]
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.RB [[ \-\-configreport
|
|
.IR ReportName ]
|
|
.RB [ \-o | \-\-options
|
|
.RI [ + | \- | # ] Field1 [, Field2 ...]
|
|
.RB [ \-O | \-\-sort
|
|
.RI [ + | \- ] Key1 [, Key2 ...]]
|
|
.RB [ \-S | \-\-select
|
|
.IR Selection ]
|
|
.RB ...]
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-? | \-\-help ]
|
|
.RB [ \-\-ignorelockingfailure ]
|
|
.RB [ \-\-ignoreskippedcluster ]
|
|
.RB [ \-\-logonly ]
|
|
.RB [ \-\-noheadings ]
|
|
.RB [ \-\-nosuffix ]
|
|
.RB [ \-P | \-\-partial ]
|
|
.RB [ \-\-reportformat
|
|
.RB { basic | json }]
|
|
.RB [ \-\-segments ]
|
|
.RB [ \-\-separator
|
|
.IR Separator ]
|
|
.RB [ \-\-unbuffered ]
|
|
.RB [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ VolumeGroupName | LogicalVolume { Name | Path }\ ...]
|
|
.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:
|
|
|
|
\(bu logical volume name
|
|
\(bu volume group name
|
|
\(bu logical volume access
|
|
\(bu logical volume status
|
|
\(bu internal logical volume number
|
|
\(bu open count of logical volume
|
|
\(bu logical volume size in sectors
|
|
\(bu current logical extents associated to logical volume
|
|
\(bu allocated logical extents of logical volume
|
|
\(bu allocation policy of logical volume
|
|
\(bu read ahead sectors of logical volume
|
|
\(bu major device number of logical volume
|
|
\(bu 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 vg00/lvol2
|
|
|
|
Shows the attributes of this snapshot logical volume and also which
|
|
original logical volume it is associated with:
|
|
.sp
|
|
.B lvdisplay vg00/snapshot
|
|
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR lvcreate (8),
|
|
.BR lvs (8),
|
|
.BR lvscan (8),
|
|
.BR pvs (8)
|