lvmconfig(8)
NAME
lvmconfig, lvm dumpconfig, lvm config --- Display LVM configuration
SYNOPSIS
lvmconfig [-f|--file Filename] [--type {current|default|diff|full|
list|missing|new|profilable|profilable-command|profilable-metadata}]
[--atversion Version] [--sinceversion Version] [--ignoreadvanced]
[--ignoreunsupported] [--ignorelocal] [-l|--list] [--config
ConfigurationString] [--commandprofile ProfileName] [--profile
ProfileName] [--metadataprofile ProfileName] [--mergedconfig]
[--showdeprecated] [--showunsupported] [--validate] [--withsummary]
[--withcomments] [--withspaces] [--withversions] [ConfigurationNode...]
DESCRIPTION
lvmconfig produces formatted output from the LVM configuration tree.
The command was added in release 2.02.119 and has an identical longer
form lvm dumpconfig.
OPTIONS
-f, --file Filename
Send output to a file named 'filename'.
-l, --list
List configuration settings with summarizing comment. This is
the same as using lvmconfig --type list --withsummary.
--type {current|default|diff|full|missing|new|profilable|profilable-
command|profilable-metadata}
Select the type of configuration to display. The configuration
settings displayed have either default values or currently-used
values assigned based on the type selected. If no type is
selected, --type current is used by default. Whenever a
configuration setting with a default value is commented out, it
means the setting does not have any concrete default value
defined. Output can be saved and used as a proper lvm.conf(5)
file.
current
Display the current lvm.conf configuration merged with any
tag config if used. See also lvm.conf(5) for more info about
LVM configuration methods.
default
Display all possible configuration settings with default
values assigned.
diff
Display all configuration settings for which the values used
differ from defaults. The value assigned for each
configuration setting is the value currently used. Using
this type also implies the use of --mergedconfig option.
This is actually minimal LVM configuration which can be used
without a change to current configured behaviour.
full
Display full configuration tree - a combination of current
configuration tree (--type current) and tree of settings for
which default values are used (--type missing). This is
exactly the configuration tree that LVM2 uses during command
execution. Using this type also implies the use of
--mergedconfig option. If comments are displayed (see
--withcomments and --withsummary options), then for each
setting found in existing configuration and for which
defaults are not used, there's an extra comment line printed
to denote this.
list
Display plain list of configuration settings.
missing
Display all configuration settings with default values
assigned which are missing in the configuration currently
used and for which LVM automatically fallbacks to using these
default values.
new
Display all new configuration settings introduced in current
LVM version or specific version as defined by --atversion
option.
profilable
Display all profilable configuration settings with default
values assigned. See lvm.conf(5) for more info about profile
config method.
profilable-command
Display all profilable configuration settings with default
values assigned that can be used in command profile. This is
a subset of settings displayed by --type profilable.
profilable-metadata
Display all profilable configuration settings with default
values assigned that can be used in metadata profile. This is
a subset of settings displayed by --type profilable.
--atversion Version
Specify an LVM version in x.y.z format where x is the major
version, the y is the minor version and z is the patchlevel
(e.g. 2.2.106). When configuration is displayed, the
configuration settings recognized at this LVM version will be
considered only. This can be used to display a configuration
that a certain LVM version understands and which does not
contain any newer settings for which LVM would issue a warning
message when checking the configuration.
--sinceversion Version
Specify an LVM version in x.y.z format where x is the major
version, the y is the minor version and z is the patchlevel
(e.g. 2.2.106). This option is currently applicable only with
--type new to display all configuration settings introduced
since given version.
--ignoreadvanced
Exclude advanced configuration settings from the output.
--ignoreunsupported
Exclude unsupported configuration settings from the output.
These settings are either used for debugging and development
purposes only or their support is not yet complete and they are
not meant to be used in production. The current and diff types
include unsupported settings in their output by default, all the
other types ignore unsupported settings.
--ignorelocal
Ignore local section.
--config ConfigurationString
Use ConfigurationString to override existing configuration.
This configuration is then applied for the lvmconfig command
itself. See also lvm.conf(5) for more info about config
cascade.
--commandprofile ProfileName
Use ProfileName to override existing configuration. This
configuration is then applied for the lvmconfig command itself.
See also --mergedconfig option and lvm.conf(5) for more info
about config cascade.
--profile ProfileName
The same as using --commandprofile but the configuration is not
applied for the lvmconfig command itself.
--metadataprofile ProfileName
Use ProfileName to override existing configuration. The
configuration defined in metadata profile has no effect for the
lvmconfig command itself. lvmconfig displays the configuration
only. See also --mergedconfig option and lvm.conf(5) for more
info about config cascade.
--mergedconfig
When the lvmconfig command is run with the --config option
and/or --commandprofile (or using LVM_COMMAND_PROFILE
environment variable), --profile, --metadataprofile option,
merge all the contents of the config cascade before displaying
it. Without the --mergeconfig option used, only the
configuration at the front of the cascade is displayed. See also
lvm.conf(5) for more info about config cascade.
--showdeprecated
Include deprecated configuration settings in the output. These
settings are always deprecated since certain version. If
concrete version is specified with --atversion option,
deprecated settings are automatically included if specified
version is lower that the version in which the settings were
deprecated. The current and diff types include deprecated
settings int their output by default, all the other types ignore
deprecated settings.
--showunsupported
Include unsupported configuration settings in the output. These
settings are either used for debugging or development purposes
only or their support is not yet complete and they are not meant
to be used in production. The current and diff types include
unsupported settings in their output by default, all the other
types ignore unsupported settings.
--validate
Validate current configuration used and exit with appropriate
return code. The validation is done only for the configuration
at the front of the config cascade. To validate the whole merged
configuration tree, use also the --mergedconfig option. The
validation is done even if config/checks lvm.conf(5) option is
disabled.
--withsummary
Display a one line comment for each configuration node.
--withcomments
Display a full comment for each configuration node. For
deprecated settings, also display comments about deprecation in
addition.
--withspaces
Where appropriate, add more spaces in output for better
readability.
--withversions
Also display a comment containing the version of introduction
for each configuration node. If the setting is deprecated, also
display the version since which it is deprecated.
SEE ALSO
lvm(8) lvmconf(8) lvm.conf(5)
Free and Open Source Software