1LVM(FULLREPORT)                  Red Hat, Inc.                 LVM(FULLREPORT)
2
3
4

NAME

6       lvm fullreport - Display full report
7

SYNOPSIS

9       lvm fullreport
10           [ option_args ]
11           [ position_args ]
12

DESCRIPTION

14       lvm  fullreport  produces formatted output about PVs, PV segments, VGs,
15       LVs and LV segments. The information is all gathered together for  each
16       VG (under a per-VG lock) so it is consistent. Information gathered from
17       separate calls to vgs, pvs, and lvs can be inconsistent if  information
18       changes between commands.
19

USAGE

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

OPTIONS

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

VARIABLES

238       VG
239              Volume Group name.  See lvm(8) for valid names.
240
241       String
242              See the option description for information about the string con‐
243              tent.
244
245       Size[UNIT]
246              Size is an input number that accepts an  optional  unit.   Input
247              units are always treated as base two values, regardless of capi‐
248              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
249              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
250              resents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is
251              bytes,  s|S  is  sectors  of 512 bytes, k|K is kilobytes, m|M is
252              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
253              e|E  is  exabytes.  (This should not be confused with the output
254              control --units, where capital letters mean multiple of 1000.)
255

ENVIRONMENT VARIABLES

257       See lvm(8) for information about environment  variables  used  by  lvm.
258       For example, LVM_VG_NAME can generally be substituted for a required VG
259       parameter.
260

SEE ALSO

262       lvm(8) lvm.conf(5) lvmconfig(8)
263
264       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
265       pvresize(8) pvs(8) pvscan(8)
266
267       vgcfgbackup(8)  vgcfgrestore(8)  vgchange(8) vgck(8) vgcreate(8) vgcon‐
268       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
269       clone(8)  vgmerge(8)  vgmknodes(8)  vgreduce(8) vgremove(8) vgrename(8)
270       vgs(8) vgscan(8) vgsplit(8)
271
272       lvcreate(8) lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8)  lvre‐
273       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
274
275       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
276       vate(8) lvmdump(8)
277
278       dmeventd(8) lvmpolld(8)  lvmlockd(8)  lvmlockctl(8)  cmirrord(8)  lvmd‐
279       busd(8)
280
281       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
282
283
284
285LVM TOOLS 2.03.09(2) (2020-03-26)      8                       LVM(FULLREPORT)
Impressum