1PVS(8) System Manager's Manual PVS(8)
2
6 pvs — Display information about physical volumes
7
9 pvs
10 [ option_args ]
11 [ position_args ]
12
14 pvs produces formatted output about PVs.
15
17 pvs
18 [ -a|--all ]
19 [ -o|--options String ]
20 [ -S|--select String ]
21 [ -O|--sort String ]
22 [ --segments ]
23 [ --aligned ]
24 [ --binary ]
25 [ --configreport log|vg|lv|pv|pvseg|seg ]
26 [ --foreign ]
27 [ --ignorelockingfailure ]
28 [ --logonly ]
29 [ --nameprefixes ]
30 [ --noheadings ]
31 [ --nosuffix ]
32 [ --readonly ]
33 [ --reportformat basic|json|json_std ]
34 [ --rows ]
35 [ --separator String ]
36 [ --shared ]
37 [ --unbuffered ]
38 [ --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
39 [ --unquoted ]
40 [ COMMON_OPTIONS ]
41 [ PV|Tag ... ]
42 Common options for lvm:
44 [ -d|--debug ]
45 [ -h|--help ]
46 [ -q|--quiet ]
47 [ -t|--test ]
48 [ -v|--verbose ]
49 [ -y|--yes ]
50 [ --commandprofile String ]
51 [ --config String ]
52 [ --devices PV ]
53 [ --devicesfile String ]
54 [ --driverloaded y|n ]
55 [ --journal String ]
56 [ --lockopt String ]
57 [ --longhelp ]
58 [ --nohints ]
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 --commandprofile String
78 The command profile to use for command configuration. See
79 lvm.conf(5) for more information about profiles.
80 --config String
82 Config settings for the command. These override lvm.conf(5) set‐
83 tings. The String arg uses the same format as lvm.conf(5), or
84 may use section/field syntax. See lvm.conf(5) for more informa‐
85 tion about config.
86 --configreport log|vg|lv|pv|pvseg|seg
88 See lvmreport(7).
89 -d|--debug ...
91 Set debug level. Repeat from 1 to 6 times to increase the detail
92 of messages sent to the log file and/or syslog (if configured).
93 --devices PV
95 Restricts the devices that are visible and accessible to the
96 command. Devices not listed will appear to be missing. This op‐
97 tion can be repeated, or accepts a comma separated list of de‐
98 vices. This overrides the devices file.
99 --devicesfile String
101 A file listing devices that LVM should use. The file must exist
102 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
103 mand. This overrides the lvm.conf(5) devices/devicesfile and
104 devices/use_devicesfile settings.
105 --driverloaded y|n
107 If set to no, the command will not attempt to use device-mapper.
108 For testing and debugging.
109 --foreign
111 Report/display foreign VGs that would otherwise be skipped. See
112 lvmsystemid(7) for more information about foreign VGs.
113 -h|--help
115 Display help text.
116 --ignorelockingfailure
118 Allows a command to continue with read-only metadata operations
119 after locking failures.
120 --journal String
122 Record information in the systemd journal. This information is
123 in addition to information enabled by the lvm.conf log/journal
124 setting. command: record information about the command. out‐
125 put: record the default command output. debug: record full com‐
126 mand debugging.
127 --lockopt String
129 Used to pass options for special cases to lvmlockd. See lvm‐
130 lockd(8) for more information.
131 --logonly
133 Suppress command report and display only log report.
134 --longhelp
136 Display long help text.
137 --nameprefixes
139 Add an "LVM2_" prefix plus the field name to the output. Useful
140 with --noheadings to produce a list of field=value pairs that
141 can be used to set environment variables (for example, in udev
142 rules).
143 --noheadings
145 Suppress the headings line that is normally the first line of
146 output. Useful if grepping the output.
147 --nohints
149 Do not use the hints file to locate devices for PVs. A command
150 may read more devices to find PVs when hints are not used. The
151 command will still perform standard hint file invalidation where
152 appropriate.
153 --nolocking
155 Disable locking. Use with caution, concurrent commands may pro‐
156 duce incorrect results.
157 --nosuffix
159 Suppress the suffix on output sizes. Use with --units (except h
160 and H) if processing the output.
161 -o|--options String
163 Comma-separated, ordered list of fields to display in columns.
164 String arg syntax is: [+|-|#]Field1[,Field2 ...] The prefix +
165 will append the specified fields to the default fields, - will
166 remove the specified fields from the default fields, and # will
167 compact specified fields (removing them when empty for all
168 rows.) Use -o help to view the list of all available fields.
169 Use separate lists of fields to add, remove or compact by re‐
170 peating the -o option: -o+field1,field2 -o-field3,field4
171 -o#field5. These lists are evaluated from left to right. Use
172 field name lv_all to view all LV fields, vg_all all VG fields,
173 pv_all all PV fields, pvseg_all all PV segment fields, seg_all
174 all LV segment fields, and pvseg_all all PV segment columns.
175 See the lvm.conf(5) report section for more config options. See
176 lvmreport(7) for more information about reporting.
177 --profile String
179 An alias for --commandprofile or --metadataprofile, depending on
180 the command.
181 -q|--quiet ...
183 Suppress output and log messages. Overrides --debug and --ver‐
184 bose. Repeat once to also suppress any prompts with answer
185 'no'.
186 --readonly
188 Run the command in a special read-only mode which will read on-
189 disk metadata without needing to take any locks. This can be
190 used to peek inside metadata used by a virtual machine image
191 while the virtual machine is running. No attempt will be made to
192 communicate with the device-mapper kernel driver, so this option
193 is unable to report whether or not LVs are actually in use.
194 --reportformat basic|json|json_std
196 Overrides current output format for reports which is defined
197 globally by the report/output_format setting in lvm.conf(5).
198 basic is the original format with columns and rows. If there is
199 more than one report per command, each report is prefixed with
200 the report name for identification. json produces report output
201 in JSON format. json_std produces report output in JSON format
202 which is more compliant with JSON standard. See lvmreport(7)
203 for more information.
204 --rows
206 Output columns as rows.
207 --segments
209 Produces one line of output for each contiguous allocation of
210 space on each PV, showing the start (pvseg_start) and length
211 (pvseg_size) in units of physical extents.
212 -S|--select String
214 Select objects for processing and reporting based on specified
215 criteria. The criteria syntax is described by --select help and
216 lvmreport(7). For reporting commands, one row is displayed for
217 each object matching the criteria. See --options help for se‐
218 lectable object fields. Rows can be displayed with an addition‐
219 al "selected" field (-o selected) showing 1 if the row matches
220 the selection and 0 otherwise. For non-reporting commands which
221 process LVM entities, the selection is used to choose items to
222 process.
223 --separator String
225 String to use to separate each column. Useful if grepping the
226 output.
227 --shared
229 Report/display shared VGs that would otherwise be skipped when
230 lvmlockd is not being used on the host. See lvmlockd(8) for
231 more information about shared VGs.
232 -O|--sort String
234 Comma-separated ordered list of columns to sort by. Replaces the
235 default selection. Precede any column with - for a reverse sort
236 on that column.
237 -t|--test
239 Run in test mode. Commands will not update metadata. This is
240 implemented by disabling all metadata writing but nevertheless
241 returning success to the calling function. This may lead to un‐
242 usual error messages in multi-stage operations if a tool relies
243 on reading back metadata it believes has changed but hasn't.
244 --unbuffered
246 Produce output immediately without sorting or aligning the col‐
247 umns properly.
248 --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
250 All sizes are output in these units: human-(r)eadable with '<'
251 rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
252 (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
253 (e)xabytes. Capitalise to use multiples of 1000 (S.I.) instead
254 of 1024. Custom units can be specified, e.g. --units 3M.
255 --unquoted
257 When used with --nameprefixes, output values in the field=value
258 pairs are not quoted.
259 -v|--verbose ...
261 Set verbose level. Repeat from 1 to 4 times to increase the de‐
262 tail of messages sent to stdout and stderr.
263 --version
265 Display version information.
266 -y|--yes
268 Do not prompt for confirmation interactively but always assume
269 the answer yes. Use with extreme caution. (For automatic no,
270 see -qq.)
271
273 PV Physical Volume name, a device path under /dev. For commands
274 managing physical extents, a PV positional arg generally accepts
275 a suffix indicating a range (or multiple ranges) of physical ex‐
276 tents (PEs). When the first PE is omitted, it defaults to the
277 start of the device, and when the last PE is omitted it defaults
278 to end. Start and end range (inclusive): PV[:PE-PE]... Start
279 and length range (counting from 0): PV[:PE+PE]...
280 Tag Tag name. See lvm(8) for information about tag names and using
282 tags in place of a VG, LV or PV.
283 String See the option description for information about the string con‐
285 tent.
286 Size[UNIT]
288 Size is an input number that accepts an optional unit. Input
289 units are always treated as base two values, regardless of capi‐
290 talization, e.g. 'k' and 'K' both refer to 1024. The default
291 input unit is specified by letter, followed by |UNIT. UNIT rep‐
292 resents other possible input units: b|B is bytes, s|S is sectors
293 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
294 p|P is PiB, e|E is EiB. (This should not be confused with the
295 output control --units, where capital letters mean multiple of
296 1000.)
297
299 See lvm(8) for information about environment variables used by lvm.
300 For example, LVM_VG_NAME can generally be substituted for a required VG
301 parameter.
302
304 The pv_attr bits are:
305 1 (d)uplicate, (a)llocatable, (u)sed
307 2 e(x)ported
309 3 (m)issing
311
313 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
314 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
316 pvremove(8), pvresize(8), pvs(8), pvscan(8),
317 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
319 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
320 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
321 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
322 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
324 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
325 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
327 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
329 lvmdbusd(8), fsadm(8),
330 lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
332Red Hat, Inc. LVM TOOLS 2.03.18(2)-git (2022-11-10) PVS(8)