Provided by: yum_2.4.0-3ubuntu1_all bug


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


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

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


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

              A list of directories where yum  should  look  for  .repo  files
              which  define repositories to use. Default is ‘/etc/yum.repos.d,
              /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.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’.

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

              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

              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 ‘6’.

              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/lib/yum-plugins’.

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

              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

       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


       The   inclusion  of  external  configuration  files  is  supported  for
       /etc/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 as  listed  in
      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