1LVDISPLAY(8) System Manager's Manual LVDISPLAY(8)
2
6 lvdisplay - Display information about a logical volume
7
9 lvdisplay
10 [ option_args ]
11 [ position_args ]
12
14 lvdisplay shows the attributes of LVs, like size, read/write status,
15 snapshot information, etc.
16 lvs(8) is a preferred alternative that shows the same information and
18 more, using a more compact and configurable output format.
19
21 lvdisplay
22 [ -a|--all ]
23 [ -c|--colon ]
24 [ -C|--columns ]
25 [ -H|--history ]
26 [ -m|--maps ]
27 [ -o|--options String ]
28 [ -O|--sort String ]
29 [ -S|--select String ]
30 [ --aligned ]
31 [ --binary ]
32 [ --configreport log|vg|lv|pv|pvseg|seg ]
33 [ --foreign ]
34 [ --ignorelockingfailure ]
35 [ --logonly ]
36 [ --noheadings ]
37 [ --nosuffix ]
38 [ --readonly ]
39 [ --reportformat basic|json ]
40 [ --segments ]
41 [ --separator String ]
42 [ --shared ]
43 [ --unbuffered ]
44 [ --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
45 [ COMMON_OPTIONS ]
46 [ VG|LV|Tag ... ]
47 Common options for lvm:
49 [ -d|--debug ]
50 [ -h|--help ]
51 [ -q|--quiet ]
52 [ -t|--test ]
53 [ -v|--verbose ]
54 [ -y|--yes ]
55 [ --commandprofile String ]
56 [ --config String ]
57 [ --driverloaded y|n ]
58 [ --lockopt String ]
59 [ --longhelp ]
60 [ --nolocking ]
61 [ --profile String ]
62 [ --version ]
63
65 --aligned
66 Use with --separator to align the output columns
67 -a|--all
69 Show information about internal LVs. These are components of
70 normal LVs, such as mirrors, which are not independently acces‐
71 sible, e.g. not mountable.
72 --binary
74 Use binary values "0" or "1" instead of descriptive literal val‐
75 ues for columns that have exactly two valid values to report
76 (not counting the "unknown" value which denotes that the value
77 could not be determined).
78 -c|--colon
80 Generate colon separated output for easier parsing in scripts or
81 programs. Also see vgs(8) which provides considerably more con‐
82 trol over the output.
83 -C|--columns
85 Display output in columns, the equivalent of vgs(8). Options
86 listed are the same as options given in vgs(8).
87 --commandprofile String
89 The command profile to use for command configuration. See
90 lvm.conf(5) for more information about profiles.
91 --config String
93 Config settings for the command. These override lvm.conf set‐
94 tings. The String arg uses the same format as lvm.conf, or may
95 use section/field syntax. See lvm.conf(5) for more information
96 about config.
97 --configreport log|vg|lv|pv|pvseg|seg
99 See lvmreport(7).
100 -d|--debug ...
102 Set debug level. Repeat from 1 to 6 times to increase the detail
103 of messages sent to the log file and/or syslog (if configured).
104 --driverloaded y|n
106 If set to no, the command will not attempt to use device-mapper.
107 For testing and debugging.
108 --foreign
110 Report/display foreign VGs that would otherwise be skipped. See
111 lvmsystemid(7) for more information about foreign VGs.
112 -h|--help
114 Display help text.
115 -H|--history
117 Include historical LVs in the output. (This has no effect
118 unless LVs were removed while lvm.conf metadata/record_lvs_his‐
119 tory was enabled.
120 --ignorelockingfailure
122 Allows a command to continue with read-only metadata operations
123 after locking failures.
124 --lockopt String
126 Used to pass options for special cases to lvmlockd. See lvm‐
127 lockd(8) for more information.
128 --logonly
130 Suppress command report and display only log report.
131 --longhelp
133 Display long help text.
134 -m|--maps
136 Display the mapping of logical extents to PVs and physical
137 extents. To map physical extents to logical extents use: pvs
138 --segments -o+lv_name,seg_start_pe,segtype
139 --noheadings
141 Suppress the headings line that is normally the first line of
142 output. Useful if grepping the output.
143 --nolocking
145 Disable locking.
146 --nosuffix
148 Suppress the suffix on output sizes. Use with --units (except h
149 and H) if processing the output.
150 -o|--options String
152 Comma-separated, ordered list of fields to display in columns.
153 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
154 will append the specified fields to the default fields, - will
155 remove the specified fields from the default fields, and # will
156 compact specified fields (removing them when empty for all
157 rows.) Use -o help to view the list of all available fields.
158 Use separate lists of fields to add, remove or compact by
159 repeating the -o option: -o+field1,field2 -o-field3,field4
160 -o#field5. These lists are evaluated from left to right. Use
161 field name lv_all to view all LV fields, vg_all all VG fields,
162 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
163 all LV segment fields, and pvseg_all all PV segment columns.
164 See the lvm.conf report section for more config options. See
165 lvmreport(7) for more information about reporting.
166 --profile String
168 An alias for --commandprofile or --metadataprofile, depending on
169 the command.
170 -q|--quiet ...
172 Suppress output and log messages. Overrides --debug and --ver‐
173 bose. Repeat once to also suppress any prompts with answer
174 'no'.
175 --readonly
177 Run the command in a special read-only mode which will read on-
178 disk metadata without needing to take any locks. This can be
179 used to peek inside metadata used by a virtual machine image
180 while the virtual machine is running. No attempt will be made to
181 communicate with the device-mapper kernel driver, so this option
182 is unable to report whether or not LVs are actually in use.
183 --reportformat basic|json
185 Overrides current output format for reports which is defined
186 globally by the report/output_format setting in lvm.conf. basic
187 is the original format with columns and rows. If there is more
188 than one report per command, each report is prefixed with the
189 report name for identification. json produces report output in
190 JSON format. See lvmreport(7) for more information.
191 --segments
193 -S|--select String
195 Select objects for processing and reporting based on specified
196 criteria. The criteria syntax is described by --select help and
197 lvmreport(7). For reporting commands, one row is displayed for
198 each object matching the criteria. See --options help for
199 selectable object fields. Rows can be displayed with an addi‐
200 tional "selected" field (-o selected) showing 1 if the row
201 matches the selection and 0 otherwise. For non-reporting com‐
202 mands which process LVM entities, the selection is used to
203 choose items to process.
204 --separator String
206 String to use to separate each column. Useful if grepping the
207 output.
208 --shared
210 Report/display shared VGs that would otherwise be skipped when
211 lvmlockd is not being used on the host. See lvmlockd(8) for
212 more information about shared VGs.
213 -O|--sort String
215 Comma-separated ordered list of columns to sort by. Replaces the
216 default selection. Precede any column with - for a reverse sort
217 on that column.
218 -t|--test
220 Run in test mode. Commands will not update metadata. This is
221 implemented by disabling all metadata writing but nevertheless
222 returning success to the calling function. This may lead to
223 unusual error messages in multi-stage operations if a tool
224 relies on reading back metadata it believes has changed but
225 hasn't.
226 --unbuffered
228 Produce output immediately without sorting or aligning the col‐
229 umns properly.
230 --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
232 All sizes are output in these units: human-(r)eadable with '<'
233 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
234 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
235 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
236 of 1024. Custom units can be specified, e.g. --units 3M.
237 -v|--verbose ...
239 Set verbose level. Repeat from 1 to 4 times to increase the
240 detail of messages sent to stdout and stderr.
241 --version
243 Display version information.
244 -y|--yes
246 Do not prompt for confirmation interactively but always assume
247 the answer yes. Use with extreme caution. (For automatic no,
248 see -qq.)
249
251 VG
252 Volume Group name. See lvm(8) for valid names.
253 LV
255 Logical Volume name. See lvm(8) for valid names. An LV posi‐
256 tional arg generally includes the VG name and LV name, e.g.
257 VG/LV.
258 Tag
260 Tag name. See lvm(8) for information about tag names and using
261 tags in place of a VG, LV or PV.
262 String
264 See the option description for information about the string con‐
265 tent.
266 Size[UNIT]
268 Size is an input number that accepts an optional unit. Input
269 units are always treated as base two values, regardless of capi‐
270 talization, e.g. 'k' and 'K' both refer to 1024. The default
271 input unit is specified by letter, followed by |UNIT. UNIT rep‐
272 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
273 bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is
274 megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
275 e|E is exabytes. (This should not be confused with the output
276 control --units, where capital letters mean multiple of 1000.)
277
279 See lvm(8) for information about environment variables used by lvm.
280 For example, LVM_VG_NAME can generally be substituted for a required VG
281 parameter.
282
284 lvm(8) lvm.conf(5) lvmconfig(8)
285 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
287 pvresize(8) pvs(8) pvscan(8)
288 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
290 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
291 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
292 vgs(8) vgscan(8) vgsplit(8)
293 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
295 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
296 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
298 vate(8) lvmdump(8)
299 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
301 busd(8)
302 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
304Red Hat, Inc. LVM TOOLS 2.03.09(2) (2020-03-26) LVDISPLAY(8)