← Back to branch summary

~ubuntu-branches/debian/sid/lvm2/sid

« back to all changes in this revision

Viewing changes to man/lvs.8.in

  • Committer: Package Import Robot
  • Author(s): Bastian Blank
  • Date: 2014-08-19 15:37:06 UTC
  • mfrom: (1.1.18)
  • Revision ID: package-import@ubuntu.com-20140819153706-i1gaio8lg534dara
Tags: 2.02.109-1
New upstream version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/lvs.8.in
1
1
.TH LVS 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2
2
.SH NAME
3
 
lvs \- report information about logical volumes
 
3
lvs \(em report information about logical volumes
4
4
.SH SYNOPSIS
5
5
.B lvs
6
6
.RB [ \-\-aligned ]
 
7
.RB [ \-\-binary ]
7
8
.RB [ \-a | \-\-all ]
 
9
.RB [ \-\-commandprofile
 
10
.IR ProfileName ]
8
11
.RB [ \-d | \-\-debug ]
9
12
.RB [ \-h | \-? | \-\-help ]
10
13
.RB [ \-\-ignorelockingfailure ]
18
21
.RI [ + | \- ] Key1 [,[ + | \- ] Key2 [,...]]]
19
22
.RB [ \-P | \-\-partial ]
20
23
.RB [ \-\-rows ]
 
24
.RB [ \-S | \-\-select
 
25
.IR Selection ]
21
26
.RB [ \-\-separator
22
27
.IR Separator ]
23
28
.RB [ \-\-segments ]
40
45
.B \-\-aligned
41
46
Use with \fB\-\-separator\fP to align the output columns.
42
47
.TP
 
48
.B \-\-binary
 
49
Use binary values "0" or "1" instead of descriptive literal values
 
50
for columns that have exactly two valid values to report (not counting
 
51
the "unknown" value which denotes that the value could not be determined).
 
52
.TP
43
53
.B \-\-all
44
54
Include information in the output about internal Logical Volumes that
45
55
are components of normally-accessible Logical Volumes, such as mirrors,
46
56
but which are not independently accessible (e.g. not mountable).
47
57
The names of such Logical Volumes are enclosed within square brackets
48
58
in the output.  For example, after creating a mirror using
49
 
.B lvcreate -m1 --mirrorlog disk
 
59
.B lvcreate -m1 \-\-mirrorlog disk
50
60
, this option will reveal three internal Logical
51
61
Volumes, with suffixes mimage_0, mimage_1, and mlog.
52
62
.TP
154
164
.IP 5 3
155
165
State: (a)ctive, (s)uspended, (I)nvalid snapshot, invalid (S)uspended snapshot,
156
166
snapshot (m)erge failed, suspended snapshot (M)erge failed,
157
 
mapped (d)evice present without tables, mapped device present with (i)nactive table
 
167
mapped (d)evice present without tables, mapped device present with (i)nactive table,
 
168
(X) unknown
158
169
.IP 6 3
159
 
device (o)pen
 
170
device (o)pen, (X) unknown
160
171
.IP 7 3
161
172
Target type: (m)irror, (r)aid, (s)napshot, (t)hin, (u)nknown, (v)irtual.
162
173
This groups logical volumes related to the same kernel target together.  So,
168
179
.IP 8 3
169
180
Newly-allocated data blocks are overwritten with blocks of (z)eroes before use.
170
181
.IP 9 3
171
 
Volume Health: (p)artial, (r)efresh needed, (m)ismatches exist, (w)ritemostly.
 
182
Volume Health: (p)artial, (r)efresh needed, (m)ismatches exist, (w)ritemostly,
 
183
(X) unknown.
172
184
(p)artial signifies that one or more of the Physical Volumes this Logical
173
185
Volume uses is missing from the system.  (r)efresh signifies that one or
174
186
more of the Physical Volumes this RAID Logical Volume uses had suffered a
191
203
.B \-\-rows
192
204
Output columns as rows.
193
205
.TP
 
206
.BR  \-S ", " \-\-select " " \fISelection
 
207
Display only rows that match Selection criteria. All rows are displayed with
 
208
the additional "selected" column (\fB-o selected\fP) showing 1 if the row
 
209
matches the Selection and 0 otherwise. The Selection criteria are defined
 
210
by specifying column names and their valid values (that can include reserved
 
211
values) while making use of supported comparison operators. See \fBlvm\fP(8)
 
212
and \fB\-S\fP, \fB\-\-select\fP description for more detailed information
 
213
about constructing the Selection criteria. As a quick help and to see full
 
214
list of column names that can be used in Selection including the list of
 
215
reserved values and the set of supported selection operators, check the
 
216
output of \fBlvs -S help\fP command.
 
217
.TP
194
218
.B \-\-segments
195
219
Use default columns that emphasize segment information.
196
220
.TP