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           [    --ignoreskippedcluster ]
32           [    --logonly ]
33           [    --nameprefixes ]
34           [    --noheadings ]
35           [    --nolocking ]
36           [    --nosuffix ]
37           [    --readonly ]
38           [    --reportformat basic|json ]
39           [    --rows ]
40           [    --separator String ]
41           [    --shared ]
42           [    --trustcache ]
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           [    --unquoted ]
46           [ COMMON_OPTIONS ]
47           [ VG ... ]
48
49       Common options for lvm:
50           [ -d|--debug ]
51           [ -h|--help ]
52           [ -q|--quiet ]
53           [ -t|--test ]
54           [ -v|--verbose ]
55           [ -y|--yes ]
56           [    --commandprofile String ]
57           [    --config String ]
58           [    --driverloaded y|n ]
59           [    --lockopt String ]
60           [    --longhelp ]
61           [    --profile String ]
62           [    --version ]
63

OPTIONS

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

VARIABLES

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

ENVIRONMENT VARIABLES

269       See lvm(8) for information about environment  variables  used  by  lvm.
270       For example, LVM_VG_NAME can generally be substituted for a required VG
271       parameter.
272

SEE ALSO

274       lvm(8) lvm.conf(5) lvmconfig(8)
275
276       pvchange(8)  pvck(8)  pvcreate(8)  pvdisplay(8)  pvmove(8)  pvremove(8)
277       pvresize(8) pvs(8) pvscan(8)
278
279       vgcfgbackup(8)  vgcfgrestore(8)  vgchange(8) vgck(8) vgcreate(8) vgcon‐
280       vert(8)  vgdisplay(8)  vgexport(8)  vgextend(8)  vgimport(8)  vgimport‐
281       clone(8)  vgmerge(8)  vgmknodes(8)  vgreduce(8) vgremove(8) vgrename(8)
282       vgs(8) vgscan(8) vgsplit(8)
283
284       lvcreate(8) lvchange(8)  lvconvert(8)  lvdisplay(8)  lvextend(8)  lvre‐
285       duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
286
287       lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
288       vate(8) lvmdump(8)
289
290       dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8)  lvmlockctl(8)  clvmd(8)
291       cmirrord(8) lvmdbusd(8)
292
293       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
294
295
296
297LVM TOOLS 2.02.180(2)-RHEL7 (2018-07-20)8                       LVM(FULLREPORT)
Impressum