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

NAME

6       pvdisplay — Display various attributes of physical volume(s)
7

SYNOPSIS

9       pvdisplay
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       pvdisplay shows the attributes of PVs, like size, physical extent size,
15       space used for the VG descriptor area, etc.
16
17       pvs(8) is a preferred alternative that shows the same  information  and
18       more, using a more compact and configurable output format.
19

USAGE

21       pvdisplay
22           [ -a|--all ]
23           [ -c|--colon ]
24           [ -C|--columns ]
25           [ -m|--maps ]
26           [ -o|--options String ]
27           [ -S|--select String ]
28           [ -s|--short ]
29           [ -O|--sort String ]
30           [    --aligned ]
31           [    --binary ]
32           [    --configreport log|vg|lv|pv|pvseg|seg ]
33           [    --foreign ]
34           [    --ignorelockingfailure ]
35           [    --logonly ]
36           [    --noheadings ]
37           [    --nosuffix ]
38           [    --readonly ]
39           [    --reportformat basic|json|json_std ]
40           [    --separator String ]
41           [    --shared ]
42           [    --unbuffered ]
43           [    --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
44           [ COMMON_OPTIONS ]
45           [ PV|Tag ... ]
46
47       Common options for lvm:
48           [ -d|--debug ]
49           [ -h|--help ]
50           [ -q|--quiet ]
51           [ -t|--test ]
52           [ -v|--verbose ]
53           [ -y|--yes ]
54           [    --commandprofile String ]
55           [    --config String ]
56           [    --devices PV ]
57           [    --devicesfile String ]
58           [    --driverloaded y|n ]
59           [    --journal String ]
60           [    --lockopt String ]
61           [    --longhelp ]
62           [    --nohints ]
63           [    --nolocking ]
64           [    --profile String ]
65           [    --version ]
66

OPTIONS

68       --aligned
69              Use with --separator to align the output columns
70
71       -a|--all
72              Show information about devices that have not been initialized by
73              LVM, i.e. they are not PVs.
74
75       --binary
76              Use binary values "0" or "1" instead of descriptive literal val‐
77              ues  for  columns  that  have exactly two valid values to report
78              (not counting the "unknown" value which denotes that  the  value
79              could not be determined).
80
81       -c|--colon
82              Generate colon separated output for easier parsing in scripts or
83              programs.  Also see vgs(8) which provides considerably more con‐
84              trol over the output.
85
86       -C|--columns
87              Display  output  in  columns, the equivalent of vgs(8).  Options
88              listed are the same as options given in vgs(8).
89
90       --commandprofile String
91              The command profile  to  use  for  command  configuration.   See
92              lvm.conf(5) for more information about profiles.
93
94       --config String
95              Config settings for the command. These override lvm.conf(5) set‐
96              tings.  The String arg uses the same format as  lvm.conf(5),  or
97              may use section/field syntax.  See lvm.conf(5) for more informa‐
98              tion about config.
99
100       --configreport log|vg|lv|pv|pvseg|seg
101              See lvmreport(7).
102
103       -d|--debug ...
104              Set debug level. Repeat from 1 to 6 times to increase the detail
105              of messages sent to the log file and/or syslog (if configured).
106
107       --devices PV
108              Restricts  the  devices  that  are visible and accessible to the
109              command.  Devices not listed will appear to be missing. This op‐
110              tion  can  be repeated, or accepts a comma separated list of de‐
111              vices. This overrides the devices file.
112
113       --devicesfile String
114              A file listing devices that LVM should use.  The file must exist
115              in  /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
116              mand.  This overrides the  lvm.conf(5)  devices/devicesfile  and
117              devices/use_devicesfile settings.
118
119       --driverloaded y|n
120              If set to no, the command will not attempt to use device-mapper.
121              For testing and debugging.
122
123       --foreign
124              Report/display foreign VGs that would otherwise be skipped.  See
125              lvmsystemid(7) for more information about foreign VGs.
126
127       -h|--help
128              Display help text.
129
130       --ignorelockingfailure
131              Allows  a command to continue with read-only metadata operations
132              after locking failures.
133
134       --journal String
135              Record information in the systemd journal.  This information  is
136              in  addition  to information enabled by the lvm.conf log/journal
137              setting.  command: record information about the  command.   out‐
138              put: record the default command output.  debug: record full com‐
139              mand debugging.
140
141       --lockopt String
142              Used to pass options for special cases to  lvmlockd.   See  lvm‐
143              lockd(8) for more information.
144
145       --logonly
146              Suppress command report and display only log report.
147
148       --longhelp
149              Display long help text.
150
151       -m|--maps
152              Display  the  mapping of physical extents to LVs and logical ex‐
153              tents.
154
155       --noheadings
156              Suppress the headings line that is normally the  first  line  of
157              output.  Useful if grepping the output.
158
159       --nohints
160              Do  not  use the hints file to locate devices for PVs. A command
161              may read more devices to find PVs when hints are not  used.  The
162              command will still perform standard hint file invalidation where
163              appropriate.
164
165       --nolocking
166              Disable locking. Use with caution, concurrent commands may  pro‐
167              duce incorrect results.
168
169       --nosuffix
170              Suppress  the suffix on output sizes. Use with --units (except h
171              and H) if processing the output.
172
173       -o|--options String
174              Comma-separated, ordered list of fields to display  in  columns.
175              String  arg  syntax is: [+|-|#]Field1[,Field2 ...]  The prefix +
176              will append the specified fields to the default fields,  -  will
177              remove  the specified fields from the default fields, and # will
178              compact specified fields  (removing  them  when  empty  for  all
179              rows.)   Use  -o  help to view the list of all available fields.
180              Use separate lists of fields to add, remove or  compact  by  re‐
181              peating   the   -o   option:  -o+field1,field2  -o-field3,field4
182              -o#field5.  These lists are evaluated from left to  right.   Use
183              field  name  lv_all to view all LV fields, vg_all all VG fields,
184              pv_all all PV fields, pvseg_all all PV segment  fields,  seg_all
185              all  LV  segment  fields,  and pvseg_all all PV segment columns.
186              See the lvm.conf(5) report section for more config options.  See
187              lvmreport(7) for more information about reporting.
188
189       --profile String
190              An alias for --commandprofile or --metadataprofile, depending on
191              the command.
192
193       -q|--quiet ...
194              Suppress output and log messages. Overrides --debug  and  --ver‐
195              bose.   Repeat  once  to  also  suppress any prompts with answer
196              'no'.
197
198       --readonly
199              Run the command in a special read-only mode which will read  on-
200              disk  metadata  without  needing  to take any locks. This can be
201              used to peek inside metadata used by  a  virtual  machine  image
202              while the virtual machine is running. No attempt will be made to
203              communicate with the device-mapper kernel driver, so this option
204              is unable to report whether or not LVs are actually in use.
205
206       --reportformat basic|json|json_std
207              Overrides  current  output  format  for reports which is defined
208              globally by the  report/output_format  setting  in  lvm.conf(5).
209              basic is the original format with columns and rows.  If there is
210              more than one report per command, each report is  prefixed  with
211              the  report name for identification. json produces report output
212              in JSON format. json_std produces report output in  JSON  format
213              which  is  more  compliant with JSON standard.  See lvmreport(7)
214              for more information.
215
216       -S|--select String
217              Select objects for processing and reporting based  on  specified
218              criteria.  The criteria syntax is described by --select help and
219              lvmreport(7).  For reporting commands, one row is displayed  for
220              each  object  matching the criteria.  See --options help for se‐
221              lectable object fields.  Rows can be displayed with an addition‐
222              al  "selected"  field (-o selected) showing 1 if the row matches
223              the selection and 0 otherwise.  For non-reporting commands which
224              process  LVM  entities, the selection is used to choose items to
225              process.
226
227       --separator String
228              String to use to separate each column. Useful  if  grepping  the
229              output.
230
231       --shared
232              Report/display  shared  VGs that would otherwise be skipped when
233              lvmlockd is not being used on the  host.   See  lvmlockd(8)  for
234              more information about shared VGs.
235
236       -s|--short
237              Only display the size of the given PVs.
238
239       -O|--sort String
240              Comma-separated ordered list of columns to sort by. Replaces the
241              default selection. Precede any column with - for a reverse  sort
242              on that column.
243
244       -t|--test
245              Run  in  test  mode. Commands will not update metadata.  This is
246              implemented by disabling all metadata writing  but  nevertheless
247              returning  success to the calling function. This may lead to un‐
248              usual error messages in multi-stage operations if a tool  relies
249              on reading back metadata it believes has changed but hasn't.
250
251       --unbuffered
252              Produce  output immediately without sorting or aligning the col‐
253              umns properly.
254
255       --units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
256              All sizes are output in these units: human-(r)eadable  with  '<'
257              rounding   indicator,   (h)uman-readable,   (b)ytes,  (s)ectors,
258              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
259              (e)xabytes.   Capitalise to use multiples of 1000 (S.I.) instead
260              of 1024.  Custom units can be specified, e.g. --units 3M.
261
262       -v|--verbose ...
263              Set verbose level. Repeat from 1 to 4 times to increase the  de‐
264              tail of messages sent to stdout and stderr.
265
266       --version
267              Display version information.
268
269       -y|--yes
270              Do  not  prompt for confirmation interactively but always assume
271              the answer yes. Use with extreme caution.   (For  automatic  no,
272              see -qq.)
273

VARIABLES

275       PV     Physical  Volume  name,  a device path under /dev.  For commands
276              managing physical extents, a PV positional arg generally accepts
277              a suffix indicating a range (or multiple ranges) of physical ex‐
278              tents (PEs). When the first PE is omitted, it  defaults  to  the
279              start of the device, and when the last PE is omitted it defaults
280              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
281              and length range (counting from 0): PV[:PE+PE]...
282
283       Tag    Tag  name.  See lvm(8) for information about tag names and using
284              tags in place of a VG, LV or PV.
285
286       String See the option description for information about the string con‐
287              tent.
288
289       Size[UNIT]
290              Size  is  an  input number that accepts an optional unit.  Input
291              units are always treated as base two values, regardless of capi‐
292              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
293              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
294              resents other possible input units: b|B is bytes, s|S is sectors
295              of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB,  t|T  is  TiB,
296              p|P  is  PiB, e|E is EiB.  (This should not be confused with the
297              output control --units, where capital letters mean  multiple  of
298              1000.)
299

ENVIRONMENT VARIABLES

301       See  lvm(8)  for  information  about environment variables used by lvm.
302       For example, LVM_VG_NAME can generally be substituted for a required VG
303       parameter.
304

SEE ALSO

306       lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
307
308       pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
309       pvremove(8), pvresize(8), pvs(8), pvscan(8),
310
311       vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
312       vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
313       vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
314       vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
315
316       lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
317       lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
318
319       lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
320
321       dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
322       lvmdbusd(8), fsadm(8),
323
324       lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
325
326
327
328Red Hat, Inc.        LVM TOOLS 2.03.18(2)-git (2022-11-10)        PVDISPLAY(8)
Impressum