1PVDISPLAY(8) System Manager's Manual PVDISPLAY(8)
2
6 pvdisplay — Display various attributes of physical volume(s)
7
9 pvdisplay
10 [ option_args ]
11 [ position_args ]
12
14 pvdisplay shows the attributes of PVs, like size, physical extent size,
15 space used for the VG descriptor area, etc.
16 pvs(8) is a preferred alternative that shows the same information and
18 more, using a more compact and configurable output format.
19
21 pvdisplay
22 [ -a|--all ]
23 [ -c|--colon ]
24 [ -C|--columns ]
25 [ -m|--maps ]
26 [ -o|--options String ]
27 [ -S|--select String ]
28 [ -s|--short ]
29 [ -O|--sort 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|json_std ]
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 [ PV|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 devices that have not been initialized by
73 LVM, i.e. they are not PVs.
74 --binary
76 Use binary values "0" or "1" instead of descriptive literal val‐
77 ues for columns that have exactly two valid values to report
78 (not counting the "unknown" value which denotes that the value
79 could not be determined).
80 -c|--colon
82 Generate colon separated output for easier parsing in scripts or
83 programs. Also see vgs(8) which provides considerably more con‐
84 trol over the output.
85 -C|--columns
87 Display output in columns, the equivalent of vgs(8). Options
88 listed are the same as options given in vgs(8).
89 --commandprofile String
91 The command profile to use for command configuration. See
92 lvm.conf(5) for more information about profiles.
93 --config String
95 Config settings for the command. These override lvm.conf(5) set‐
96 tings. The String arg uses the same format as lvm.conf(5), or
97 may use section/field syntax. See lvm.conf(5) for more informa‐
98 tion about config.
99 --configreport log|vg|lv|pv|pvseg|seg
101 See lvmreport(7).
102 -d|--debug ...
104 Set debug level. Repeat from 1 to 6 times to increase the detail
105 of messages sent to the log file and/or syslog (if configured).
106 --devices PV
108 Restricts the devices that are visible and accessible to the
109 command. Devices not listed will appear to be missing. This op‐
110 tion can be repeated, or accepts a comma separated list of de‐
111 vices. This overrides the devices file.
112 --devicesfile String
114 A file listing devices that LVM should use. The file must exist
115 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
116 mand. This overrides the lvm.conf(5) devices/devicesfile and
117 devices/use_devicesfile settings.
118 --driverloaded y|n
120 If set to no, the command will not attempt to use device-mapper.
121 For testing and debugging.
122 --foreign
124 Report/display foreign VGs that would otherwise be skipped. See
125 lvmsystemid(7) for more information about foreign VGs.
126 -h|--help
128 Display help text.
129 --ignorelockingfailure
131 Allows a command to continue with read-only metadata operations
132 after locking failures.
133 --journal String
135 Record information in the systemd journal. This information is
136 in addition to information enabled by the lvm.conf log/journal
137 setting. command: record information about the command. out‐
138 put: record the default command output. debug: record full com‐
139 mand debugging.
140 --lockopt String
142 Used to pass options for special cases to lvmlockd. See lvm‐
143 lockd(8) for more information.
144 --logonly
146 Suppress command report and display only log report.
147 --longhelp
149 Display long help text.
150 -m|--maps
152 Display the mapping of physical extents to LVs and logical ex‐
153 tents.
154 --noheadings
156 Suppress the headings line that is normally the first line of
157 output. Useful if grepping the output.
158 --nohints
160 Do not use the hints file to locate devices for PVs. A command
161 may read more devices to find PVs when hints are not used. The
162 command will still perform standard hint file invalidation where
163 appropriate.
164 --nolocking
166 Disable locking. Use with caution, concurrent commands may pro‐
167 duce incorrect results.
168 --nosuffix
170 Suppress the suffix on output sizes. Use with --units (except h
171 and H) if processing the output.
172 -o|--options String
174 Comma-separated, ordered list of fields to display in columns.
175 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
176 will append the specified fields to the default fields, - will
177 remove the specified fields from the default fields, and # will
178 compact specified fields (removing them when empty for all
179 rows.) Use -o help to view the list of all available fields.
180 Use separate lists of fields to add, remove or compact by re‐
181 peating the -o option: -o+field1,field2 -o-field3,field4
182 -o#field5. These lists are evaluated from left to right. Use
183 field name lv_all to view all LV fields, vg_all all VG fields,
184 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
185 all LV segment fields, and pvseg_all all PV segment columns.
186 See the lvm.conf(5) report section for more config options. See
187 lvmreport(7) for more information about reporting.
188 --profile String
190 An alias for --commandprofile or --metadataprofile, depending on
191 the command.
192 -q|--quiet ...
194 Suppress output and log messages. Overrides --debug and --ver‐
195 bose. Repeat once to also suppress any prompts with answer
196 'no'.
197 --readonly
199 Run the command in a special read-only mode which will read on-
200 disk metadata without needing to take any locks. This can be
201 used to peek inside metadata used by a virtual machine image
202 while the virtual machine is running. No attempt will be made to
203 communicate with the device-mapper kernel driver, so this option
204 is unable to report whether or not LVs are actually in use.
205 --reportformat basic|json|json_std
207 Overrides current output format for reports which is defined
208 globally by the report/output_format setting in lvm.conf(5).
209 basic is the original format with columns and rows. If there is
210 more than one report per command, each report is prefixed with
211 the report name for identification. json produces report output
212 in JSON format. json_std produces report output in JSON format
213 which is more compliant with JSON standard. See lvmreport(7)
214 for more information.
215 -S|--select String
217 Select objects for processing and reporting based on specified
218 criteria. The criteria syntax is described by --select help and
219 lvmreport(7). For reporting commands, one row is displayed for
220 each object matching the criteria. See --options help for se‐
221 lectable object fields. Rows can be displayed with an addition‐
222 al "selected" field (-o selected) showing 1 if the row matches
223 the selection and 0 otherwise. For non-reporting commands which
224 process LVM entities, the selection is used to choose items to
225 process.
226 --separator String
228 String to use to separate each column. Useful if grepping the
229 output.
230 --shared
232 Report/display shared VGs that would otherwise be skipped when
233 lvmlockd is not being used on the host. See lvmlockd(8) for
234 more information about shared VGs.
235 -s|--short
237 Only display the size of the given PVs.
238 -O|--sort String
240 Comma-separated ordered list of columns to sort by. Replaces the
241 default selection. Precede any column with - for a reverse sort
242 on that column.
243 -t|--test
245 Run in test mode. Commands will not update metadata. This is
246 implemented by disabling all metadata writing but nevertheless
247 returning success to the calling function. This may lead to un‐
248 usual error messages in multi-stage operations if a tool relies
249 on reading back metadata it believes has changed but hasn't.
250 --unbuffered
252 Produce output immediately without sorting or aligning the col‐
253 umns properly.
254 --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
256 All sizes are output in these units: human-(r)eadable with '<'
257 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
258 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
259 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
260 of 1024. Custom units can be specified, e.g. --units 3M.
261 -v|--verbose ...
263 Set verbose level. Repeat from 1 to 4 times to increase the de‐
264 tail of messages sent to stdout and stderr.
265 --version
267 Display version information.
268 -y|--yes
270 Do not prompt for confirmation interactively but always assume
271 the answer yes. Use with extreme caution. (For automatic no,
272 see -qq.)
273
275 PV Physical Volume name, a device path under /dev. For commands
276 managing physical extents, a PV positional arg generally accepts
277 a suffix indicating a range (or multiple ranges) of physical ex‐
278 tents (PEs). When the first PE is omitted, it defaults to the
279 start of the device, and when the last PE is omitted it defaults
280 to end. Start and end range (inclusive): PV[:PE-PE]... Start
281 and length range (counting from 0): PV[:PE+PE]...
282 Tag Tag name. See lvm(8) for information about tag names and using
284 tags in place of a VG, LV or PV.
285 String See the option description for information about the string con‐
287 tent.
288 Size[UNIT]
290 Size is an input number that accepts an optional unit. Input
291 units are always treated as base two values, regardless of capi‐
292 talization, e.g. 'k' and 'K' both refer to 1024. The default
293 input unit is specified by letter, followed by |UNIT. UNIT rep‐
294 resents other possible input units: b|B is bytes, s|S is sectors
295 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
296 p|P is PiB, e|E is EiB. (This should not be confused with the
297 output control --units, where capital letters mean multiple of
298 1000.)
299
301 See lvm(8) for information about environment variables used by lvm.
302 For example, LVM_VG_NAME can generally be substituted for a required VG
303 parameter.
304
306 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
307 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
309 pvremove(8), pvresize(8), pvs(8), pvscan(8),
310 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
312 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
313 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
314 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
315 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
317 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
318 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
320 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
322 lvmdbusd(8), fsadm(8),
323 lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
325Red Hat, Inc. LVM TOOLS 2.03.18(2)-git (2022-11-10) PVDISPLAY(8)