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

OPTIONS

64       --aligned
65              Use with --separator to align the output columns
66
67       -a|--all
68              Show information about devices that have not been initialized by
69              LVM, i.e. they are not PVs.
70
71       --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
77       --commandprofile String
78              The  command  profile  to  use  for  command configuration.  See
79              lvm.conf(5) for more information about profiles.
80
81       --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
87       --configreport log|vg|lv|pv|pvseg|seg
88              See lvmreport(7).
89
90       -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
94       --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
100       --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
106       --driverloaded y|n
107              If set to no, the command will not attempt to use device-mapper.
108              For testing and debugging.
109
110       --foreign
111              Report/display foreign VGs that would otherwise be skipped.  See
112              lvmsystemid(7) for more information about foreign VGs.
113
114       -h|--help
115              Display help text.
116
117       --ignorelockingfailure
118              Allows a command to continue with read-only metadata  operations
119              after locking failures.
120
121       --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
128       --lockopt String
129              Used  to  pass  options for special cases to lvmlockd.  See lvm‐
130              lockd(8) for more information.
131
132       --logonly
133              Suppress command report and display only log report.
134
135       --longhelp
136              Display long help text.
137
138       --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
144       --noheadings
145              Suppress  the  headings  line that is normally the first line of
146              output.  Useful if grepping the output.
147
148       --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
154       --nolocking
155              Disable  locking. Use with caution, concurrent commands may pro‐
156              duce incorrect results.
157
158       --nosuffix
159              Suppress the suffix on output sizes. Use with --units (except  h
160              and H) if processing the output.
161
162       -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
178       --profile String
179              An alias for --commandprofile or --metadataprofile, depending on
180              the command.
181
182       -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
187       --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
195       --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
205       --rows
206              Output columns as rows.
207
208       --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
213       -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
224       --separator String
225              String  to  use  to separate each column. Useful if grepping the
226              output.
227
228       --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
233       -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
238       -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
245       --unbuffered
246              Produce output immediately without sorting or aligning the  col‐
247              umns properly.
248
249       --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
256       --unquoted
257              When  used with --nameprefixes, output values in the field=value
258              pairs are not quoted.
259
260       -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
264       --version
265              Display version information.
266
267       -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

VARIABLES

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
281       Tag    Tag  name.  See lvm(8) for information about tag names and using
282              tags in place of a VG, LV or PV.
283
284       String See the option description for information about the string con‐
285              tent.
286
287       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

ENVIRONMENT VARIABLES

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

NOTES

304       The pv_attr bits are:
305
306       1  (d)uplicate, (a)llocatable, (u)sed
307
308       2  e(x)ported
309
310       3  (m)issing
311

SEE ALSO

313       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
314
315       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
316       pvremove(8), pvresize(8), pvs(8), pvscan(8),
317
318       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
323       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
324       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
325
326       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
327
328       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
329       lvmdbusd(8), fsadm(8),
330
331       lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
332       lvmvdo(7), lvmautoactivation(7)
333
334
335
336
337Red Hat, Inc.          LVM TOOLS 2.03.22(2) (2023-08-02)                PVS(8)
Impressum