CentOS Man Pages

Man Page or Keyword Search:
Man
Apropos Keyword Search (all sections) Output format
home | help
yum.conf(5)                 yum configuration file                 yum.conf(5)

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

DESCRIPTION
       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').  See the repos-
       dir option below for further details.

PARAMETERS
       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:

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

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

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

              reposdir  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.conf to form the complete set  of  reposito-
              ries that yum will use.

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

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

              rpmverbosity   Debug  scriptlet  output  level.  'info'  is  the
              default, other options are:  'critical',  'emergency',  'error',
              'warn' and 'debug'.

              protected_packages  This  is  a list of packages that yum should
              never completely remove. They are protected  via.  Obsoletes  as
              well as user/plugin removals.

              The  default  is:  yum  glob:/etc/yum/protected.d/*.conf  So any
              packages which should be protected can do so by including a file
              in /etc/yum/protected.d with their package name in it.

              Also  if  this  configuration  is set to anything, then yum will
              protect the package corresponding to the running version of  the
              kernel.

              protected_multilib  Either '1' or '0'. This tells yum whether or
              not it should perform a check to make sure that  multilib  pack-
              ages  are  the  same version. For example, if this option is off
              (rpm behaviour) pkgA-1.x86_64 and pkgA-2.i386 can  be  installed
              at  the same time. However this is very rarely desired.  install
              only packages, like the kernel, are  excempt  from  this  check.
              The default is '1'.

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

              gpgcheck 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  reposito-
              ries.  The default is '0'.

              localpkg_gpgcheck  Either  '1' or '0'. This tells yum whether or
              not it should perform a GPG signature check  on  local  packages
              (packages in a file, not in a repositoy).  The default is '0'.

              repo_gpgcheck  Either  '1' or '0'. This tells yum whether or not
              it should perform a GPG signature check on  the  repodata.  When
              this  is  set  in the [main] section it sets the default for all
              repositories. The default is '0'.

              skip_broken Either '1' or  '0'.  Resolve  depsolve  problems  by
              removing  packages  that  are causing problems from the transac-
              tion.

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

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

              tolerant  Either '1' or '0'. If enabled, then yum will be toler-
              ant 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).
              Command-line option: -t

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

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

              installonlypkgs List of package provides that should  only  ever
              be  installed,  never  updated.  Kernels in particular fall into
              this category. Defaults to kernel, kernel-bigmem,  kernel-enter-
              prise,  kernel-smp,  kernel-debug,  kernel-unsupported,  kernel-
              source, kernel-devel, kernel-PAE, kernel-PAE-debug.

              Note that because these  are  provides,  and  not  just  package
              names,  kernel-devel will also apply to kernel-debug-devel, etc.

              Note that "kernel-modules" is not in this list, in  RHEL-6,  and
              so anything providing that is updated like any other package.

              installonly_limit  Number  of packages listed in installonlypkgs
              to keep installed at the same time. Setting to 0  disables  this
              feature. Default is '3'. Note that this functionality used to be
              in the "installonlyn" plugin, where this option was altered via.
              tokeep.   Note  that  as of version 3.2.24, yum will now look in
              the yumdb for a installonly attribute on installed packages.  If
              that attribute is "keep", then they will never be removed.

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

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

              obsoletes  This  option  only  has  affect  during an update. It
              enables yum's obsoletes processing logic. Useful when doing dis-
              tribution level upgrades. See also the yum upgrade command docu-
              mentation for more details (yum(8)).  Default is 'true'.
              Command-line option: --obsoletes

              overwrite_groups 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 over-
              write_groups is '0' then the groups from all matching  reposito-
              ries will be merged together as one large group.

              groupremove_leaf_only Either '0' or '1'. Used to determine yum's
              behaviour when the groupremove  command  is  run.   If  groupre-
              move_leaf_only  is  '0' (default) then all packages in the group
              will be removed.  If  groupremove_leaf_only  is  '1'  then  only
              those  packages  in  the  group  that aren't required by another
              package will be removed.

              enable_group_conditionals Either '0' or '1'. Determines  whether
              yum  will allow the use of conditionals packages. Default is '1'
              (package conditionals are allowed).

              group_package_types 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

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

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

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

              tsflags  Comma  or  space separated list of transaction flags to
              pass to the rpm  transaction  set.  These  include  'noscripts',
              'notriggers',   'nodocs',  'test',  'justdb'  and  'nocontexts'.
              'repackage' is also available but that does nothing  with  newer
              rpm  versions.   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'.

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

              keepalive  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 multi-
              ple files from a repository. Default is '1'.

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

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

              '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 experi-
              encing caching related issues. Try to at least use 'packages' to
              minimize load on repository servers.

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

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

              sslcacert Path to the directory containing the databases of  the
              certificate  authorities  yum  should use to verify SSL certifi-
              cates. Defaults to none - uses system default

              sslverify Boolean - should yum verify SSL certificates/hosts  at
              all. Defaults to True.

              Note  that  the  plugin  yum-rhn-plugin will force this value to
              true, and may alter other ssl settings (like hostname checking),
              even if it the machine is not registered.

              sslclientcert  Path to the SSL client certificate yum should use
              to connect to repos/remote sites Defaults to none.

              Note that if you are using curl compiled against NSS (default in
              Fedora/RHEL),  curl  treats  sslclientcert  values with the same
              basename as _identical_. This version of  yum  will  check  that
              this  isn't true and output an error when the repositories "foo"
              and "bar" violate this, like so:

              sslclientcert basename shared between foo and bar

              sslclientkey Path to the SSL client key yum should use  to  con-
              nect to repos/remote sites Defaults to none.

              ssl_check_cert_permissions  Boolean  -  Whether yum should check
              the permissions on the paths for the certificates on the reposi-
              tory  (both remote and local). If we can't read any of the files
              then yum will force skip_if_unavailable to  be  true.   This  is
              most  useful for non-root processes which use yum on repos. that
              have  client  cert  files  which  are  readable  only  by  root.
              Defaults to True.

              history_record  Boolean  - should yum record history entries for
              transactions. This takes some disk space, and some extra time in
              the transactions. But it allows how to know a lot of information
              about what has happened before, and display it to the user  with
              the  history  info/list/summary  commands. yum also provides the
              history undo/redo commands. Defaults to True.

              Note that if history is recorded, yum uses that  information  to
              see  if any modifications to the rpmdb have been done outside of
              yum. These are always bad, from yum's point of view, and so  yum
              will  issue  a warning and automatically run some of "yum check"
              to try and find some of the worst problems  altering  the  rpmdb
              might have caused.

              This means that turning this option off will stop yum from being
              able to detect when the rpmdb has  changed  and  thus.  it  will
              never  warn  you  or automatically run "yum check". The problems
              will likely still be there, and yumdb etc. will still  be  wrong
              but yum will not warn you about it.

              history_record_packages  This  is  a  list of package names that
              should be recorded as having helped the transaction. yum plugins
              have an API to add themselves to this, so it should not normally
              be necessary to add packages here. Not that this  is  also  used
              for the packages to look for in --version. Defaults to rpm, yum,
              yum-metadata-parser.

              history_list_view Which column of information to display in  the
              "yum  history  list" command. There are currently three options:
              users, cmds (or commands), single-user-commands.

              Older versions of yum acted like "users", which  always  outputs
              the  user who initiated the yum transaction. You can now specify
              "commands" which will instead always output the command line  of
              the  transaction.  You  can  also specify "single-user-commands"
              which will display the users if there are more than one,  other-
              wise it will display the command line.

              You  can also specify "default" which currently selects "users".

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

              syslog_ident  Identification (program name) for syslog messages.

              syslog_facility Facility name  for  syslog  messages,  see  sys-
              log(3).  Default is 'LOG_USER'.

              syslog_device  Where  to  log  syslog  messages.  Can be a local
              device (path) or a host:port string to use a remote syslog.   If
              empty  or points to a nonexistent device, syslog logging is dis-
              abled.  Default is '/dev/log'.

              proxy URL to the proxy server that yum should use.

              proxy_username username to use for proxy

              proxy_password password for this proxy

              username username to use for basic authentication to a  repo  or
              really any url.

              password password to use with the username for basic authentica-
              tion.

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

              pluginpath  A list of directories where yum should look for plu-
              gin   modules.   Default   is    '/usr/share/yum-plugins'    and
              '/usr/lib/yum-plugins'.

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

              metadata_expire  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 respectively.  The default is 6 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.  Note
              that  when  using  a  metalink  file the metalink must always be
              newer than the metadata for the repository, due to  the  valida-
              tion, so this timeout also applies to the metalink file.

              mirrorlist_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  meta-
              data_expire.   If  you find that yum is not downloading the mir-
              rorlists as often as you would like  lower  the  value  of  this
              option.

              mdpolicy  You  can select from different metadata download poli-
              cies 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  situa-
              tions where you need to use that metadata later and the versions
              available aren't compatible (or the user lacks  privileges)  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 dependency 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,  cur-
              rently  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.

              multilib_policy Can be set to 'all' or 'best'. All means install
              all possible arches for any package you want to install.  There-
              fore  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.

              bugtracker_url  URL  where bugs should be filed for yum. Config-
              urable for local versions or distro-specific bugtrackers.

              color Display colorized output automatically, depending  on  the
              output  terminal,  always (using ANSI codes) or never.  Command-
              line option: --color

              color_list_installed_older  The  colorization/highlighting   for
              packages  in list/info installed which are older than the latest
              available package with the  same  name  and  arch.   Default  is
              'bold'.   Possible values are a comma separated list containing:
              bold,  blink,  dim,  reverse,   underline,   fg:black,   fg:red,
              fg:green,  fg:yellow,  fg:blue,  fg:magenta,  fg:cyan, fg:white,
              bg:black,  bg:red,  bg:green,  bg:yellow,  bg:blue,  bg:magenta,
              bg:cyan, bg:white.

              color_list_installed_newer   The  colorization/highlighting  for
              packages in list/info installed which are newer than the  latest
              available  package  with  the  same  name  and arch.  Default is
              'bold,yellow'.  See color_list_installed_older for possible val-
              ues.

              color_list_installed_reinstall The colorization/highlighting for
              packages in list/info installed which is the same version as the
              latest  available  package with the same name and arch.  Default
              is 'normal'.  See color_list_installed_older for  possible  val-
              ues.

              color_list_installed_extra   The  colorization/highlighting  for
              packages in list/info installed which has no  available  package
              with  the  same  name  and  arch.   Default  is 'bold,red'.  See
              color_list_installed_older for possible values.

              color_list_available_upgrade The  colorization/highlighting  for
              packages in list/info available which is an upgrade for the lat-
              est installed package with the same name and arch.   Default  is
              'bold,blue'.   See  color_list_installed_older for possible val-
              ues.

              color_list_available_downgrade The colorization/highlighting for
              packages  in  list/info  available  which is a downgrade for the
              latest installed package with the same name and  arch.   Default
              is 'dim,cyan'.  See color_list_installed_older for possible val-
              ues.

              color_list_available_install The  colorization/highlighting  for
              packages  in  list/info available which has no installed package
              with  the  same  name  and  arch.   Default  is  'normal'.   See
              color_list_installed_older for possible values.

              color_list_available_reinstall The colorization/highlighting for
              packages in list/info available which is the same version as the
              installed  package  with  the  same  name  and arch.  Default is
              'bold,underline,green.  See color_list_installed_older for  pos-
              sible values.

              color_search_match   The   colorization/highlighting   for  text
              matches    in    search.     Default     is     'bold'.      See
              color_list_installed_older for possible values.

              color_update_installed  The  colorization/highlighting for pack-
              ages in the "updates list" which are installed. The updates list
              is  what  is  printed  when  you  run  "yum  update",  "yum list
              updates", "yum list obsoletes" and "yum check-update".   Default
              is  'normal'.   See color_list_installed_older for possible val-
              ues.

              color_update_local The colorization/highlighting for packages in
              the  "updates  list"  which  are already downloaded. The updates
              list is what is printed when you run  "yum  update",  "yum  list
              updates",  "yum list obsoletes" and "yum check-update".  Default
              is 'bold'.  See color_list_installed_older for possible  values.

              color_update_remote  The  colorization/highlighting for packages
              in the "updates list" which need to be downloaded.  The  updates
              list  is  what  is  printed when you run "yum update", "yum list
              updates", "yum list obsoletes" and "yum check-update".   Default
              is  'normal'.   See color_list_installed_older for possible val-
              ues.

              clean_requirements_on_remove When removing packages (by removal,
              update or obsoletion) go through each package's dependencies. If
              any of them are no longer required by  any  other  package  then
              also  mark  them  to  be  removed.   Boolean (1, 0, True, False,
              yes,no) Defaults to False

              reset_nice If set to true then yum will try to  reset  the  nice
              value  to  zero,  before running an rpm transaction. Defaults to
              True.

              depsolve_loop_limit Set the number of times any attempt to  dep-
              solve  before  we  just give up. This shouldn't be needed as yum
              should always solve or fail, however it has been  observed  that
              it  can  loop  forever  with very large system upgrades. Setting
              this to '0' (or "<forever>") makes yum try forever.  Default  is
              '100'.

[repository] OPTIONS
       The repository section(s) take the following form:

              Example: [repositoryid]
              name=Some name for this repository
              baseurl=url://path/to/repository/

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

              name A human readable string describing the repository.

              baseurl Must be a URL to the directory  where  the  yum  reposi-
              tory's  'repodata' directory lives. Can be an http://, ftp:// or
              file:// URL. You can specify multiple URLs in one baseurl state-
              ment. The best way to do this is like this:
              [repositoryid]
              name=Some name for this repository
              baseurl=url://server1/path/to/repository/
                      url://server2/path/to/repository/
                      url://server3/path/to/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:
              "baseurl=http://user:passwd@example.com/".

              metalink  Specifies a URL to a metalink file for the repomd.xml,
              a list of mirrors for the entire  repository  are  generated  by
              converting the mirrors for the repomd.xml file to a baseurl. The
              metalink file also contains the latest timestamp from  the  data
              in  the  repomd.xml,  the  length of the repomd.xml and checksum
              data. This data is checked  against  any  downloaded  repomd.xml
              file  and  all  of  the  information from the metalink file must
              match. This can be used instead of or with the  baseurl  option.
              Substitution  variables,  described below, can be used with this
              option. This option disables the mirrorlist option.  As  a  spe-
              cial  hack  is  the  mirrorlist URL contains the word "metalink"
              then the value of mirrorlist is copied to metalink (if  metalink
              is not set).

              mirrorlist  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.  As a special hack is the mirrorlist URL  con-
              tains the word "metalink" then the value of mirrorlist is copied
              to metalink (if metalink is not set).

              enabled Either '1' or '0'. This tells yum  whether  or  not  use
              this repository.

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

              repo_gpgcheck  Either  '1' or '0'. This tells yum whether or not
              it should perform a GPG signature check  on  the  repodata  from
              this repository.

              gpgkey  A URL pointing to the ASCII-armored 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 reposi-
              tory will be installed.

              gpgcakey A URL pointing to the ASCII-armored CA key file for the
              repository.  This is a normal gpg public key - but this key will
              be used to validate detached signatures of all other  keys.  The
              idea is you are asked to confirm import for this key. After that
              any other gpg key needed for package or repository verification,
              if  it  has  a detached signature which matches this key will be
              automatically imported without user confirmation.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

              ssl_check_cert_permissions  Overrides the ssl_check_cert_permis-
              sions option from the [main] section for this repository.

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

              mirrorlist_expire  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 reposi-
              tory. If this is unset it inherits it from the global setting

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

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

              username username to use for basic authentication to a  repo  or
              really any url.  If this is unset it inherits it from the global
              setting

              password password to use with the username for basic authentica-
              tion.  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 1000

              skip_if_unavailable  If set to True yum will continue running if
              this repository cannot be contacted for any reason. This  should
              be  set  carefully as all repos are consulted for any given com-
              mand. Defaults to False.

URL INCLUDE SYNTAX
       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:

       include=url://to/some/location

       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.

GLOB: FOR LIST OPTIONS
       Any of the configurations options which are a  list  of  items  can  be
       specfied using the glob syntax: glob:/etc/path/somewhere.d/*.conf. This
       will read in all files matching that glob and include all lines in each
       file (excluding comments and blank lines) as items in the list.

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

              $releasever  This will be replaced with the value of the version
              of the package listed in distroverpkg. This defaults to the ver-
              sion of 'redhat-release' package.

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

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

              $uuid This will be replaced with a unique  but  persistent  uuid
              for  this  machine.   The  value that is first generated will be
              stored in  /var/lib/yum/uuid  and  reused  until  this  file  is
              deleted.

              $YUM0-$YUM9  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 replaced.

       As of 3.2.28, any file in /etc/yum/vars is turned into a variable named
       after the filename (or overrides any of the above variables).

       Note  that no warnings/errors are given if the files are unreadable, so
       creating files that only root can read may be confusing for users.

       Also note that only the first line will be read and all new line  char-
       acters  are  removed,  as  a convenience. However, no other checking is
       performed on the data. This means it is possible to have bad  character
       data in any value.

FILES
       /etc/yum.conf
       /etc/yum.repos.d/
       /etc/yum/pluginconf.d/
       /etc/yum/protected.d
       /etc/yum/vars

SEE ALSO
       yum(8)

Seth Vidal                                                         yum.conf(5)

NAME | DESCRIPTION | PARAMETERS | [main] OPTIONS | [repository] OPTIONS | URL INCLUDE SYNTAX | GLOB: FOR LIST OPTIONS | VARIABLES | FILES | SEE ALSO