Provided by: yum_3.2.12-1.2_all bug


       yum.conf - Configuration file for yum(8).


       Yum uses a configuration file at /etc/yum/yum.conf.

       Additional  configuration  files are also read from the directories set
       by the  reposdir  option  (default  is  ‘/etc/yum/repos.d’).   See  the
       reposdir option below for further details.


       There  are two types of sections in the yum configuration file(s): main
       and repository. Main defines all global  configuration  options.  There
       should  be  only one main section. The repository section(s) define the
       configuration for each repository/server. There should be one  or  more
       repository sections.

[main] OPTIONS

       The  [main]  section  must exist for yum to do anything. It consists of
       the following options:

              Directory where yum should store its cache  and  db  files.  The
              default is ‘/var/cache/yum’.

              Directory where yum should store information that should persist
              over multiple runs. The default is ‘/var/lib/yum’.

              Either ‘1’ or ‘0’. Determines whether or not yum keeps the cache
              of  headers  and packages after succesful installation.  Default
              is ’1’ (keep files)

              A list of directories where yum  should  look  for  .repo  files
              which define repositories to use. Default is ‘/etc/yum/repos.d’.
              Each  file  in  this  directory  should  contain  one  or   more
              repository sections as documented in [repository] options below.
              These  will  be  merged  with  the   repositories   defined   in
              /etc/yum/yum.conf  to form the complete set of repositories that
              yum will use.

              Debug message output level. Practical range is 0-10. Default  is

              Error  message output level. Practical range is 0-10. Default is

              Full directory and file name for where yum should write its  log

              Either  ‘1’  or  ‘0’.  This  tells  yum whether or not it should
              perform a GPG signature check on packages. When this is  set  in
              the  [main]  section  it  sets the default for all repositories.
              This option also determines whether  or  not  an  install  of  a
              package from a local RPM file will be GPG signature checked. The
              default is ‘0’.

              Either ‘1’ or ‘0’. Determines whether or  not  yum  prompts  for
              confirmation of critical actions. Default is ‘0’ (do prompt).
              Commmand-line option: -y

              Either  ‘1’ or ‘0’. Without this option, yum will not prompt for
              confirmation when the list of packages to be  installed  exactly
              matches  those  given  on  the command line. Unless assumeyes is
              enabled, it will still  prompt  for  package  removal,  or  when
              additional   packages   need   to   be   installed   to  fulfill
              dependencies. Default is ‘1’.

              Either ‘1’ or ‘0’. If enabled, then  yum  will  be  tolerant  of
              errors on the command line with regard to packages. For example:
              if you request to install foo, bar and baz and baz is installed;
              yum  won’t  error out complaining that baz is already installed.
              Default to ‘0’ (not tolerant).
              Commmand-line option: -t

              List of packages to  exclude  from  updates  or  installs.  This
              should  be  a space separated list.  Shell globs using wildcards
              (eg. * and ?) are allowed.

              Either ‘1’ or ‘0’. Set to ‘1’ to make yum update only update the
              architectures of packages that you have installed. ie: with this
              enabled yum will not install an i686 package to update  an  i386
              package. Default is ‘1’.

              List  of  packages  that  should  only  ever be installed, never
              updated. Kernels in particular fall into this category. Defaults
              to kernel, kernel-smp, kernel-bigmem, kernel-enterprise, kernel-
              debug, kernel-unsupported.

              Number of packages listed in installonlypkgs to  keep  installed
              at the same time. Setting to 0 disables this feature. Default is

              List of package names that are kernels. This is really only here
              for the updating of kernel packages and should be removed out in
              the yum 2.1 series.

              Either ‘0’ or ‘1’. Set to ‘1’ if you wish to show any  duplicate
              packages  from  any  repository,  from package listings like the
              info or list commands. Set to ‘0’ if you want only  to  see  the
              newest packages from any repository.  Default is ‘0’.

              This  option  only has affect during an update. It enables yum’s
              obsoletes processing logic. Useful when doing distribution level
              upgrades.  See  also  the  yum upgrade command documentation for
              more details (yum(8)).
              Commmand-line option: --obsoletes

              Either ‘0’ or ‘1’. Used to determine yum’s behaviour if  two  or
              more  repositories  offer the package groups with the same name.
              If overwrite_groups is ‘1’ then the group packages of  the  last
              matching  repository  will  be  used. If overwrite_groups is ‘0’
              then the groups from all matching repositories  will  be  merged
              together as one large group.

              Either  ‘0’ or ‘1’. Determines whether yum will allow the use of
              conditionals packages. Default is ‘1’ (package conditionals  are

              List  of  the following: optional, default, mandatory. Tells yum
              which  type  of  packages  in  groups  will  be  installed  when
              ’groupinstall’ is called.  Default is: default, mandatory

              Specifies  an  alternative  installroot,  relative  to which all
              packages will be installed.
              Commmand-line option: --installroot

              The package used by  yum  to  determine  the  "version"  of  the
              distribution.  This  can  be  any  installed package. Default is
              ‘redhat-release’. You can see what  provides  this  manually  by
              using: "yum whatprovides redhat-release".

              Either  ‘0’  or ‘1’. Set this to ‘0’ to disable the checking for
              sufficient diskspace before a RPM transaction is run. Default is
              ‘1’ (perform the check).

              Comma  or  space  separated list of transaction flags to pass to
              the   rpm   transaction   set.   These   include    ’noscripts’,
              ’notriggers’,  ’nodocs’,  ’test’,  and ’repackage’.  You can set
              all/any of them. However, if you don’t know what these do in the
              context  of an rpm transaction set you’re best leaving it alone.
              Default is an empty list.

       recent Number of days back to look for ‘recent’  packages  added  to  a
              repository.  Used by the list recent command. Default is ‘7’.

              Set  the  number  of times any attempt to retrieve a file should
              retry before returning an error. Setting this to ‘0’  makes  yum
              try forever. Default is ‘10’.

              Either ‘0’ or ‘1’. Set whether HTTP keepalive should be used for
              HTTP/1.1 servers that support  it.  This  can  improve  transfer
              speeds  by  using one connection when downloading multiple files
              from a repository. Default is ‘1’.

              Number of seconds to wait for a connection  before  timing  out.
              Defaults  to  30  seconds.  This  may be too short of a time for
              extremely overloaded sites.

              Determines how upstream HTTP caches are instructed to handle any
              HTTP downloads that Yum does. This option can take the following

              ‘all’ means that all HTTP downloads should be cached.

              ‘packages’ means that  only  RPM  package  downloads  should  be
              cached (but not repository metadata downloads).

              ‘none’ means that no HTTP downloads should be cached.

              The  default  is  ‘all’.  This  is  recommended  unless  you are
              experiencing  caching  related  issues.  Try  to  at  least  use
              ‘packages’ to minimise load on repository servers.

              Enable  bandwidth  throttling  for downloads. This option can be
              expressed as a absolute data rate in bytes/sec. An SI prefix (k,
              M  or  G)  may be appended to the bandwidth value (eg. ‘5.5k’ is
              5.5 kilobytes/sec, ‘2M’ is 2 Megabytes/sec).

              Alternatively, this option can specify the percentage  of  total
              bandwidth  to use (eg. ‘60%’). In this case the bandwidth option
              should be used to specify the maximum available bandwidth.

              Set to ‘0’ to disable bandwidth throttling. This is the default.

              Use  to  specify  the  maximum  available  network  bandwidth in
              bytes/second.   Used  with  the  throttle  option  (above).   If
              throttle  is  a  percentage  and bandwidth is ‘0’ then bandwidth
              throttling will be disabled. If throttle is expressed as a  data
              rate (bytes/sec) then this option is ignored. Default is ‘0’ (no
              bandwidth throttling).

              List of functional commands to run if no functional commands are
              specified  on  the command line (eg. "update foo bar baz quux").
              None of the short options (eg. -y, -e, -d) are accepted for this

       proxy  url to the proxy server that yum should use.

              username to use for proxy

              password for this proxy

              Either  ‘0’  or  ‘1’.  Global  switch  to  enable or disable yum
              plugins. Default is ‘0’  (plugins  disabled).  See  the  PLUGINS
              section of the yum(8) man for more information on installing yum

              A list of directories where yum should look for plugin  modules.
              Default  is ‘/usr/share/yum-plugins’ and ‘/usr/lib/yum-plugins’.

              A  list  of  directories  where  yum  should  look  for   plugin
              configuration files.  Default is ‘/etc/yum/pluginconf.d’.

              Time  (in seconds) after which the metadata will expire. So that
              if the current  metadata  downloaded  is  less  than  this  many
              seconds  old  then  yum will not update the metadata against the
              repository.  If you find that yum is not downloading information
              on  updates  as  often as you would like lower the value of this
              option. You can also change from the default of using seconds to
              using  days,  hours  or  minutes  by  appending  a  d,  h  or  m
              respectivley.  The default is  1.5  hours,  to  compliment  yum-
              updatesd  running  once  an hour.  It’s also possible to use the
              word "never", meaning that the metadata will never expire.

              Time (in seconds) after which the mirrorlist locally cached will
              expire.   If  the  current  mirrorlist  is  less  than this many
              seconds old then yum will  not  download  another  copy  of  the
              mirrorlist, it has the same extra format as metadata_expire.  If
              you find that yum is not downloading the mirrorlists as often as
              you would like lower the value of this option.

              You   can  select  from  different  metadata  download  policies
              depending on how much data you want to download  with  the  main
              repository  metadata  index.  The advantages of downloading more
              metadata with the index is that you can’t  get  into  situations
              where  you  need  to  use  that  metadata later and the versions
              available aren’t compatible (or the user lacks  privilages)  and
              that  if  the  metadata is corrupt in any way yum will revert to
              the previous metadata.

              ‘instant’ - Just  download  the  new  metadata  index,  this  is
              roughly  what  yum always did, however it now does some checking
              on the index and reverts if it classifies it as bad.

              ‘group:primary’ - Download the primary metadata with the  index.
              This  contains  most of the package information and so is almost
              always required anyway. This is the default.

              ‘group:small’ - With the primary also  download  the  updateinfo
              metadata,  this  is  required for yum-security operations and it
              also used in the graphical clients.  This file also tends to  be
              significantly smaller than most others.

              ‘group:main’  -  With  the  primary  and updateinfo download the
              filelists metadata and the group metadata. The filelists data is
              required  for  operations like "yum install /bin/bash", and also
              some dependancy resolutions require it. The group data  is  used
              in  some  graphical  clients  and for group operations like "yum
              grouplist Base".

              ‘group:all’  -  Download  all  metadata  listed  in  the  index,
              currently  the  only one not listed above is the other metadata,
              which contains the changelog information which is used  by  yum-
              changelog. This is what "yum makecache" uses.

              Can  be  set  to ’all’ or ’best’. All means install all possible
              arches for any  package  you  want  to  install.  Therefore  yum
              install  foo  will install foo.i386 and foo.x86_64 on x86_64, if
              it is available. Best means  install  the  best  arch  for  this
              platform, only.

[repository] OPTIONS

       The repository section(s) take the following form:

              name=Some name for this repository

              Must be a unique name for each repository, one word.

       name   A human readable string describing the repository.

              Must  be  a  URL  to  the  directory  where the yum repository’s
              ‘repodata’ directory lives. Can be an http://, ftp:// or file://
              URL. You can specify multiple URLs in one baseurl statement. The
              best way to do this is like this:
              name=Some name for this repository

              If you list more than one baseurl= statement in a repository you
              will  find  yum  will  ignore  the earlier ones and probably act
              bizarrely. Don’t do this, you’ve been warned.

              You can use HTTP basic auth by  prepending  "user:password@"  to
              the   server   name   in   the   baseurl   line.   For  example:

              Specifies a URL to a file containing a list  of  baseurls.  This
              can  be used instead of or with the baseurl option. Substitution
              variables, described below, can be used with this option.

              Either ‘1’ or ‘0’. This  tells  yum  whether  or  not  use  this

              Either  ‘1’  or  ‘0’.  This  tells  yum whether or not it should
              perform a GPG signature check on the packages gotten  from  this

       gpgkey A  URL  pointing  to  the  ASCII-armoured  GPG  key file for the
              repository. This option is used if yum needs  a  public  key  to
              verify  a package and the required key hasn’t been imported into
              the RPM database. If this option is set, yum will  automatically
              import  the  key  from  the  specified URL. You will be prompted
              before the key is installed unless the assumeyes option is  set.

              Multiple  URLs  may  be specified here in the same manner as the
              baseurl option (above). If a GPG key is required  to  install  a
              package   from   a  repository,  all  keys  specified  for  that
              repository will be installed.

              Same as the [main] exclude option but only for this  repository.
              Substitution variables, described below, are honored here.

              Inverse  of  exclude. This is a list of packages you want to use
              from a repository. If this option lists only  one  package  then
              that  is  all yum will ever see from the repository. Defaults to
              an empty list.  Substitution  variables,  described  below,  are
              honored here.

              Either  ‘0’ or ‘1’. Determines whether yum will allow the use of
              package groups for this  repository.  Default  is  ‘1’  (package
              groups are allowed).

              Either ‘roundrobin’ or ‘priority’.

              ‘roundrobin’  randomly  selects a URL out of the list of URLs to
              start with and proceeds through each of them as it encounters  a
              failure contacting the host.

              ‘priority’  starts  from  the  first  baseurl  listed  and reads
              through them sequentially.

              failovermethod defaults to ‘roundrobin’ if not specified.

              Either ‘1’ or ‘0’.  This  tells  yum  whether  or  not  HTTP/1.1
              keepalive  should  be  used with this repository. See the global
              option in the [main] section above for more information.

              Overrides the timeout option from the [main]  section  for  this

              Overrides  the  http_caching  option from the [main] section for
              this repository.

              Overrides the retries option from the [main]  section  for  this

              Overrides  the  throttle option from the [main] section for this

              Overrides the bandwidth option from the [main] section for  this

              Overrides the metadata_expire option from the [main] section for
              this repository.

              Overrides the mirrorlist_expire option from the  [main]  section
              for this repository.

       proxy  url  to the proxy server for this repository. Set to ’_none_’ to
              disable the global proxy setting for this repository. If this is
              unset it inherits it from the global setting

              username to use for proxy.  If this is unset it inherits it from
              the global setting

              password for this proxy.  If this is unset it inherits  it  from
              the global setting

       cost   relative  cost of accessing this repository. Useful for weighing
              one repo’s packages as greater/less than any other. defaults  to


       The   inclusion  of  external  configuration  files  is  supported  for
       /etc/yum/yum.conf  and  the  .repo  files   in   the   /etc/yum/repos.d
       directory. To include a URL, use a line of the following format:


       The  configuration  file  will  be  inserted  at  the  position  of the
       "include=" line.  Included files may contain further include lines. Yum
       will abort with an error if an inclusion loop is detected.


       There  are  a  number  of  variables you can use to ease maintenance of
       yum’s configuration files. They are available in the values of  several
       options including name, baseurl and commands.

              This  will  be  replaced  with  the  value of the version of the
              package listed in distroverpkg. This defaults to the version  of
              ‘redhat-release’ package.

       $arch  This  will  be  replaced  with  your  architecture  as listed by
              os.uname()[4] in Python.

              This will be replaced with your base architecture  in  yum.  For
              example, if your $arch is i686 your $basearch will be i386.

              These  will  be replaced with the value of the shell environment
              variable of the same name. If  the  shell  environment  variable
              does  not exist then the configuration file variable will not be