yum(8)yum(8)NAMEyum - Yellowdog Updater Modified
SYNOPSISyum [options] [command] [package ...]
DESCRIPTIONyum 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] [...]
* check-update
* upgrade
* 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.
install
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.
check-update
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.
upgrade
takes no arguments, this performs a complete upgrade of the sys‐
tem - good for distro-version changes as it includes packages
obsoleting 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 pack‐
ages; more complete details are available in the List Options
section below.
provides
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 section below.
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.
GENERAL OPTIONS
Most command line options can be set using the configuration file as
well and the descriptions indicate the necessary configuration option
to set.
-h, --help
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.
-d [number]
Sets the debugging level to [number] - turns up or down the
amount of things that are printed.
-e [number]
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.
LIST OPTIONS
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 pack‐
age.
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 reposito‐
ries.
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.
CLEAN OPTIONS
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 pack‐
ages 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.
MISC
Proxy configuration
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/"
FILES
/etc/yum.conf
/var/cache/yum/
SEE ALSO
yum-arch (8), yum.conf (5)
AUTHORS
Seth Vidal <skvidal@phy.duke.edu>
BUGS
There of course aren't any bugs, but if you find any, they should be
sent to the mailing list: yum@dulug.duke.edu
Seth Vidal 2002 Jun 8 yum(8)