LVM.CONF(5)    (LVM TOOLS 2.03.11(2) (2021-01-08))    LVM.CONF(5)

     NAME
          lvm.conf - Configuration file for LVM2

     SYNOPSIS
          /etc/lvm/lvm.conf

     DESCRIPTION
          lvm.conf is loaded during the initialisation phase of
          lvm(8).  This file can in turn lead to other files being
          loaded - settings read in later override earlier settings.
          File timestamps are checked between commands and if any have
          changed, all the files are reloaded.

          For a description of each lvm.conf setting, run:

          lvmconfig --typeconfig default --withcomments --withspaces

          The settings defined in lvm.conf can be overridden by any of
          these extended configuration methods:

          direct config override on command line
               The --config ConfigurationString command line option
               takes the ConfigurationString as direct string repre-
               sentation of the configuration to override the existing
               configuration. The ConfigurationString is of exactly
               the same format as used in any LVM configuration file.

          profile config
               A profile is a set of selected customizable configura-
               tion settings that are aimed to achieve a certain char-
               acteristics in various environments or uses. It's used
               to override existing configuration.  Normally, the name
               of the profile should reflect that environment or use.

               There are two groups of profiles recognised: command
               profiles and metadata profiles.

               The command profile is used to override selected con-
               figuration settings at global LVM command level - it is
               applied at the very beginning of LVM command execution
               and it is used throughout the whole time of LVM command
               execution. The command profile is applied by using the
               --commandprofile ProfileName command line option that
               is recognised by all LVM2 commands.

               The metadata profile is used to override selected con-
               figuration settings at Volume Group/Logical Volume
               level - it is applied independently for each Volume
               Group/Logical Volume that is being processed. As such,

     Page 1                    Red Hat, Inc.         (printed 5/24/22)

     LVM.CONF(5)    (LVM TOOLS 2.03.11(2) (2021-01-08))    LVM.CONF(5)

               each Volume Group/Logical Volume can store the profile
               name used in its metadata so next time the Volume
               Group/Logical Volume is processed, the profile is
               applied automatically. If Volume Group and any of its
               Logical Volumes have different profiles defined, the
               profile defined for the Logical Volume is preferred.
               The metadata profile can be attached/detached by using
               the lvchange and vgchange commands and their --metadat-
               aprofile ProfileName and --detachprofile options or the
               --metadataprofile option during creation when using
               vgcreate or lvcreate command.  The vgs and lvs report-
               ing commands provide -o vg_profile and -o lv_profile
               output options to show the metadata profile currently
               attached to a Volume Group or a Logical Volume.

               The set of options allowed for command profiles is
               mutually exclusive when compared to the set of options
               allowed for metadata profiles. The settings that belong
               to either of these two sets can't be mixed together and
               LVM tools will reject such profiles.

               LVM itself provides a few predefined configuration pro-
               files.  Users are allowed to add more profiles with
               different values if needed.  For this purpose, there's
               the command_profile_template.profile (for command pro-
               files) and metadata_profile_template.profile (for meta-
               data profiles) which contain all settings that are cus-
               tomizable by profiles of certain type. Users are
               encouraged to copy these template profiles and edit
               them as needed. Alternatively, the lvmconfig --file
               <ProfileName.profile> --type profilable-command <sec-
               tion> or lvmconfig --file <ProfileName.profile> --type
               profilable-metadata <section> can be used to generate a
               configuration with profilable settings in either of the
               type for given section and save it to new
               ProfileName.profile (if the section is not specified,
               all profilable settings are reported).

               The profiles are stored in /etc/lvm/profile directory
               by default.  This location can be changed by using the
               config/profile_dir setting.  Each profile configuration
               is stored in ProfileName.profile file in the profile
               directory. When referencing the profile, the .profile
               suffix is left out.

          tag config
               See tags configuration setting description below.

          When several configuration methods are used at the same time
          and when LVM looks for the value of a particular setting, it

     Page 2                    Red Hat, Inc.         (printed 5/24/22)

     LVM.CONF(5)    (LVM TOOLS 2.03.11(2) (2021-01-08))    LVM.CONF(5)

          traverses this config cascade from left to right:

          direct config override on command line-> command profile
          config-> metadata profile config-> tag config->
          lvmlocal.conf-> lvm.conf

          No part of this cascade is compulsory. If there's no setting
          value found at the end of the cascade, a default value is
          used for that setting.  Use lvmconfig to check what settings
          are in use and what the default values are.

     SYNTAX
          This section describes the configuration file syntax.

          Whitespace is not significant unless it is within quotes.
          This provides a wide choice of acceptable indentation
          styles.  Comments begin with # and continue to the end of
          the line.  They are treated as whitespace.

          Here is an informal grammar:

          file = value*
               A configuration file consists of a set of values.

          value = section | assignment
               A value can either be a new section, or an assignment.

          section = identifier '{'
               A section groups associated values together. If the
               same section is encountered multiple times, the con-
               tents of all instances are concatenated together in the
               order of appearance.
               It is denoted by a name and delimited by curly brack-
               ets.
               e.g. backup {
                         ...
                    }

          assignment = identifier '=' (
               An assignment associates a type with an identifier. If
               the identifier contains forward slashes, those are
               interpreted as path delimiters. The statement
               section/key = value is equivalent to section { key =
               value }. If multiple instances of the same key are
               encountered, only the last value is used (and a warning
               is issued).
               e.g. level = 7

          array =  '[' ( type '
               Inhomogeneous arrays are supported.
               Elements must be separated by commas.
               An empty array is acceptable.

     Page 3                    Red Hat, Inc.         (printed 5/24/22)

     LVM.CONF(5)    (LVM TOOLS 2.03.11(2) (2021-01-08))    LVM.CONF(5)

          type = integer | float |
               integer = [0-9]*
               float = [0-9]*'.'[0-9]*
               string = '"'.*'"'

               Strings with spaces must be enclosed in double quotes,
               single words that start with a letter can be left
               unquoted.

     SETTINGS
          The lvmconfig command prints the LVM configuration settings
          in various ways.  See the man page lvmconfig(8).

          Command to print a list of all possible config settings,
          with their default values:
          lvmconfig --type default

          Command to print a list of all possible config settings,
          with their default values, and a full description of each as
          a comment:
          lvmconfig --type default --withcomments

          Command to print a list of all possible config settings,
          with their current values (configured, non-default values
          are shown):
          lvmconfig --type current

          Command to print all config settings that have been config-
          ured with a different value than the default (configured,
          non-default values are shown):
          lvmconfig --type diff

          Command to print a single config setting, with its default
          value, and a full description, where "Section" refers to the
          config section, e.g. global, and "Setting" refers to the
          name of the specific setting, e.g. umask:
          lvmconfig --type default --withcomments Section/Setting

     FILES
          /etc/lvm/lvm.conf
          /etc/lvm/lvmlocal.conf
          /etc/lvm/archive
          /etc/lvm/backup
          /etc/lvm/cache/.cache
          /run/lock/lvm
          /etc/lvm/profile

     SEE ALSO

     Page 4                    Red Hat, Inc.         (printed 5/24/22)

     LVM.CONF(5)    (LVM TOOLS 2.03.11(2) (2021-01-08))    LVM.CONF(5)

          lvm(8) lvmconfig(8)

     Page 5                    Red Hat, Inc.         (printed 5/24/22)