GNU/Linux |
CentOS 3.1 |
|
yum.conf(5) |
yum.conf − Configuration file for yum(8).
Yum uses uses a configuration file called yum.conf. This configuration file is searched for in the following places:
/etc/yum.conf
There are two types of sections in the yum.conf file: main and server. Main defines all the global configuration options. The server section(s) define the entries for each server.
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.
debuglevel
debug level. practical range is 0−10. default is 2.
errorlevel
debug level. practical range is 0−10. default is 2.
logfile
full directory and file name for where yum should write its log file.
assumeyes
1 or 0 - tells yum whether or not to prompt you for confirmation of actions. Same as -y on the command line. Default to 0.
tolerant
1 or 0 - Tells yum to 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. same as -t on the command line. Default to 0(not tolerant)
pkgpolicy=[newest|last]
Default: newest. Package sorting order. When a package is available from multiple servers, newest will install the most recent version of the package found. last will sort the servers alphabetically by serverid and install the version of the package found on the last server in the resulting list. If you don’t understand the above then you’re best left not including this option at all and letting the default occur.
exclude
list of packages to exclude from updates or installs. This should be a space separated list. Filename globs *,?,., etc are allowed
exactarch
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.
commands
list of functional commands to run if no functional commands are specified on the command line. ie: commands = update foo bar baz quux none of the short options (-y, -e, -d, etc) will be taken in the field.
distroverpkg
package to use to determine the "version" of the distribution - can be any package you have installed - defaults to redhat-release.
diskspacecheck
set this to 0 to disable the checking for sufficient diskspace before the rpm transaction is run. default is 1 (to perform the check)
retries
Set the number of times any attempt to retrieve a file should retry before returning an error. Setting this to 0 makes it try forever. Default to 6.
keepalive
Enable or disable http keepalive support. The default is 1(enable). If you are behind a proxy cache and you’re experiencing lots of timeouts or transfer failures try setting this to 0.
kernelpkgnames
list of package names that are kernels - this is really only here for the kernel updating portion - this should be removed out in 2.1 series.
installonlypkgs
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.
The server
section(s) take the following form:
Example:
[serverid]
name=Some name for this server
baseurl=url://path/to/repository/
gpgcheck=[1|0]
serverid
must be a unique name for each server, one word.
baseurl
must be a url to the directory
where the yum repository’s ’headers’
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:
[serverid]
name=Some name for this server
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.
name |
a human readable string describing the 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 server
failovermethod
can be 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.
exclude
same as the [main] exclude but this is only for this server variables, listed below, are honored here.
There are a
number of variables you can use to ease maintenance of the
configuration file. They are only useful inside the name,
baseurl and commands fields in the config file.
$releasever
This will be replaced with the value of the version of the package listed in distroverpkg. This defaults to the version of the package redhat-release
$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 as they are listed in archwork.py in yum. For example if your $arch is i686 your $basearch will be i386.
$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 they will not be replaced.
/etc/yum.conf
yum(8)
yum.conf(5) |