yum - Yellowdog Updater Modified
yum [options] [command] [package ...]
yum is an interactive, automated update program which can be used for maintaining systems using rpm
command is one of:
* install package1 [package2] [...]
* update [package1] [package2] [...]
* remove [package1] [package2] [...]
* list [...]
* info [...]
* provides [...]
* clean [packages | headers | old-headers | all]
Unless the --help or -h option is given, one of the above commands must be present.
is used to install the latest version of a package or group of packages while ensuring that all dependencies are satisfied. If no
package matches the given package name(s), they are assumed to be a shell glob and any matches are then installed.
update If run without any packages, update will update every currently installed package. If one or more packages are specified, Yum will
only update the listed packages. While updating packages, yum will ensure that all dependencies are satisfied. If no package
matches the given package name(s), they are assumed to be a shell glob and any matches are then installed.
Implemented so you could know if your machine had any updates that needed to be applied without running it interactively. Returns
exit value of 100 if there are packages available for an update. Also returns a list of the pkgs to be updated in list format.
Returns 0 and no packages are available for update.
takes no arguments, this performs a complete upgrade of the system - good for distro-version changes as it includes packages obso-
leting other packages in its updating calculations.
remove is used to remove the specified packages from the system as well as removing any packages which depend on the package being removed.
list can be used to list various information about available packages; more complete details are available in the List Options section
can be used to find out which package provides some feature or file. Just use a specific name or a file-glob-syntax wildcards to
list the packages available or installed that provide that feature or file.
info can be used to list a description and summary information about available packages; takes the same arguments as in the List Options
clean is used to clean up various things which accumulate in the yup cache directory over time. More complete details can be found in the
Clean Options section below.
Most command line options can be set using the configuration file as well and the descriptions indicate the necessary configuration option
Help; display a help message and then quit.
-y Assume yes; assume that the answer to answer to any question which would be asked is yes. Configuration Item: assume-yes
-r Replace conflicting files (equivalent to the RPM option of '--replacefiles --force'). Attention, this has a high 'shoot your own
foot' possibility. Configuration Item: replacefiles
-c [config file]
Specifies the config file location.
Sets the debugging level to [number] - turns up or down the amount of things that are printed.
Sets the error level to [number] 0 - 10. 0 means print only critical errors about which you must be told. 1 means print all errors,
even ones that are not overly important. 1+ means print more errors (if any) -e 0 is good for cron jobs.
-t Tells yum to be tolerant of errors on the command line with regard to packages on the commandline. 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.
-R [time in minutes]
Sets the maximum amount of time yum will wait before performing a command - it randomizes over the time.
-C Tells yum to run entirely from cache - does not download or update any headers unless it has to to perform the requested action.
The following are the ways which you can invoke yum in list mode. Note that all list commands include information on the version of the
yum list [available]
list all packages in the yum repositories available to be installed.
yum list updates
list all packages with updates available in the yum repositories.
yum list [args]
list the packages specified by args. If an argument does not match the name of a package, it is assumed to be a shell-style glob
and any matches are printed.
yum list installed
list the packages specified by args. If an argument does not match the name of an available package, it is assumed to be a
shell-style glob and any matches are printed.
yum list extras
list the packages installed on the system that are not available in any yum repository listed in the config file.
The following are the ways which you can invoke yum in clean mode.
yum clean packages
Eliminate any cached packages from the system. Note that packages are not automatically deleted after they are downloaded.
yum clean headers
Eliminate all of the files which yum uses to determine the remote availablility of packages. Using this option will force yum to
download all the headers the next time it is run.
yum clean oldheaders
Eliminate the old headers that yum no longer needs to determine the remote availablility of packages.
yum clean [all]
Runs yum clean packages and yum clean oldheaders as above.
If you would like to use a proxy with yum you can simply set a shell environment variable of http_proxy. Set it to the url for your
proxy. Ex: "http://your_proxy:port/"
yum-arch (8), yum.conf (5)
Seth Vidal <firstname.lastname@example.org>
There of course aren't any bugs, but if you find any, they should be sent to the mailing list: email@example.com
Seth Vidal 2002 Jun 8 yum(8)