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 [ --segments ]
40 [ --separator String ]
41 [ --shared ]
42 [ --unbuffered ]
43 [ --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
44 [ COMMON_OPTIONS ]
45 [ VG|LV|Tag ... ]
46 Common options for lvm:
48 [ -d|--debug ]
49 [ -h|--help ]
50 [ -q|--quiet ]
51 [ -t|--test ]
52 [ -v|--verbose ]
53 [ -y|--yes ]
54 [ --commandprofile String ]
55 [ --config String ]
56 [ --devices PV ]
57 [ --devicesfile String ]
58 [ --driverloaded y|n ]
59 [ --journal String ]
60 [ --lockopt String ]
61 [ --longhelp ]
62 [ --nohints ]
63 [ --nolocking ]
64 [ --profile String ]
65 [ --version ]
66
68 --aligned
69 Use with --separator to align the output columns
70 -a|--all
72 Show information about internal LVs. These are components of
73 normal LVs, such as mirrors, which are not independently acces‐
74 sible, e.g. not mountable.
75 --binary
77 Use binary values "0" or "1" instead of descriptive literal val‐
78 ues for columns that have exactly two valid values to report
79 (not counting the "unknown" value which denotes that the value
80 could not be determined).
81 -c|--colon
83 Generate colon separated output for easier parsing in scripts or
84 programs. Also see vgs(8) which provides considerably more con‐
85 trol over the output.
86 -C|--columns
88 Display output in columns, the equivalent of vgs(8). Options
89 listed are the same as options given in vgs(8).
90 --commandprofile String
92 The command profile to use for command configuration. See
93 lvm.conf(5) for more information about profiles.
94 --config String
96 Config settings for the command. These override lvm.conf(5) set‐
97 tings. The String arg uses the same format as lvm.conf(5), or
98 may use section/field syntax. See lvm.conf(5) for more informa‐
99 tion about config.
100 --configreport log|vg|lv|pv|pvseg|seg
102 See lvmreport(7).
103 -d|--debug ...
105 Set debug level. Repeat from 1 to 6 times to increase the detail
106 of messages sent to the log file and/or syslog (if configured).
107 --devices PV
109 Restricts the devices that are visible and accessible to the
110 command. Devices not listed will appear to be missing. This op‐
111 tion can be repeated, or accepts a comma separated list of de‐
112 vices. This overrides the devices file.
113 --devicesfile String
115 A file listing devices that LVM should use. The file must exist
116 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
117 mand. This overrides the lvm.conf(5) devices/devicesfile and
118 devices/use_devicesfile settings.
119 --driverloaded y|n
121 If set to no, the command will not attempt to use device-mapper.
122 For testing and debugging.
123 --foreign
125 Report/display foreign VGs that would otherwise be skipped. See
126 lvmsystemid(7) for more information about foreign VGs.
127 -h|--help
129 Display help text.
130 -H|--history
132 Include historical LVs in the output. (This has no effect un‐
133 less LVs were removed while lvm.conf(5) metadata/record_lvs_his‐
134 tory was enabled.
135 --ignorelockingfailure
137 Allows a command to continue with read-only metadata operations
138 after locking failures.
139 --journal String
141 Record information in the systemd journal. This information is
142 in addition to information enabled by the lvm.conf log/journal
143 setting. command: record information about the command. out‐
144 put: record the default command output. debug: record full com‐
145 mand debugging.
146 --lockopt String
148 Used to pass options for special cases to lvmlockd. See lvm‐
149 lockd(8) for more information.
150 --logonly
152 Suppress command report and display only log report.
153 --longhelp
155 Display long help text.
156 -m|--maps
158 Display the mapping of logical extents to PVs and physical ex‐
159 tents. To map physical extents to logical extents use: pvs
160 --segments -o+lv_name,seg_start_pe,segtype
161 --noheadings
163 Suppress the headings line that is normally the first line of
164 output. Useful if grepping the output.
165 --nohints
167 Do not use the hints file to locate devices for PVs. A command
168 may read more devices to find PVs when hints are not used. The
169 command will still perform standard hint file invalidation where
170 appropriate.
171 --nolocking
173 Disable locking. Use with caution, concurrent commands may pro‐
174 duce incorrect results.
175 --nosuffix
177 Suppress the suffix on output sizes. Use with --units (except h
178 and H) if processing the output.
179 -o|--options String
181 Comma-separated, ordered list of fields to display in columns.
182 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
183 will append the specified fields to the default fields, - will
184 remove the specified fields from the default fields, and # will
185 compact specified fields (removing them when empty for all
186 rows.) Use -o help to view the list of all available fields.
187 Use separate lists of fields to add, remove or compact by re‐
188 peating the -o option: -o+field1,field2 -o-field3,field4
189 -o#field5. These lists are evaluated from left to right. Use
190 field name lv_all to view all LV fields, vg_all all VG fields,
191 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
192 all LV segment fields, and pvseg_all all PV segment columns.
193 See the lvm.conf(5) report section for more config options. See
194 lvmreport(7) for more information about reporting.
195 --profile String
197 An alias for --commandprofile or --metadataprofile, depending on
198 the command.
199 -q|--quiet ...
201 Suppress output and log messages. Overrides --debug and --ver‐
202 bose. Repeat once to also suppress any prompts with answer
203 'no'.
204 --readonly
206 Run the command in a special read-only mode which will read on-
207 disk metadata without needing to take any locks. This can be
208 used to peek inside metadata used by a virtual machine image
209 while the virtual machine is running. No attempt will be made to
210 communicate with the device-mapper kernel driver, so this option
211 is unable to report whether or not LVs are actually in use.
212 --segments
214 -S|--select String
216 Select objects for processing and reporting based on specified
217 criteria. The criteria syntax is described by --select help and
218 lvmreport(7). For reporting commands, one row is displayed for
219 each object matching the criteria. See --options help for se‐
220 lectable object fields. Rows can be displayed with an addition‐
221 al "selected" field (-o selected) showing 1 if the row matches
222 the selection and 0 otherwise. For non-reporting commands which
223 process LVM entities, the selection is used to choose items to
224 process.
225 --separator String
227 String to use to separate each column. Useful if grepping the
228 output.
229 --shared
231 Report/display shared VGs that would otherwise be skipped when
232 lvmlockd is not being used on the host. See lvmlockd(8) for
233 more information about shared VGs.
234 -O|--sort String
236 Comma-separated ordered list of columns to sort by. Replaces the
237 default selection. Precede any column with - for a reverse sort
238 on that column.
239 -t|--test
241 Run in test mode. Commands will not update metadata. This is
242 implemented by disabling all metadata writing but nevertheless
243 returning success to the calling function. This may lead to un‐
244 usual error messages in multi-stage operations if a tool relies
245 on reading back metadata it believes has changed but hasn't.
246 --unbuffered
248 Produce output immediately without sorting or aligning the col‐
249 umns properly.
250 --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
252 All sizes are output in these units: human-(r)eadable with '<'
253 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
254 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
255 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
256 of 1024. Custom units can be specified, e.g. --units 3M.
257 -v|--verbose ...
259 Set verbose level. Repeat from 1 to 4 times to increase the de‐
260 tail of messages sent to stdout and stderr.
261 --version
263 Display version information.
264 -y|--yes
266 Do not prompt for confirmation interactively but always assume
267 the answer yes. Use with extreme caution. (For automatic no,
268 see -qq.)
269
271 VG Volume Group name. See lvm(8) for valid names.
272 LV Logical Volume name. See lvm(8) for valid names. An LV posi‐
274 tional arg generally includes the VG name and LV name, e.g.
275 VG/LV.
276 Tag Tag name. See lvm(8) for information about tag names and using
278 tags in place of a VG, LV or PV.
279 String See the option description for information about the string con‐
281 tent.
282 Size[UNIT]
284 Size is an input number that accepts an optional unit. Input
285 units are always treated as base two values, regardless of capi‐
286 talization, e.g. 'k' and 'K' both refer to 1024. The default
287 input unit is specified by letter, followed by |UNIT. UNIT rep‐
288 resents other possible input units: b|B is bytes, s|S is sectors
289 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
290 p|P is PiB, e|E is EiB. (This should not be confused with the
291 output control --units, where capital letters mean multiple of
292 1000.)
293
295 See lvm(8) for information about environment variables used by lvm.
296 For example, LVM_VG_NAME can generally be substituted for a required VG
297 parameter.
298
300 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
301 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
303 pvremove(8), pvresize(8), pvs(8), pvscan(8),
304 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
306 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
307 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
308 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
309 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
311 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
312 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
314 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
316 lvmdbusd(8), fsadm(8),
317 lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
319 lvmvdo(7), lvmautoactivation(7)
320Red Hat, Inc. LVM TOOLS 2.03.22(2) (2023-08-02) LVDISPLAY(8)