mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
630fcab420
Make it more obvious that either just vg name or lv name or path could be passed as an argument.
127 lines
3.7 KiB
Groff
127 lines
3.7 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 [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ VolumeGroupName | LogicalVolume { Name | Path }
|
|
.RI [ VolumeGroupName | LogicalVolume { Name | Path }\ ...]]
|
|
.br
|
|
|
|
.B lvdisplay
|
|
.BR \-C | \-\-columns
|
|
.RB [ \-\-aligned ]
|
|
.RB [ \-\-binary ]
|
|
.RB [ \-a | \-\-all ]
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.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 [ \-S | \-\-select
|
|
.IR Selection ]
|
|
.RB [ \-\-separator
|
|
.IR Separator ]
|
|
.RB [ \-\-unbuffered ]
|
|
.RB [ \-\-units
|
|
.IR hHbBsSkKmMgGtTpPeE ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-version ]
|
|
.RI [ VolumeGroupName | LogicalVolume { Name | Path }
|
|
.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)
|