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