NAME | SYNOPSIS | DESCRIPTION | USAGE | OPTIONS | VARIABLES | ENVIRONMENT VARIABLES | SEE ALSO | COLOPHON

LVMCONFIG(8)               System Manager's Manual              LVMCONFIG(8)

NAME         top

       lvmconfig - Display and manipulate configuration information

SYNOPSIS         top

       lvmconfig
           [ option_args ]
           [ position_args ]

DESCRIPTION         top

       lvmconfig, lvm config, lvm dumpconfig (for compatibility reasons, to
       be phased out) produce formatted output from the LVM configuration
       tree. The sources of the configuration data include lvm.conf(5) and
       command line settings from --config.

USAGE         top

       lvmconfig
           [ -f|--file String ]
           [ -l|--list ]
           [    --atversion String ]
           [    --typeconfig
           current|default|diff|full|list|missing|new|profilable|profilable-
           command|profilable-metadata ]
           [    --ignoreadvanced ]
           [    --ignoreunsupported ]
           [    --ignorelocal ]
           [    --mergedconfig ]
           [    --metadataprofile String ]
           [    --sinceversion String ]
           [    --showdeprecated ]
           [    --showunsupported ]
           [    --validate ]
           [    --withsummary ]
           [    --withcomments ]
           [    --withspaces ]
           [    --unconfigured ]
           [    --withversions ]
           [ COMMON_OPTIONS ]
           [ String ... ]

       Common options for lvm:
           [ -d|--debug ]
           [ -h|--help ]
           [ -q|--quiet ]
           [ -t|--test ]
           [ -v|--verbose ]
           [ -y|--yes ]
           [    --commandprofile String ]
           [    --config String ]
           [    --driverloaded y|n ]
           [    --longhelp ]
           [    --profile String ]
           [    --version ]

OPTIONS         top

       --atversion String
              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.

       --commandprofile String
              The command profile to use for command configuration.  See
              lvm.conf(5) for more information about profiles.

       --config String
              Config settings for the command. These override lvm.conf
              settings.  The String arg uses the same format as lvm.conf, or
              may use section/field syntax.  See lvm.conf(5) for more
              information about config.

       -d|--debug ...
              Set debug level. Repeat from 1 to 6 times to increase the
              detail of messages sent to the log file and/or syslog (if
              configured).

       --driverloaded y|n
              If set to no, the command will not attempt to use device-
              mapper.  For testing and debugging.

       -f|--file String
              Write output to the named file.

       -h|--help
              Display help text.

       --ignoreadvanced
              Exclude advanced configuration settings from the output.

       --ignorelocal
              Ignore local section.

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

       -l|--list
              List config settings with summarizing comment. This is the
              same as using options --typeconfig list --withsummary.

       --longhelp
              Display long help text.

       --mergedconfig
              When the command is run with --config and/or --commandprofile
              (or using LVM_COMMAND_PROFILE environment variable),
              --profile, or --metadataprofile, merge all the contents of the
              "config cascade" before displaying it.  Without merging, only
              the configuration at the front of the cascade is displayed.
              See lvm.conf(5) for more information about config.

       --metadataprofile String
              The metadata profile to use for command configuration.  See
              lvm.conf(5) for more information about profiles.

       --profile String
              An alias for --commandprofile or --metadataprofile, depending
              on the command.

       -q|--quiet ...
              Suppress output and log messages. Overrides --debug and
              --verbose.  Repeat once to also suppress any prompts with
              answer 'no'.

       --showdeprecated
              Include deprecated configuration settings in the output. These
              settings are deprecated after a certain version. If a concrete
              version is specified with --atversion, deprecated settings are
              automatically included if the specified version is lower than
              the version in which the settings were deprecated. The current
              and diff types include deprecated settings in 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.

       --sinceversion String
              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
              --typeconfig new to display all configuration settings
              introduced since given version.

       -t|--test
              Run in test mode. Commands will not update metadata.  This is
              implemented by disabling all metadata writing but nevertheless
              returning success to the calling function. This may lead to
              unusual error messages in multi-stage operations if a tool
              relies on reading back metadata it believes has changed but
              hasn't.

       --typeconfig
              current|default|diff|full|list|missing|new|profilable|profilable-
              command|profilable-metadata
              See lvmreport(7).

       --unconfigured
              Internal option used for generating config file during build.

       --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, also use --mergedconfig.  The
              validation is done even if lvm.conf config/checks is disabled.

       -v|--verbose ...
              Set verbose level. Repeat from 1 to 4 times to increase the
              detail of messages sent to stdout and stderr.

       --version
              Display version information.

       --withcomments
              Display a full comment for each configuration node. For
              deprecated settings, also display comments about deprecation.

       --withspaces
              Where appropriate, add more spaces in output for better
              readability.

       --withsummary
              Display a one line comment for each configuration node.

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

       -y|--yes
              Do not prompt for confirmation interactively but always assume
              the answer yes. Use with extreme caution.  (For automatic no,
              see -qq.)

VARIABLES         top

       String
              See the option description for information about the string
              content.

       Size[UNIT]
              Size is an input number that accepts an optional unit.  Input
              units are always treated as base two values, regardless of
              capitalization, e.g. 'k' and 'K' both refer to 1024.  The
              default input unit is specified by letter, followed by |UNIT.
              UNIT represents other possible input units: bBsSkKmMgGtTpPeE.
              b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
              m|M is megabytes, g|G is gigabytes, t|T is terabytes, p|P is
              petabytes, e|E is exabytes.  (This should not be confused with
              the output control --units, where capital letters mean
              multiple of 1000.)

ENVIRONMENT VARIABLES         top

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

SEE ALSO         top

       lvm(8) lvm.conf(5) lvmconfig(8)

       pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
       pvresize(8) pvs(8) pvscan(8)

       vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8)
       vgconvert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8)
       vgimportclone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8)
       vgrename(8) vgs(8) vgscan(8) vgsplit(8)

       lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8)
       lvreduce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)

       lvm2-activation-generator(8) blkdeactivate(8) lvmdump(8)

       dmeventd(8) lvmetad(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) clvmd(8)
       cmirrord(8) lvmdbusd(8)

       lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)

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 
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2017-05-03.  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.171(2)-git (2017-04-13)       LVMCONFIG(8)

Pages that refer to this page: lvm.conf(5)lvmreport(7)lvmthin(7)lvchange(8)lvconvert(8)lvcreate(8)lvdisplay(8)lvextend(8)lvm(8)lvmconfig(8)lvmdiskscan(8)lvmetad(8)lvm-fullreport(8)lvm-lvpoll(8)lvreduce(8)lvremove(8)lvrename(8)lvresize(8)lvs(8)lvscan(8)pvchange(8)pvck(8)pvcreate(8)pvdisplay(8)pvmove(8)pvremove(8)pvresize(8)pvs(8)pvscan(8)vgcfgbackup(8)vgcfgrestore(8)vgchange(8)vgck(8)vgconvert(8)vgcreate(8)vgdisplay(8)vgexport(8)vgextend(8)vgimport(8)vgimportclone(8)vgmerge(8)vgmknodes(8)vgreduce(8)vgremove(8)vgrename(8)vgs(8)vgscan(8)vgsplit(8)