Man Linux: Main Page and Category List

NAME

       yum - Yellowdog Updater Modified

SYNOPSIS

       yum [options] [command] [package ...]

DESCRIPTION

       yum is an interactive, rpm based, package manager. It can automatically
       perform system updates,  including  dependency  analysis  and  obsolete
       processing   based  on  "repository"  metadata.  It  can  also  perform
       installation of new packages,  removal  of  old  packages  and  perform
       queries  on  the  installed  and/or available packages among many other
       commands/services (see below). yum  is  similar  to  other  high  level
       package managers like apt-get and smart.

       While  there  are  some  graphical interfaces directly to the yum code,
       more  recent  graphical  interface  development   is   happening   with
       PackageKit and the gnome-packagekit application.

       command is one of:
        * install package1 [package2] [...]
        * update [package1] [package2] [...]
        * check-update
        * upgrade [package1] [package2] [...]
        * remove | erase package1 [package2] [...]
        * list [...]
        * info [...]
        * provides | whatprovides feature1 [feature2] [...]
        * clean [ packages | headers | metadata | dbcache | all ]
        * makecache
        * groupinstall group1 [group2] [...]
        * groupupdate group1 [group2] [...]
        * grouplist [hidden] [groupwildcard] [...]
        * groupremove group1 [group2] [...]
        * groupinfo group1 [...]
        * search string1 [string2] [...]
        * shell [filename]
        * resolvedep dep1 [dep2] [...]
        * localinstall rpmfile1 [rpmfile2] [...]
        * localupdate rpmfile1 [rpmfile2] [...]
        * reinstall package1 [package2] [...]
        * downgrade package1 [package2] [...]
        * deplist package1 [package2] [...]
        * repolist [all|enabled|disabled]
        * version [all|installed|available|group-*|grouplist|groupinfo]
        * history [info|list|summary|redo|undo|new]
        * help [command]

       Unless the --help or -h option is given, one of the above commands must
       be present.

       Repository configuration is honored in all operations.

       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. If the
              name starts with an @ character the rest of the name is used  as
              though  passed  to  the  groupinstall  command. If the name is a
              file, then install works like localinstall. If the name  doesn’t
              match  a  package,  then  package  "provides"  are searched (Eg.
              "_sqlitecache.so()(64bit)")    as     are     filelists     (Eg.
              "/usr/bin/yum").  Also  note  that for filelists, wildcards will
              match multiple packages.

       update If run without any packages, update will update every  currently
              installed package.  If one or more packages or package globs are
              specified, Yum will only  update  the  listed  packages.   While
              updating  packages,  yum  will  ensure that all dependencies are
              satisfied. If the packages or globs specified match to  packages
              which  are  not currently installed then update will not install
              them. update operates on groups, files, provides  and  filelists
              just like the "install" command.

              If  the main obsoletes configure option is true (default) or the
              --obsoletes flag is present yum will include  package  obsoletes
              in  its  calculations  - this makes it better for distro-version
              changes, for example: upgrading from somelinux 8.0 to  somelinux
              9.

       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 packages  to  be  updated  in
              list  format. Returns 0 if no packages are available for update.
              Returns 1 if an error occurred.  Running in  verbose  mode  also
              shows obsoletes.

       upgrade
              Is the same as the update command with the --obsoletes flag set.
              See update for more details.

       remove or erase
              Are used to remove the specified packages  from  the  system  as
              well  as removing any packages which depend on the package being
              removed.  remove  operates  on  groups,  files,   provides   and
              filelists just like the "install" command.

       list   Is  used  to  list various information about available packages;
              more complete details are available in the List Options  section
              below.

       provides or whatprovides
              Is 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.

       search Is  used  to  find  any  packages  matching  a  string  in   the
              description,  summary  and package name fields of an rpm. Useful
              for finding a package you do not know by name but know  by  some
              word related to it.

       info   Is  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 yum
              cache directory over time.  More complete details can  be  found
              in the Clean Options section below.

       makecache
              Is  used  to  download  and make usable all the metadata for the
              currently enabled yum repos.

       groupinstall
              Is used to install all of the individual packages in a group, of
              the  specified types (this works as if you’d taken each of those
              package names and put them  on  the  command  line  for  a  "yum
              install" command).
               The  group_package_types  configuration  option specifies which
              types will be installed.

       groupupdate
              Is just an alias for groupinstall, which will do the right thing
              because  "yum  install  X" and "yum update X" do the same thing,
              when X is already installed.

       grouplist
              Is used to list the available groups from all yum repos.  Groups
              are   marked  as  "installed"  if  all  mandatory  packages  are
              installed, or if a group doesn’t  have  any  mandatory  packages
              then  it  is installed if any of the optional or default package
              are installed.  The optional "hidden" argument  will  also  list
              groups  marked  as  not being "user visible". If you pass the -v
              option, to enable verbose mode, then the groupids are displayed.

       groupremove
              Is  used  to  remove  all  of  the  packages  in a group, unlike
              "groupinstall"  this  will  remove  everything   regardless   of
              group_package_types.  It is worth pointing out that packages can
              be in more than one group, so "groupinstall  X  Y"  followed  by
              "groupremove  Y"  does  not  do  give  you  the  same  result as
              "groupinstall X".

       groupinfo
              Is used to give the description and package list of a group (and
              which  type those packages are marked as). Note that you can use
              the yum-filter-data and yum-list-data  plugins  to  get/use  the
              data  the  other  way  around (Ie. what groups own packages need
              updating). If you pass the -v option, to  enable  verbose  mode,
              then  the  package names are matched against installed/available
              packages similar to the list command.

       shell  Is used to enter the ’yum shell’, when a filename  is  specified
              the  contents  of  that  file is executed in yum shell mode. See
              yum-shell(8) for more info

       resolvedep
              Is used to list packages providing the  specified  dependencies,
              at most one package is listed per dependency.

       localinstall
              Is  used  to  install  a set of local rpm files. If required the
              enabled repositories will be used to resolve dependencies.  Note
              that  the  install  command  will do a local install, if given a
              filename.

       localupdate
              Is used to update the system by specifying local rpm files. Only
              the  specified  rpm  files  of which an older version is already
              installed will be installed, the  remaining  specified  packages
              will  be  ignored.  If required the enabled repositories will be
              used to resolve dependencies. Note that the update command  will
              do a local install, if given a filename.

       reinstall
              Will reinstall the identically versioned package as is currently
              installed.  This does not work for "installonly" packages,  like
              Kernels.  reinstall  operates  on  groups,  files,  provides and
              filelists just like the "install" command.

       downgrade
              Will try and downgrade a  package  from  the  version  currently
              installed  to  the  previously highest version (or the specified
              version).  The depsolver will not necessarily work, but  if  you
              specify  all  the  packages  it  should  work (and thus. all the
              simple  cases  will  work).  Also  this  does   not   work   for
              "installonly"  packages,  like  Kernels.  downgrade  operates on
              groups, files, provides and filelists just  like  the  "install"
              command.

       deplist
              Produces  a  list  of all dependencies and what packages provide
              those dependencies for the given packages.

       repolist
              Produces a list of configured repositories. The  default  is  to
              list all enabled repositories. If you pass -v, for verbose mode,
              more information is listed.

       version
              Produces  a  "version"  of  the  rpmdb,  and  of   the   enabled
              repositories  if  "all"  is given as the first argument. You can
              also specify version groups in the version-groups config.  file.
              If  you  pass  -v, for verbose mode, more information is listed.
              The version is calculated by taking a sha1 hash of the  packages
              (in  sorted  order), and the checksum_type/checksum_data entries
              from the yumdb. Note that this rpmdb version is  now  also  used
              significantly within yum (esp. in yum history).

       history
              The history command allows the user to view what has happened in
              past transactions (assuming the history_record config. option is
              set).  You  can  use  info/list/summary  to  view what happened,
              undo/redo to act on that information and  new  to  start  a  new
              history file.

              The  info/list/summary commands take either a transactions id or
              a package (with wildcards, as in Specifying package names),  all
              three  can  also  be passed no arguments. list can be passed the
              keyword "all" to list all the transactions.  undo/redo just take
              a transaction id.

       help   Produces  help,  either  for  all commands or if given a command
              name then the help for that particular command.

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 any question  which  would
              be asked is yes.
              Configuration Option: assumeyes

       -c [config file]
              Specifies  the config file location - can take HTTP and FTP URLs
              and local file paths.

       -q, --quiet
              Run without output.  Note that you likely also want to use -y.

       -v, --verbose
              Run with a lot of debugging output.

       -d [number]
              Sets the debugging level to [number] -  turns  up  or  down  the
              amount of things that are printed. Practical range: 0 - 10
              Configuration Option: debuglevel

       -e [number]
              Sets the error level to [number] Practical range 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.
              Configuration Option: errorlevel

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

       --version
              Reports  the  yum  version number and installed package versions
              for everything in history_record_packages (can be  added  to  by
              plugins).

       --showduplicates
              Doesn’t  limit  packages  to  their latest versions in the info,
              list and search commands (will also affect plugins which use the
              doPackageLists() API).

       --installroot=root
              Specifies  an  alternative  installroot,  relative  to which all
              packages will be installed.
              Configuration Option: installroot

       --enablerepo=repoidglob
              Enables specific repositories by  id  or  glob  that  have  been
              disabled in the configuration file using the enabled=0 option.
              Configuration Option: enabled

       --disablerepo=repoidglob
              Disables specific repositories by id or glob.
              Configuration Option: enabled

       --obsoletes
              This  option  only  has  affect  for an update, it enables yum´s
              obsoletes processing logic. For more information see the  update
              command above.
              Configuration Option: obsoletes

       -x, --exclude=package
              Exclude  a  specific package by name or glob from updates on all
              repositories.  Configuration Option: exclude

       --color=[always|auto|never]
              Display colorized output automatically, depending on the  output
              terminal,  always  (using  ANSI  codes) or never. Note that some
              commands (Eg. list and info) will do a little  extra  work  when
              color is enabled.  Configuration Option: color

       --disableexcludes=[all|main|repoid]
              Disable  the excludes defined in your config files. Takes one of
              three options:
              all == disable all excludes
              main == disable excludes defined in [main] in yum.conf
              repoid == disable excludes defined for that repo

       --disableplugin=plugin
              Run with one or more plugins disabled, the argument is  a  comma
              separated list of wildcards to match against plugin names.

       --noplugins
              Run with all plugins disabled.
              Configuration Option: plugins

       --nogpgcheck
              Run with GPG signature checking disabled.
              Configuration Option: gpgcheck

       --skip-broken
              Resolve  depsolve problems by removing packages that are causing
              problems from the transaction.
              Configuration Option: skip_broken

       -t, --tolerant
              This option currently does nothing.

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

       OUTPUT

              The format of the output of yum list is:

              name.arch version-release  repo or @installed-from-repo

       yum list [all | glob_exp1] [glob_exp2] [...]
              List all available and installed packages.

       yum list available [glob_exp1] [...]
              List all packages  in  the  yum  repositories  available  to  be
              installed.

       yum list updates [glob_exp1] [...]
              List   all   packages   with   updates   available  in  the  yum
              repositories.

       yum list installed [glob_exp1] [...]
              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 [glob_exp1] [...]
              List the packages installed on the system that are not available
              in any yum repository listed in the config file.

       yum list obsoletes [glob_exp1] [...]
              List  the packages installed on the system that are obsoleted by
              packages in any yum repository listed in the config file.

       yum list recent
              List packages recently added into the repositories.

       Specifying package names
              All the  list  options  mentioned  above  take  file-glob-syntax
              wildcards  or  package  names as arguments, for example yum list
              availablefoo*’ will list all  available  packages  that  match
              ’foo*’.  (The  single quotes will keep your shell from expanding
              the globs.)

CLEAN OPTIONS

       The following are the ways which you can invoke yum in clean mode. Note
       that  "all  files"  in the commands below means "all files in currently
       enabled repositories".  If you want to  also  clean  any  (temporarily)
       disabled repositories you need to use --enablerepo=*’ option.

       yum clean expire-cache
              Eliminate   the   local   data  saying  when  the  metadata  and
              mirrorlists were downloaded for each repo. This means  yum  will
              revalidate  the  cache  for  each  repo.  next  time it is used.
              However if the cache is still  valid,  nothing  significant  was
              deleted.

       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 header files which yum uses for dependency
              resolution.

       yum clean metadata
              Eliminate all of the files  which  yum  uses  to  determine  the
              remote  availability  of  packages. Using this option will force
              yum to download all the metadata the next time it is run.

       yum clean dbcache
              Eliminate the sqlite cache used for faster access  to  metadata.
              Using  this option will force yum to recreate the cache the next
              time it is run.

       yum clean all
              Runs yum  clean  packages  and  yum  clean  headers,  yum  clean
              metadata and yum clean dbcache as above.

MISC

       Specifying package names
              A  package can be referred to for install,update,list,remove etc
              with any of the following:

              name
              name.arch
              name-ver
              name-ver-rel
              name-ver-rel.arch
              name-epoch:ver-rel.arch
              epoch:name-ver-rel.arch

              For example: yum remove kernel-2.4.1-10.i686

PLUGINS

       Yum can be extended through the use of plugins. A plugin  is  a  Python
       ".py"  file  which  is installed in one of the directories specified by
       the pluginpath option in yum.conf. For a plugin to work, the  following
       conditions must be met:

       1.  The plugin module file must be installed in the plugin path as just
       described.

       2. The global plugins option in /etc/yum/yum.conf must be set to ‘1’.

       3.   A   configuration   file   for   the   plugin   must   exist    in
       /etc/yum/pluginconf.d/<plugin_name>.conf  and  the  enabled  setting in
       this file must set to ‘1’. The minimal content for such a configuration
       file is:

              [main]
              enabled = 1

       See  the  yum.conf(5)  man  page for more information on plugin related
       configuration options.

FILES

       /etc/yum/yum.conf
       /etc/yum/version-groups.conf
       /etc/yum/repos.d/
       /etc/yum/pluginconf.d/
       /var/cache/yum/

SEE ALSO

       pkcon (1)
       yum.conf (5)
       yum-updatesd (8)
       package-cleanup (1)
       repoquery (1)
       yum-complete-transaction (1)
       yumdownloader (1)
       yum-utils (1)
       http://yum.baseurl.org/
       http://yum.baseurl.org/wiki/Faq
       yum search yum

AUTHORS

       See the Authors file included with this program.

BUGS

       There of course aren’t any bugs, but if you find any, you should  first
       consult  the  FAQ  mentioned  above  and  then  email the mailing list:
       yum@lists.baseurl.org or filed in bugzilla.