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
130 extents.
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
151 repeating 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
189 selectable 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
216 unusual error messages in multi-stage operations if a tool
217 relies on reading back metadata it believes has changed but
218 hasn't.
219 --unbuffered
221 Produce output immediately without sorting or aligning the col‐
222 umns properly.
223 --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
225 All sizes are output in these units: human-(r)eadable with '<'
226 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
227 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
228 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
229 of 1024. Custom units can be specified, e.g. --units 3M.
230 -v|--verbose ...
232 Set verbose level. Repeat from 1 to 4 times to increase the
233 detail of messages sent to stdout and stderr.
234 --version
236 Display version information.
237 -y|--yes
239 Do not prompt for confirmation interactively but always assume
240 the answer yes. Use with extreme caution. (For automatic no,
241 see -qq.)
242
244 PV
245 Physical Volume name, a device path under /dev. For commands
246 managing physical extents, a PV positional arg generally accepts
247 a suffix indicating a range (or multiple ranges) of physical
248 extents (PEs). When the first PE is omitted, it defaults to the
249 start of the device, and when the last PE is omitted it defaults
250 to end. Start and end range (inclusive): PV[:PE-PE]... Start
251 and length range (counting from 0): PV[:PE+PE]...
252 Tag
254 Tag name. See lvm(8) for information about tag names and using
255 tags in place of a VG, LV or PV.
256 String
258 See the option description for information about the string con‐
259 tent.
260 Size[UNIT]
262 Size is an input number that accepts an optional unit. Input
263 units are always treated as base two values, regardless of capi‐
264 talization, e.g. 'k' and 'K' both refer to 1024. The default
265 input unit is specified by letter, followed by |UNIT. UNIT rep‐
266 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
267 bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is
268 megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
269 e|E is exabytes. (This should not be confused with the output
270 control --units, where capital letters mean multiple of 1000.)
271
273 See lvm(8) for information about environment variables used by lvm.
274 For example, LVM_VG_NAME can generally be substituted for a required VG
275 parameter.
276
278 lvm(8) lvm.conf(5) lvmconfig(8)
279 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
281 pvresize(8) pvs(8) pvscan(8)
282 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
284 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
285 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
286 vgs(8) vgscan(8) vgsplit(8)
287 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
289 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
290 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
292 vate(8) lvmdump(8)
293 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
295 busd(8)
296 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
298Red Hat, Inc. LVM TOOLS 2.03.09(2) (2020-03-26) PVDISPLAY(8)