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           [    --ignoreskippedcluster ]
36           [    --logonly ]
37           [    --noheadings ]
38           [    --nosuffix ]
39           [    --readonly ]
40           [    --reportformat basic|json ]
41           [    --separator String ]
42           [    --shared ]
43           [    --unbuffered ]
44           [    --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E ]
45           [ COMMON_OPTIONS ]
46           [ PV|Tag ... ]
47
48       Common options for lvm:
49           [ -d|--debug ]
50           [ -h|--help ]
51           [ -q|--quiet ]
52           [ -t|--test ]
53           [ -v|--verbose ]
54           [ -y|--yes ]
55           [    --commandprofile String ]
56           [    --config String ]
57           [    --driverloaded y|n ]
58           [    --lockopt String ]
59           [    --longhelp ]
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       -c|--colon
78              Generate colon separated output for easier parsing in scripts or
79              programs.  Also see vgs(8) which provides considerably more con‐
80              trol over the output.
81
82       -C|--columns
83              Display output in columns, the equivalent of vgs(8).  Options
84              listed are the same as options given in vgs(8).
85
86       --commandprofile String
87              The command profile to use for command configuration.  See
88              lvm.conf(5) for more information about profiles.
89
90       --config String
91              Config settings for the command. These override lvm.conf set‐
92              tings.  The String arg uses the same format as lvm.conf, or may
93              use section/field syntax.  See lvm.conf(5) for more information
94              about config.
95
96       --configreport log|vg|lv|pv|pvseg|seg
97              See lvmreport(7).
98
99       -d|--debug ...
100              Set debug level. Repeat from 1 to 6 times to increase the detail
101              of messages sent to the log file and/or syslog (if configured).
102
103       --driverloaded y|n
104              If set to no, the command will not attempt to use device-mapper.
105              For testing and debugging.
106
107       --foreign
108              Report/display foreign VGs that would otherwise be skipped.  See
109              lvmsystemid(7) for more information about foreign VGs.
110
111       -h|--help
112              Display help text.
113
114       --ignorelockingfailure
115              Allows a command to continue with read-only metadata operations
116              after locking failures.
117
118       --ignoreskippedcluster
119              Use to avoid exiting with an non-zero status code if the command
120              is run without clustered locking and clustered VGs are skipped.
121
122       --lockopt String
123              Used to pass options for special cases to lvmlockd.  See lvm‐
124              lockd(8) for more information.
125
126       --logonly
127              Suppress command report and display only log report.
128
129       --longhelp
130              Display long help text.
131
132       -m|--maps
133              Display the mapping of physical extents to LVs and logical
134              extents.
135
136       --noheadings
137              Suppress the headings line that is normally the first line of
138              output.  Useful if grepping the output.
139
140       --nosuffix
141              Suppress the suffix on output sizes. Use with --units (except h
142              and H) if processing the output.
143
144       -o|--options String
145              Comma-separated, ordered list of fields to display in columns.
146              String arg syntax is: [+|-|#]Field1[,Field2 ...]  The prefix +
147              will append the specified fields to the default fields, - will
148              remove the specified fields from the default fields, and # will
149              compact specified fields (removing them when empty for all
150              rows.)  Use -o help to view the list of all available fields.
151              Use separate lists of fields to add, remove or compact by
152              repeating the -o option: -o+field1,field2 -o-field3,field4
153              -o#field5.  These lists are evaluated from left to right.  Use
154              field name lv_all to view all LV fields, vg_all all VG fields,
155              pv_all all PV fields, pvseg_all all PV segment fields, seg_all
156              all LV segment fields, and pvseg_all all PV segment columns.
157              See the lvm.conf report section for more config options.  See
158              lvmreport(7) for more information about reporting.
159
160       --profile String
161              An alias for --commandprofile or --metadataprofile, depending on
162              the command.
163
164       -q|--quiet ...
165              Suppress output and log messages. Overrides --debug and --ver‐
166              bose.  Repeat once to also suppress any prompts with answer
167              'no'.
168
169       --readonly
170              Run the command in a special read-only mode which will read on-
171              disk metadata without needing to take any locks. This can be
172              used to peek inside metadata used by a virtual machine image
173              while the virtual machine is running.  It can also be used to
174              peek inside the metadata of clustered VGs when clustered locking
175              is not configured or running. No attempt will be made to commu‐
176              nicate with the device-mapper kernel driver, so this option is
177              unable to report whether or not LVs are actually in use.
178
179       --reportformat basic|json
180              Overrides current output format for reports which is defined
181              globally by the report/output_format setting in lvm.conf.  basic
182              is the original format with columns and rows.  If there is more
183              than one report per command, each report is prefixed with the
184              report name for identification. json produces report output in
185              JSON format. See lvmreport(7) for more information.
186
187       -S|--select String
188              Select objects for processing and reporting based on specified
189              criteria.  The criteria syntax is described by --select help and
190              lvmreport(7).  For reporting commands, one row is displayed for
191              each object matching the criteria.  See --options help for
192              selectable object fields.  Rows can be displayed with an addi‐
193              tional "selected" field (-o selected) showing 1 if the row
194              matches the selection and 0 otherwise.  For non-reporting com‐
195              mands which process LVM entities, the selection is used to
196              choose items to process.
197
198       --separator String
199              String to use to separate each column. Useful if grepping the
200              output.
201
202       --shared
203              Report/display shared VGs that would otherwise be skipped when
204              lvmlockd is not being used on the host.  See lvmlockd(8) for
205              more information about shared VGs.
206
207       -s|--short
208              Only display the size of the given PVs.
209
210       -O|--sort String
211              Comma-separated ordered list of columns to sort by. Replaces the
212              default selection. Precede any column with - for a reverse sort
213              on that column.
214
215       -t|--test
216              Run in test mode. Commands will not update metadata.  This is
217              implemented by disabling all metadata writing but nevertheless
218              returning success to the calling function. This may lead to
219              unusual error messages in multi-stage operations if a tool
220              relies on reading back metadata it believes has changed but
221              hasn't.
222
223       --unbuffered
224              Produce output immediately without sorting or aligning the col‐
225              umns properly.
226
227       --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
228              All sizes are output in these units: human-(r)eadable with '<'
229              rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
230              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
231              (e)xabytes.  Capitalise to use multiples of 1000 (S.I.) instead
232              of 1024.  Custom units can be specified, e.g. --units 3M.
233
234       -v|--verbose ...
235              Set verbose level. Repeat from 1 to 4 times to increase the
236              detail of messages sent to stdout and stderr.
237
238       --version
239              Display version information.
240
241       -y|--yes
242              Do not prompt for confirmation interactively but always assume
243              the answer yes. Use with extreme caution.  (For automatic no,
244              see -qq.)
245

VARIABLES

247       PV
248              Physical  Volume  name,  a device path under /dev.  For commands
249              managing physical extents, a PV positional arg generally accepts
250              a  suffix  indicating  a  range (or multiple ranges) of physical
251              extents (PEs). When the first PE is omitted, it defaults to  the
252              start of the device, and when the last PE is omitted it defaults
253              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
254              and length range (counting from 0): PV[:PE+PE]...
255
256       Tag
257              Tag  name.  See lvm(8) for information about tag names and using
258              tags in place of a VG, LV or PV.
259
260       String
261              See the option description for information about the string con‐
262              tent.
263
264       Size[UNIT]
265              Size  is  an  input number that accepts an optional unit.  Input
266              units are always treated as base two values, regardless of capi‐
267              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
268              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
269              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
270              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
271              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
272              e|E is exabytes.  (This should not be confused with  the  output
273              control --units, where capital letters mean multiple of 1000.)
274

ENVIRONMENT VARIABLES

276       See  lvm(8)  for  information  about environment variables used by lvm.
277       For example, LVM_VG_NAME can generally be substituted for a required VG
278       parameter.
279

SEE ALSO

281       lvm(8) lvm.conf(5) lvmconfig(8)
282
283       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
284       pvresize(8) pvs(8) pvscan(8)
285
286       vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8)  vgcreate(8)  vgcon‐
287       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
288       clone(8) vgmerge(8) vgmknodes(8)  vgreduce(8)  vgremove(8)  vgrename(8)
289       vgs(8) vgscan(8) vgsplit(8)
290
291       lvcreate(8)  lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8) lvre‐
292       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
293
294       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
295       vate(8) lvmdump(8)
296
297       dmeventd(8)  lvmetad(8)  lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8)
298       cmirrord(8) lvmdbusd(8)
299
300       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
301
302
303
304Red Hat, Inc.         LVM TOOLS 2.02.183(2) (2018-12-07)          PVDISPLAY(8)
Impressum