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

VARIABLES

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

ENVIRONMENT VARIABLES

262       See  lvm(8)  for  information  about environment variables used by lvm.
263       For example, LVM_VG_NAME can generally be substituted for a required VG
264       parameter.
265

SEE ALSO

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