Provided by: lvm2_2.02.133-1ubuntu10_amd64 bug

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.

       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  representation  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 configuration
              settings that are aimed to achieve a certain characteristics  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  configuration
              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 configuration
              settings at Volume Group/Logical Volume level -  it  is  applied
              independently for each Volume Group/Logical Volume that is being
              processed. As such, 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  --metadataprofile  ProfileName  and  --detachprofile
              options or the --metadataprofile  option  during  creation  when
              using  vgcreate  or lvcreate command.  The vgs and lvs reporting
              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  profiles.
              Users  are allowed to add more profiles with different values if
              needed.       For      this      purpose,      there's       the
              command_profile_template.profile   (for  command  profiles)  and
              metadata_profile_template.profile (for metadata profiles)  which
              contain  all  settings  that  are  customizable  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 <section>
              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  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 '{' value* '}'
              A section groups associated values together. If the same section
              is encountered multiple times, the contents of all instances are
              concatenated together in the order of appearance.
              It is denoted by a name and delimited by curly brackets.
              e.g. backup {
                        ...
                   }

       assignment = identifier '=' ( array | type )
              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 ',')* type ']' | '[' ']'
              Inhomogeneous arrays are supported.
              Elements must be separated by commas.
              An empty array is acceptable.

       type = integer | float | string
              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 configured  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

       lvm(8) lvmconfig(8)