Provided by: yum_3.2.25-1ubuntu2_all bug

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
              available  'foo*'  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.