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 [ --ignoreskippedcluster ]
36 [ --logonly ]
37 [ --noheadings ]
38 [ --nosuffix ]
39 [ --readonly ]
40 [ --reportformat basic|json ]
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 [ PV|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 [ --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 --ignoreskippedcluster
119 Use to avoid exiting with an non-zero status code if the command
120 is run without clustered locking and clustered VGs are skipped.
121 --lockopt String
123 Used to pass options for special cases to lvmlockd. See lvm‐
124 lockd(8) for more information.
125 --logonly
127 Suppress command report and display only log report.
128 --longhelp
130 Display long help text.
131 -m|--maps
133 Display the mapping of physical extents to LVs and logical
134 extents.
135 --noheadings
137 Suppress the headings line that is normally the first line of
138 output. Useful if grepping the output.
139 --nosuffix
141 Suppress the suffix on output sizes. Use with --units (except h
142 and H) if processing the output.
143 -o|--options String
145 Comma-separated, ordered list of fields to display in columns.
146 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
147 will append the specified fields to the default fields, - will
148 remove the specified fields from the default fields, and # will
149 compact specified fields (removing them when empty for all
150 rows.) Use -o help to view the list of all available fields.
151 Use separate lists of fields to add, remove or compact by
152 repeating the -o option: -o+field1,field2 -o-field3,field4
153 -o#field5. These lists are evaluated from left to right. Use
154 field name lv_all to view all LV fields, vg_all all VG fields,
155 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
156 all LV segment fields, and pvseg_all all PV segment columns.
157 See the lvm.conf report section for more config options. See
158 lvmreport(7) for more information about reporting.
159 --profile String
161 An alias for --commandprofile or --metadataprofile, depending on
162 the command.
163 -q|--quiet ...
165 Suppress output and log messages. Overrides --debug and --ver‐
166 bose. Repeat once to also suppress any prompts with answer
167 'no'.
168 --readonly
170 Run the command in a special read-only mode which will read on-
171 disk metadata without needing to take any locks. This can be
172 used to peek inside metadata used by a virtual machine image
173 while the virtual machine is running. It can also be used to
174 peek inside the metadata of clustered VGs when clustered locking
175 is not configured or running. No attempt will be made to commu‐
176 nicate with the device-mapper kernel driver, so this option is
177 unable to report whether or not LVs are actually in use.
178 --reportformat basic|json
180 Overrides current output format for reports which is defined
181 globally by the report/output_format setting in lvm.conf. basic
182 is the original format with columns and rows. If there is more
183 than one report per command, each report is prefixed with the
184 report name for identification. json produces report output in
185 JSON format. See lvmreport(7) for more information.
186 -S|--select String
188 Select objects for processing and reporting based on specified
189 criteria. The criteria syntax is described by --select help and
190 lvmreport(7). For reporting commands, one row is displayed for
191 each object matching the criteria. See --options help for
192 selectable object fields. Rows can be displayed with an addi‐
193 tional "selected" field (-o selected) showing 1 if the row
194 matches the selection and 0 otherwise. For non-reporting com‐
195 mands which process LVM entities, the selection is used to
196 choose items to process.
197 --separator String
199 String to use to separate each column. Useful if grepping the
200 output.
201 --shared
203 Report/display shared VGs that would otherwise be skipped when
204 lvmlockd is not being used on the host. See lvmlockd(8) for
205 more information about shared VGs.
206 -s|--short
208 Only display the size of the given PVs.
209 -O|--sort String
211 Comma-separated ordered list of columns to sort by. Replaces the
212 default selection. Precede any column with - for a reverse sort
213 on that column.
214 -t|--test
216 Run in test mode. Commands will not update metadata. This is
217 implemented by disabling all metadata writing but nevertheless
218 returning success to the calling function. This may lead to
219 unusual error messages in multi-stage operations if a tool
220 relies on reading back metadata it believes has changed but
221 hasn't.
222 --unbuffered
224 Produce output immediately without sorting or aligning the col‐
225 umns properly.
226 --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
228 All sizes are output in these units: human-(r)eadable with '<'
229 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
230 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
231 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
232 of 1024. Custom units can be specified, e.g. --units 3M.
233 -v|--verbose ...
235 Set verbose level. Repeat from 1 to 4 times to increase the
236 detail of messages sent to stdout and stderr.
237 --version
239 Display version information.
240 -y|--yes
242 Do not prompt for confirmation interactively but always assume
243 the answer yes. Use with extreme caution. (For automatic no,
244 see -qq.)
245
247 PV
248 Physical Volume name, a device path under /dev. For commands
249 managing physical extents, a PV positional arg generally accepts
250 a suffix indicating a range (or multiple ranges) of physical
251 extents (PEs). When the first PE is omitted, it defaults to the
252 start of the device, and when the last PE is omitted it defaults
253 to end. Start and end range (inclusive): PV[:PE-PE]... Start
254 and length range (counting from 0): PV[:PE+PE]...
255 Tag
257 Tag name. See lvm(8) for information about tag names and using
258 tags in place of a VG, LV or PV.
259 String
261 See the option description for information about the string con‐
262 tent.
263 Size[UNIT]
265 Size is an input number that accepts an optional unit. Input
266 units are always treated as base two values, regardless of capi‐
267 talization, e.g. 'k' and 'K' both refer to 1024. The default
268 input unit is specified by letter, followed by |UNIT. UNIT rep‐
269 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
270 bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is
271 megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
272 e|E is exabytes. (This should not be confused with the output
273 control --units, where capital letters mean multiple of 1000.)
274
276 See lvm(8) for information about environment variables used by lvm.
277 For example, LVM_VG_NAME can generally be substituted for a required VG
278 parameter.
279
281 lvm(8) lvm.conf(5) lvmconfig(8)
282 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
284 pvresize(8) pvs(8) pvscan(8)
285 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
287 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
288 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
289 vgs(8) vgscan(8) vgsplit(8)
290 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
292 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
293 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
295 vate(8) lvmdump(8)
296 dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8)
298 cmirrord(8) lvmdbusd(8)
299 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
301Red Hat, Inc. LVM TOOLS 2.02.183(2) (2018-12-07) PVDISPLAY(8)