NAME | SYNOPSIS | DESCRIPTION | OPTIONS | SEE ALSO | COLOPHON

LVMCONFIG(8)                                                    LVMCONFIG(8)

NAME         top

       lvmconfig, lvm dumpconfig, lvm config — Display LVM configuration

SYNOPSIS         top

       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         top

       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         top

       -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         top

       lvm(8) lvmconf(8) lvm.conf(5)

COLOPHON         top

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for this
       manual page, send it to linux-lvm@redhat.com.  This page was obtained
       from the project's upstream Git repository 
       ⟨https://git.fedorahosted.org/git/lvm2.git⟩ on 2016-09-01.  If you
       discover any rendering problems in this HTML version of the page, or
       you believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org

Red Hat, Inc       LVM TOOLS 2.02.165(2)-git (2016-08-15)       LVMCONFIG(8)