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