1LVM(FULLREPORT) Red Hat, Inc. LVM(FULLREPORT)
2
3
4
6 lvm fullreport - Display full report
7
9 lvm fullreport
10 [ option_args ]
11 [ position_args ]
12
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
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
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
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
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
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)