mirror of
git://sourceware.org/git/lvm2.git
synced 2025-01-03 05:18:29 +03:00
da545ce3b4
The --binary option, if used, causes all the binary values reported in reporting commands to be displayed as "0" or "1" instead of descriptive literal values (value "unknown" is still used for values that could not be determined). Also, add report/binary_values_as_numeric lvm.conf option with the same functionality as the --binary option (the --binary option prevails if both --binary cmd option and report/binary_values_as_numeric lvm.conf option is used at the same time). The report/binary_values_as_numeric is also profilable. This makes it easier to use and check lvm reporting command output in scripts.
127 lines
3.6 KiB
Groff
127 lines
3.6 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 [ LogicalVolumePath
|
|
.RI [ LogicalVolumePath ...]]
|
|
.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 [ 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:
|
|
|
|
\(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 /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)
|