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 ]
40           [    --separator String ]
41           [    --shared ]
42           [    --unbuffered ]
43           [    --units 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           [    --driverloaded y|n ]
57           [    --lockopt String ]
58           [    --longhelp ]
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       -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       --lockopt String
119              Used to pass options for special cases to lvmlockd.  See lvm‐
120              lockd(8) for more information.
121
122       --logonly
123              Suppress command report and display only log report.
124
125       --longhelp
126              Display long help text.
127
128       -m|--maps
129              Display the mapping of physical extents to LVs and logical
130              extents.
131
132       --noheadings
133              Suppress the headings line that is normally the first line of
134              output.  Useful if grepping the output.
135
136       --nolocking
137              Disable locking.
138
139       --nosuffix
140              Suppress the suffix on output sizes. Use with --units (except h
141              and H) if processing the output.
142
143       -o|--options String
144              Comma-separated, ordered list of fields to display in columns.
145              String arg syntax is: [+|-|#]Field1[,Field2 ...]  The prefix +
146              will append the specified fields to the default fields, - will
147              remove the specified fields from the default fields, and # will
148              compact specified fields (removing them when empty for all
149              rows.)  Use -o help to view the list of all available fields.
150              Use separate lists of fields to add, remove or compact by
151              repeating the -o option: -o+field1,field2 -o-field3,field4
152              -o#field5.  These lists are evaluated from left to right.  Use
153              field name lv_all to view all LV fields, vg_all all VG fields,
154              pv_all all PV fields, pvseg_all all PV segment fields, seg_all
155              all LV segment fields, and pvseg_all all PV segment columns.
156              See the lvm.conf report section for more config options.  See
157              lvmreport(7) for more information about reporting.
158
159       --profile String
160              An alias for --commandprofile or --metadataprofile, depending on
161              the command.
162
163       -q|--quiet ...
164              Suppress output and log messages. Overrides --debug and --ver‐
165              bose.  Repeat once to also suppress any prompts with answer
166              'no'.
167
168       --readonly
169              Run the command in a special read-only mode which will read on-
170              disk metadata without needing to take any locks. This can be
171              used to peek inside metadata used by a virtual machine image
172              while the virtual machine is running. No attempt will be made to
173              communicate with the device-mapper kernel driver, so this option
174              is unable to report whether or not LVs are actually in use.
175
176       --reportformat basic|json
177              Overrides current output format for reports which is defined
178              globally by the report/output_format setting in lvm.conf.  basic
179              is the original format with columns and rows.  If there is more
180              than one report per command, each report is prefixed with the
181              report name for identification. json produces report output in
182              JSON format. See lvmreport(7) for more information.
183
184       -S|--select String
185              Select objects for processing and reporting based on specified
186              criteria.  The criteria syntax is described by --select help and
187              lvmreport(7).  For reporting commands, one row is displayed for
188              each object matching the criteria.  See --options help for
189              selectable object fields.  Rows can be displayed with an addi‐
190              tional "selected" field (-o selected) showing 1 if the row
191              matches the selection and 0 otherwise.  For non-reporting com‐
192              mands which process LVM entities, the selection is used to
193              choose items to process.
194
195       --separator String
196              String to use to separate each column. Useful if grepping the
197              output.
198
199       --shared
200              Report/display shared VGs that would otherwise be skipped when
201              lvmlockd is not being used on the host.  See lvmlockd(8) for
202              more information about shared VGs.
203
204       -s|--short
205              Only display the size of the given PVs.
206
207       -O|--sort String
208              Comma-separated ordered list of columns to sort by. Replaces the
209              default selection. Precede any column with - for a reverse sort
210              on that column.
211
212       -t|--test
213              Run in test mode. Commands will not update metadata.  This is
214              implemented by disabling all metadata writing but nevertheless
215              returning success to the calling function. This may lead to
216              unusual error messages in multi-stage operations if a tool
217              relies on reading back metadata it believes has changed but
218              hasn't.
219
220       --unbuffered
221              Produce output immediately without sorting or aligning the col‐
222              umns properly.
223
224       --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
225              All sizes are output in these units: human-(r)eadable with '<'
226              rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
227              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
228              (e)xabytes.  Capitalise to use multiples of 1000 (S.I.) instead
229              of 1024.  Custom units can be specified, e.g. --units 3M.
230
231       -v|--verbose ...
232              Set verbose level. Repeat from 1 to 4 times to increase the
233              detail of messages sent to stdout and stderr.
234
235       --version
236              Display version information.
237
238       -y|--yes
239              Do not prompt for confirmation interactively but always assume
240              the answer yes. Use with extreme caution.  (For automatic no,
241              see -qq.)
242

VARIABLES

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

ENVIRONMENT VARIABLES

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

SEE ALSO

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