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 ]
40 [ --separator String ]
41 [ --shared ]
42 [ --unbuffered ]
43 [ --units 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 [ --driverloaded y|n ]
57 [ --lockopt String ]
58 [ --longhelp ]
59 [ --nolocking ]
60 [ --profile String ]
61 [ --version ]
62
64 --aligned
65 Use with --separator to align the output columns
66 -a|--all
68 Show information about devices that have not been initialized by
69 LVM, i.e. they are not PVs.
70 --binary
72 Use binary values "0" or "1" instead of descriptive literal val‐
73 ues for columns that have exactly two valid values to report
74 (not counting the "unknown" value which denotes that the value
75 could not be determined).
76 -c|--colon
78 Generate colon separated output for easier parsing in scripts or
79 programs. Also see vgs(8) which provides considerably more con‐
80 trol over the output.
81 -C|--columns
83 Display output in columns, the equivalent of vgs(8). Options
84 listed are the same as options given in vgs(8).
85 --commandprofile String
87 The command profile to use for command configuration. See
88 lvm.conf(5) for more information about profiles.
89 --config String
91 Config settings for the command. These override lvm.conf set‐
92 tings. The String arg uses the same format as lvm.conf, or may
93 use section/field syntax. See lvm.conf(5) for more information
94 about config.
95 --configreport log|vg|lv|pv|pvseg|seg
97 See lvmreport(7).
98 -d|--debug ...
100 Set debug level. Repeat from 1 to 6 times to increase the detail
101 of messages sent to the log file and/or syslog (if configured).
102 --driverloaded y|n
104 If set to no, the command will not attempt to use device-mapper.
105 For testing and debugging.
106 --foreign
108 Report/display foreign VGs that would otherwise be skipped. See
109 lvmsystemid(7) for more information about foreign VGs.
110 -h|--help
112 Display help text.
113 --ignorelockingfailure
115 Allows a command to continue with read-only metadata operations
116 after locking failures.
117 --lockopt String
119 Used to pass options for special cases to lvmlockd. See lvm‐
120 lockd(8) for more information.
121 --logonly
123 Suppress command report and display only log report.
124 --longhelp
126 Display long help text.
127 -m|--maps
129 Display the mapping of physical extents to LVs and logical ex‐
130 tents.
131 --noheadings
133 Suppress the headings line that is normally the first line of
134 output. Useful if grepping the output.
135 --nolocking
137 Disable locking.
138 --nosuffix
140 Suppress the suffix on output sizes. Use with --units (except h
141 and H) if processing the output.
142 -o|--options String
144 Comma-separated, ordered list of fields to display in columns.
145 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
146 will append the specified fields to the default fields, - will
147 remove the specified fields from the default fields, and # will
148 compact specified fields (removing them when empty for all
149 rows.) Use -o help to view the list of all available fields.
150 Use separate lists of fields to add, remove or compact by re‐
151 peating the -o option: -o+field1,field2 -o-field3,field4
152 -o#field5. These lists are evaluated from left to right. Use
153 field name lv_all to view all LV fields, vg_all all VG fields,
154 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
155 all LV segment fields, and pvseg_all all PV segment columns.
156 See the lvm.conf report section for more config options. See
157 lvmreport(7) for more information about reporting.
158 --profile String
160 An alias for --commandprofile or --metadataprofile, depending on
161 the command.
162 -q|--quiet ...
164 Suppress output and log messages. Overrides --debug and --ver‐
165 bose. Repeat once to also suppress any prompts with answer
166 'no'.
167 --readonly
169 Run the command in a special read-only mode which will read on-
170 disk metadata without needing to take any locks. This can be
171 used to peek inside metadata used by a virtual machine image
172 while the virtual machine is running. No attempt will be made to
173 communicate with the device-mapper kernel driver, so this option
174 is unable to report whether or not LVs are actually in use.
175 --reportformat basic|json
177 Overrides current output format for reports which is defined
178 globally by the report/output_format setting in lvm.conf. basic
179 is the original format with columns and rows. If there is more
180 than one report per command, each report is prefixed with the
181 report name for identification. json produces report output in
182 JSON format. See lvmreport(7) for more information.
183 -S|--select String
185 Select objects for processing and reporting based on specified
186 criteria. The criteria syntax is described by --select help and
187 lvmreport(7). For reporting commands, one row is displayed for
188 each object matching the criteria. See --options help for se‐
189 lectable object fields. Rows can be displayed with an addi‐
190 tional "selected" field (-o selected) showing 1 if the row
191 matches the selection and 0 otherwise. For non-reporting com‐
192 mands which process LVM entities, the selection is used to
193 choose items to process.
194 --separator String
196 String to use to separate each column. Useful if grepping the
197 output.
198 --shared
200 Report/display shared VGs that would otherwise be skipped when
201 lvmlockd is not being used on the host. See lvmlockd(8) for
202 more information about shared VGs.
203 -s|--short
205 Only display the size of the given PVs.
206 -O|--sort String
208 Comma-separated ordered list of columns to sort by. Replaces the
209 default selection. Precede any column with - for a reverse sort
210 on that column.
211 -t|--test
213 Run in test mode. Commands will not update metadata. This is
214 implemented by disabling all metadata writing but nevertheless
215 returning success to the calling function. This may lead to un‐
216 usual error messages in multi-stage operations if a tool relies
217 on reading back metadata it believes has changed but hasn't.
218 --unbuffered
220 Produce output immediately without sorting or aligning the col‐
221 umns properly.
222 --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
224 All sizes are output in these units: human-(r)eadable with '<'
225 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
226 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
227 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
228 of 1024. Custom units can be specified, e.g. --units 3M.
229 -v|--verbose ...
231 Set verbose level. Repeat from 1 to 4 times to increase the de‐
232 tail of messages sent to stdout and stderr.
233 --version
235 Display version information.
236 -y|--yes
238 Do not prompt for confirmation interactively but always assume
239 the answer yes. Use with extreme caution. (For automatic no,
240 see -qq.)
241
243 PV
244 Physical Volume name, a device path under /dev. For commands
245 managing physical extents, a PV positional arg generally accepts
246 a suffix indicating a range (or multiple ranges) of physical ex‐
247 tents (PEs). When the first PE is omitted, it defaults to the
248 start of the device, and when the last PE is omitted it defaults
249 to end. Start and end range (inclusive): PV[:PE-PE]... Start
250 and length range (counting from 0): PV[:PE+PE]...
251 Tag
253 Tag name. See lvm(8) for information about tag names and using
254 tags in place of a VG, LV or PV.
255 String
257 See the option description for information about the string con‐
258 tent.
259 Size[UNIT]
261 Size is an input number that accepts an optional unit. Input
262 units are always treated as base two values, regardless of capi‐
263 talization, e.g. 'k' and 'K' both refer to 1024. The default
264 input unit is specified by letter, followed by |UNIT. UNIT rep‐
265 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
266 bytes, s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G
267 is GiB, t|T is TiB, p|P is PiB, e|E is EiB. (This should not be
268 confused with the output control --units, where capital letters
269 mean multiple of 1000.)
270
272 See lvm(8) for information about environment variables used by lvm.
273 For example, LVM_VG_NAME can generally be substituted for a required VG
274 parameter.
275
277 lvm(8) lvm.conf(5) lvmconfig(8)
278 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
280 pvresize(8) pvs(8) pvscan(8)
281 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
283 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
284 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
285 vgs(8) vgscan(8) vgsplit(8)
286 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
288 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
289 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
291 vate(8) lvmdump(8)
292 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
294 busd(8)
295 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
297Red Hat, Inc. LVM TOOLS 2.03.11(2) (2021-01-08) PVDISPLAY(8)