]>
Commit | Line | Data |
---|---|---|
5951ef33 | 1 | .TH LVS 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*- |
4c64ed4c AK |
2 | .SH NAME |
3 | lvs \- report information about logical volumes | |
4 | .SH SYNOPSIS | |
5 | .B lvs | |
65b977f2 | 6 | .RB [ \-\-aligned ] |
a326be8f | 7 | .RB [ \-a | \-\-all ] |
65b977f2 ZK |
8 | .RB [ \-d | \-\-debug ] |
9 | .RB [ \-h | \-? | \-\-help ] | |
10 | .RB [ \-\-ignorelockingfailure ] | |
11 | .RB [ \-\-nameprefixes ] | |
12 | .RB [ \-\-noheadings ] | |
13 | .RB [ \-\-nosuffix ] | |
14 | .RB [ \-o | \-\-options | |
15 | .RI [ + ] Field [, Field ]] | |
16 | .RB [ \-O | \-\-sort | |
c63b155d | 17 | .RI [ + | \- ] Key1 [,[ + | \- ] Key2 [,...]]] |
65b977f2 ZK |
18 | .RB [ \-P | \-\-partial ] |
19 | .RB [ \-\-rows ] | |
65b977f2 ZK |
20 | .RB [ \-\-separator |
21 | .IR Separator ] | |
a326be8f | 22 | .RB [ \-\-segments ] |
65b977f2 ZK |
23 | .RB [ \-\-unbuffered ] |
24 | .RB [ \-\-units | |
25 | .IR hHbBsSkKmMgGtTpPeE ] | |
26 | .RB [ \-\-unquoted ] | |
27 | .RB [ \-v | \-\-verbose ] | |
28 | .RB [ \-\-version ] | |
29 | .RI [ VolumeGroupName | |
30 | .RI [ VolumeGroupName ...]] | |
31 | ||
4c64ed4c | 32 | .SH DESCRIPTION |
d6cf4325 | 33 | lvs produces formatted output about logical volumes. |
4c64ed4c | 34 | .SH OPTIONS |
65b977f2 ZK |
35 | See |
36 | .BR lvm (8) | |
37 | for common options. | |
4c64ed4c | 38 | .TP |
a326be8f ZK |
39 | .B \-\-aligned |
40 | Use with \fB\-\-separator\fP to align the output columns. | |
41 | .TP | |
65b977f2 | 42 | .B \-\-all |
7c638cc2 DW |
43 | Include information in the output about internal Logical Volumes that |
44 | are components of normally-accessible Logical Volumes, such as mirrors, | |
45 | but which are not independently accessible (e.g. not mountable). | |
46 | The names of such Logical Volumes are enclosed within square brackets | |
c63b155d ZK |
47 | in the output. For example, after creating a mirror using |
48 | .B lvcreate -m1 --mirrorlog disk | |
49 | , this option will reveal three internal Logical | |
7c638cc2 DW |
50 | Volumes, with suffixes mimage_0, mimage_1, and mlog. |
51 | .TP | |
65b977f2 | 52 | .B \-\-nameprefixes |
583ee601 | 53 | Add an "LVM2_" prefix plus the field name to the output. Useful |
c63b155d ZK |
54 | with \fB\-\-noheadings\fP to produce a list of field=value pairs that can |
55 | be used to set environment variables (for example, in | |
65b977f2 ZK |
56 | .BR udev (7) |
57 | rules). | |
583ee601 | 58 | .TP |
65b977f2 | 59 | .B \-\-noheadings |
4c64ed4c AK |
60 | Suppress the headings line that is normally the first line of output. |
61 | Useful if grepping the output. | |
62 | .TP | |
65b977f2 | 63 | .B \-\-nosuffix |
c63b155d ZK |
64 | Suppress the suffix on output sizes. Use with \fB\-\-units\fP |
65 | (except h and H) if processing the output. | |
4c64ed4c | 66 | .TP |
65b977f2 | 67 | .BR \-o ", " \-\-options |
a326be8f ZK |
68 | Comma-separated ordered list of columns. Precede the list with '\fI+\fP' |
69 | to append to the default selection of columns instead of replacing it. | |
01b988cf | 70 | .IP |
c63b155d ZK |
71 | Use \fB\-o lv_all\fP to select all logical volume columns, |
72 | and \fB\-o seg_all\fP | |
476d4633 | 73 | to select all logical volume segment columns. |
01b988cf | 74 | .IP |
c63b155d | 75 | Use \fB\-o help\fP to view the full list of columns available. |
01b988cf DW |
76 | .IP |
77 | Column names include: | |
a8f352fd ZK |
78 | chunk_size, |
79 | convert_lv, | |
80 | copy_percent, | |
81 | data_lv, | |
82 | devices, | |
83 | lv_attr, | |
84 | lv_host, | |
85 | lv_kernel_major, | |
86 | lv_kernel_minor, | |
87 | lv_kernel_read_ahead, | |
88 | lv_major, | |
89 | lv_minor, | |
90 | lv_name, | |
91 | lv_path, | |
92 | lv_read_ahead, | |
93 | lv_size, | |
94 | lv_tags, | |
95 | lv_time, | |
96 | lv_uuid, | |
97 | metadata_lv, | |
98 | mirror_log, | |
99 | modules, | |
100 | move_pv, | |
101 | origin, | |
102 | origin_size, | |
103 | pool_lv, | |
104 | region_size, | |
105 | segtype, | |
106 | seg_count, | |
107 | seg_pe_ranges, | |
108 | seg_size, | |
109 | seg_start, | |
110 | seg_start_pe, | |
111 | seg_tags, | |
112 | snap_percent, | |
113 | stripes, | |
114 | stripe_size, | |
115 | thin_count, | |
116 | transaction_id, | |
117 | zero. | |
d6cf4325 | 118 | .IP |
c63b155d ZK |
119 | With \fB\-\-segments\fP, any "seg_" prefixes are optional; |
120 | otherwise any "lv_" prefixes are optional. Columns mentioned in | |
65b977f2 | 121 | .BR vgs (8) |
d6cf4325 AK |
122 | can also be chosen. |
123 | .IP | |
c63b155d | 124 | The lv_attr bits are: |
d6cf4325 AK |
125 | .RS |
126 | .IP 1 3 | |
3b6a076e | 127 | Volume type: (m)irrored, (M)irrored without initial sync, (o)rigin, |
d36644c2 JEB |
128 | (O)rigin with merging snapshot, (r)aid, (R)aid without initial sync, |
129 | (s)napshot, merging (S)napshot, (p)vmove, (v)irtual, | |
130 | mirror or raid (i)mage, mirror or raid (I)mage out-of-sync, mirror (l)og device, | |
131 | under (c)onversion, thin (V)olume, (t)hin pool, (T)hin pool data, raid or | |
132 | thin pool m(e)tadata | |
d6cf4325 | 133 | .IP 2 3 |
8f95d94b AK |
134 | Permissions: (w)riteable, (r)ead-only, (R)ead-only activation of non-read-only |
135 | volume | |
d6cf4325 | 136 | .IP 3 3 |
a326be8f | 137 | Allocation policy: (a)nywhere, (c)ontiguous, (i)nherited, c(l)ing, (n)ormal |
d6cf4325 | 138 | This is capitalised if the volume is currently locked against allocation |
65b977f2 ZK |
139 | changes, for example during |
140 | .BR pvmove (8). | |
d6cf4325 AK |
141 | .IP 4 3 |
142 | fixed (m)inor | |
143 | .IP 5 3 | |
5f4b2acf | 144 | State: (a)ctive, (s)uspended, (I)nvalid snapshot, invalid (S)uspended snapshot, |
d658922f | 145 | snapshot (m)erge failed, suspended snapshot (M)erge failed, |
5f4b2acf | 146 | mapped (d)evice present without tables, mapped device present with (i)nactive table |
d6cf4325 AK |
147 | .IP 6 3 |
148 | device (o)pen | |
52e3f9dd | 149 | .IP 7 3 |
c63b155d | 150 | Target type: (m)irror, (r)aid, (s)napshot, (t)hin, (u)nknown, (v)irtual. |
52e3f9dd AK |
151 | This groups logical volumes related to the same kernel target together. So, |
152 | for example, mirror images, mirror logs as well as mirrors themselves appear as | |
153 | (m) if they use the original device-mapper mirror kernel driver; whereas the raid | |
154 | equivalents using the md raid kernel driver all appear as (r). | |
155 | Snapshots using the original device-mapper driver appear as (s); whereas | |
156 | snapshots of thin volumes using the new thin provisioning driver appear as (t). | |
5081181b AK |
157 | .IP 8 3 |
158 | Newly-allocated data blocks are overwritten with blocks of (z)eroes before use. | |
d6cf4325 | 159 | .RE |
4c64ed4c | 160 | .TP |
65b977f2 | 161 | .BR \-O ", " \-\-sort |
4c64ed4c | 162 | Comma-separated ordered list of columns to sort by. Replaces the default |
c63b155d | 163 | selection. Precede any column with '\fI\-\fP' for a reverse sort on that column. |
4c64ed4c | 164 | .TP |
65b977f2 | 165 | .B \-\-rows |
6baf9737 DW |
166 | Output columns as rows. |
167 | .TP | |
a326be8f ZK |
168 | .B \-\-segments |
169 | Use default columns that emphasize segment information. | |
170 | .TP | |
65b977f2 | 171 | .B \-\-separator \fISeparator |
4c64ed4c AK |
172 | String to use to separate each column. Useful if grepping the output. |
173 | .TP | |
65b977f2 | 174 | .B \-\-unbuffered |
4c64ed4c AK |
175 | Produce output immediately without sorting or aligning the columns properly. |
176 | .TP | |
65b977f2 | 177 | .B \-\-units \fIhHbBsSkKmMgGtTpPeE |
3d425215 | 178 | All sizes are output in these units: (h)uman-readable, (b)ytes, (s)ectors, |
c63b155d ZK |
179 | (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. |
180 | Capitalise to use multiples of 1000 (S.I.) instead of 1024. Can also specify | |
181 | custom units e.g. \fB\-\-units 3M\fP | |
c0f61d7d | 182 | .TP |
65b977f2 | 183 | .B \-\-unquoted |
c63b155d ZK |
184 | When used with \fB\-\-nameprefixes\fP, output values in the field=value |
185 | pairs are not quoted. | |
4c64ed4c | 186 | .SH SEE ALSO |
06ea7eaa | 187 | .BR lvm (8), |
d6cf4325 | 188 | .BR lvdisplay (8), |
4c64ed4c AK |
189 | .BR pvs (8), |
190 | .BR vgs (8) |