1PVS(8)                      System Manager's Manual                     PVS(8)
2
3
4

NAME

6       pvs - Display information about physical volumes
7

SYNOPSIS

9       pvs
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       pvs produces formatted output about PVs.
15

USAGE

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
43       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

OPTIONS

60       --aligned
61              Use with --separator to align the output columns
62
63       -a|--all
64              Show information about devices that have not been initialized by
65              LVM, i.e. they are not PVs.
66
67       --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
73       --commandprofile String
74              The command profile to use for command configuration.  See
75              lvm.conf(5) for more information about profiles.
76
77       --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
83       --configreport log|vg|lv|pv|pvseg|seg
84              See lvmreport(7).
85
86       -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
90       --driverloaded y|n
91              If set to no, the command will not attempt to use device-mapper.
92              For testing and debugging.
93
94       --foreign
95              Report/display foreign VGs that would otherwise be skipped.  See
96              lvmsystemid(7) for more information about foreign VGs.
97
98       -h|--help
99              Display help text.
100
101       --ignorelockingfailure
102              Allows a command to continue with read-only metadata operations
103              after locking failures.
104
105       --lockopt String
106              Used to pass options for special cases to lvmlockd.  See lvm‐
107              lockd(8) for more information.
108
109       --logonly
110              Suppress command report and display only log report.
111
112       --longhelp
113              Display long help text.
114
115       --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
121       --noheadings
122              Suppress the headings line that is normally the first line of
123              output.  Useful if grepping the output.
124
125       --nolocking
126              Disable locking.
127
128       --nosuffix
129              Suppress the suffix on output sizes. Use with --units (except h
130              and H) if processing the output.
131
132       -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
148       --profile String
149              An alias for --commandprofile or --metadataprofile, depending on
150              the command.
151
152       -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
157       --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
165       --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
173       --rows
174              Output columns as rows.
175
176       --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
181       -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
192       --separator String
193              String to use to separate each column. Useful if grepping the
194              output.
195
196       --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
201       -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
206       -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
214       --unbuffered
215              Produce output immediately without sorting or aligning the col‐
216              umns properly.
217
218       --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
225       --unquoted
226              When used with --nameprefixes, output values in the field=value
227              pairs are not quoted.
228
229       -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
233       --version
234              Display version information.
235
236       -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

VARIABLES

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
251       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
255       String
256              See the option description for information about the string con‐
257              tent.
258
259       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

ENVIRONMENT VARIABLES

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

NOTES

276       The pv_attr bits are:
277
278       1  (d)uplicate, (a)llocatable, (u)sed
279
280       2  e(x)ported
281
282       3  (m)issing
283

SEE ALSO

285       lvm(8) lvm.conf(5) lvmconfig(8)
286
287       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
288       pvresize(8) pvs(8) pvscan(8)
289
290       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
295       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
298       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
299       vate(8) lvmdump(8)
300
301       dmeventd(8) lvmpolld(8)  lvmlockd(8)  lvmlockctl(8)  cmirrord(8)  lvmd‐
302       busd(8)
303
304       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
305
306
307
308Red Hat, Inc.          LVM TOOLS 2.03.06(2) (2019-10-23)                PVS(8)
Impressum