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 re‐
141              peating 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 se‐
182              lectable 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 un‐
206              usual error messages in multi-stage operations if a tool relies
207              on reading back metadata it believes has changed but hasn't.
208
209       --unbuffered
210              Produce output immediately without sorting or aligning the col‐
211              umns properly.
212
213       --units r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
214              All sizes are output in these units: human-(r)eadable with '<'
215              rounding indicator, (h)uman-readable, (b)ytes, (s)ectors,
216              (k)ilobytes, (m)egabytes, (g)igabytes, (t)erabytes, (p)etabytes,
217              (e)xabytes.  Capitalise to use multiples of 1000 (S.I.) instead
218              of 1024.  Custom units can be specified, e.g. --units 3M.
219
220       --unquoted
221              When used with --nameprefixes, output values in the field=value
222              pairs are not quoted.
223
224       -v|--verbose ...
225              Set verbose level. Repeat from 1 to 4 times to increase the de‐
226              tail of messages sent to stdout and stderr.
227
228       --version
229              Display version information.
230
231       -y|--yes
232              Do not prompt for confirmation interactively but always assume
233              the answer yes. Use with extreme caution.  (For automatic no,
234              see -qq.)
235

VARIABLES

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

ENVIRONMENT VARIABLES

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

SEE ALSO

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