1LVMCONFIG(8) LVMCONFIG(8)
2
6 lvmconfig, lvm dumpconfig, lvm config — Display LVM configuration
7
9 lvmconfig [-f|--file filename] [--type {cur‐
10 rent|default|diff|full|list|miss‐
11 ing|new|profilable|profilable-command|profilable-metadata} [--atversion
12 version] [----sinceversion version] [--ignoreadvanced] [--ignoreunsup‐
13 ported] [--ignorelocal] [-l|--list] [--config ConfigurationString]
14 [--commandprofile ProfileName] [--profile ProfileName] [--metadatapro‐
15 file ProfileName] [--mergedconfig] [--showdeprecated] [--showunsup‐
16 ported] [--validate] [--withsummary] [--withcomments] [--withspaces]
17 [--withversions] [ConfigurationNode...]
18
21 lvmconfig produces formatted output from the LVM configuration tree.
22 The command was added in release 2.02.119 and has an identical longer
23 form lvm dumpconfig.
24
27 -f, --file filename
28 Send output to a file named 'filename'.
29 -l, --list
32 List configuration settings with summarizing comment. This is
33 the same as using lvmconfig --type list --withsummary.
34 --type {current|default|diff|full|missing|new|profilable|profilable-
37 command|profilable-metadata}
38 Select the type of configuration to display. The configuration
39 settings displayed have either default values or currently-used
40 values assigned based on the type selected. If no type is
41 selected, --type current is used by default. Whenever a configu‐
42 ration setting with a default value is commented out, it means
43 the setting does not have any concrete default value defined.
44 Output can be saved and used as a proper lvm.conf(5) file.
45 current
47 Display the current lvm.conf configuration merged with any
48 tag config if used. See also lvm.conf(5) for more info about
49 LVM configuration methods.
50 default
52 Display all possible configuration settings with default val‐
53 ues assigned.
54 diff
56 Display all configuration settings for which the values used
57 differ from defaults. The value assigned for each configura‐
58 tion setting is the value currently used. This is actually
59 minimal LVM configuration which can be used without a change
60 to current configured behaviour.
61 full
63 Display full configuration tree - a combination of current
64 configuration tree (--type current) and tree of settings for
65 which default values are used (--type missing). This is
66 exactly the configuration tree that LVM2 uses during command
67 execution. Using this type also implies the use of --merged‐
68 config option. If comments are displayed (see --withcomments
69 and --withsummary options), then for each setting found in
70 existing configuration and for which defaults are not used,
71 there's an extra comment line printed to denote this.
72 list
74 Display plain list of configuration settings.
75 missing
77 Display all configuration settings with default values
78 assigned which are missing in the configuration currently
79 used and for which LVM automatically fallbacks to using these
80 default values.
81 new
83 Display all new configuration settings introduced in current
84 LVM version or specific version as defined by --atversion
85 option.
86 profilable
88 Display all profilable configuration settings with default
89 values assigned. See lvm.conf(5) for more info about profile
90 config method.
91 profilable-command
93 Display all profilable configuration settings with default
94 values assigned that can be used in command profile. This is
95 a subset of settings displayed by --type --profilable.
96 profilable-metadata
98 Display all profilable configuration settings with default
99 values assigned that can be used in metadata profile. This is
100 a subset of settings displayed by --type --profilable.
101 --atversion version
104 Specify an LVM version in x.y.z format where x is the major ver‐
105 sion, the y is the minor version and z is the patchlevel (e.g.
106 2.2.106). When configuration is displayed, the configuration
107 settings recognized at this LVM version will be considered only.
108 This can be used to display a configuration that a certain LVM
109 version understands and which does not contain any newer set‐
110 tings for which LVM would issue a warning message when checking
111 the configuration.
112 --sinceversion version
115 Specify an LVM version in x.y.z format where x is the major ver‐
116 sion, the y is the minor version and z is the patchlevel (e.g.
117 2.2.106). This option is currently applicable only with --type
118 new to display all configuration settings introduced since given
119 version.
120 --ignoreadvanced
123 Exclude advanced configuration settings from the output.
124 --ignoreunsupported
127 Exclude unsupported configuration settings from the output.
128 These settings are either used for debugging and development
129 purposes only or their support is not yet complete and they are
130 not meant to be used in production. The current and diff types
131 include unsupported settings in their output by default, all the
132 other types ignore unsupported settings.
133 --ignorelocal
136 Ignore local section.
137 --config ConfigurationString
140 Use ConfigurationString to override existing configuration.
141 This configuration is then applied for the lvmconfig command
142 itself. See also lvm.conf(5) for more info about config cas‐
143 cade.
144 --commandprofile ProfileName
147 Use ProfileName to override existing configuration. This con‐
148 figuration is then applied for the lvmconfig command itself.
149 See also --mergedconfig option and lvm.conf(5) for more info
150 about config cascade.
151 --profile ProfileName
154 The same as using --commandprofile but the configuration is not
155 applied for the lvmconfig command itself.
156 --metadataprofile ProfileName
159 Use ProfileName to override existing configuration. The config‐
160 uration defined in metadata profile has no effect for the lvm‐
161 config command itself. lvmconfig displays the configuration
162 only. See also --mergedconfig option and lvm.conf(5) for more
163 info about config cascade.
164 --mergedconfig
167 When the lvmconfig command is run with the --config option
168 and/or --commandprofile (or using LVM_COMMAND_PROFILE environ‐
169 ment variable), --profile, --metadataprofile option, merge all
170 the contents of the config cascade before displaying it. With‐
171 out the --mergeconfig option used, only the configuration at the
172 front of the cascade is displayed. See also lvm.conf(5) for more
173 info about config cascade.
174 --showdeprecated
177 Include deprecated configuration settings in the output. These
178 settings are always deprecated since certain version. If con‐
179 crete version is specified with --atversion option, deprecated
180 settings are automatically included if specified version is
181 lower that the version in which the settings were deprecated.
182 The current and diff types include deprecated settings int their
183 output by default, all the other types ignore deprecated set‐
184 tings.
185 --showunsupported
188 Include unsupported configuration settings in the output. These
189 settings are either used for debugging or development purposes
190 only or their support is not yet complete and they are not meant
191 to be used in production. The current and diff types include
192 unsupported settings in their output by default, all the other
193 types ignore unsupported settings.
194 --validate
197 Validate current configuration used and exit with appropriate
198 return code. The validation is done only for the configuration
199 at the front of the config cascade. To validate the whole merged
200 configuration tree, use also the --mergedconfig option. The
201 validation is done even if config/checks lvm.conf(5) option is
202 disabled.
203 --withsummary
206 Display a one line comment for each configuration node.
207 --withcomments
210 Display a full comment for each configuration node. For depre‐
211 cated settings, also display comments about deprecation in addi‐
212 tion.
213 --withspaces
216 Where appropriate, add more spaces in output for better read‐
217 ability.
218 --withversions
221 Also display a comment containing the version of introduction
222 for each configuration node. If the setting is deprecated, also
223 display the version since which it is deprecated.
224
227 lvm(8) lvmconf(8) lvm.conf(5)
228Red Hat, Inc LVM TOOLS 2.02.143(2)-RHEL6 (2016-12-13) LVMCONFIG(8)