Update  Agent - a program for updating packages on Red Hat
       Linux


SYNOPSIS

       up2date [OPTION]... [PACKAGE NAME]...
       up2date-nox [OPTION]... [PACKAGE NAME]...


DESCRIPTION

       Update Agent provides a complete system for  updating  the
       RPM  packages  installed  on a Red Hat Linux system.  Both
       command line and graphical interfaces are included.

       When you run Update Agent, you will be  prompted  for  the
       computer's  root  password.   This is because Update Agent
       needs read/write access to the RPM database, and it  needs
       to  be able to install packages when so requested. It also
       needs read/write access to the up2date  systemid  file  in
       /etc/sysconfig/rhn/systemid  ,  and  it's configuration in
       /etc/sysconfig/rhn/up2date

       Update Agent has a  quite  a  few  configuration  options,
       including  but  not  limited to: installing packages after
       they are downloaded; downloading source  RPMs  along  with
       binary  RPMs; whether or not to upgrade packages where the
       default configuration  file(s)  have  been  modified,  and
       more.   You  can change these settings through a graphical
       interface by running up2date-config, or  you can edit  the
       configuration file /etc/sysconfig/rhn/up2date directly.  A
       number of the command line arguments described  below  can
       also be used at runtime to override configuration options.
       There is also a text mode based configuration  if  invoked
       with with the --configure option.

       If  you  supply  package  names on the command line, those
       particular packages will be updated or installed if  there
       are  new  versions  available.   Only  the package name is
       needed, do not supply any version or release  information.

       If  the  package  is  not  currently installed, it will be
       downloaded and installed, along with any dependencies that
       package requires.

       --configure
              Configure  Update  Agent  options.  This will allow
              you to adjust things such as  which  files/packages
              to  skip by default, where to store retrieved pack­
              ages, and more.

       -d, --download
              download packages only, do not install them.   This
              option  is  provided  so  that you can override the
              configuration option "Do not install packages after

              --install option.

       -f, --force
              force package installation.  This  option  is  pro­
              vided  so  that  you can override the file, package
              and configuration skip lists.

       -i, --install
              install packages after they are  downloaded.   This
              option  is  provided  so  that you can override the
              configuration option "Do not install packages after
              retrieval."

       -l, --list
              output  a  list of packages which have been updated
              and available for retrieval/installation.

       --showall
              Show a list of  all  packages  available  for  your
              release  of Red Hat Linux, including those not cur­
              rently installed.

       -k, --packagedir
              Specify a colon seperated path  of  directories  to
              look  for  packages  before  attempting to download
              them.

       --nosig
              Do not use GPG to check package  signatures  (over­
              rides configuration option).

       -p, --packages
              Update  the  packages  associated  with this System
              Profile on Red Hat Network.   Useful  if  you  have
              installed,  updated,  or  removed  packages without
              Update Agent, and  your  package  list  has  become
              unsynchronized with your remote Profile.

       --whatprovides=<deps>
              Queries the RHN servers to resolve the comma seper­
              ated list of dependiencies. It will return  a  list
              of  packages  will  satisfy  those deps. It make be
              necessary

       --solvedeps=<deps>
              Queries the RHN servers to resolve the comma seper­
              ated list of dependiencies. Essentially the same as
              --whatprovides except it  will  also  download  and
              install the packages that are needed to resolve the
              dependiencies.

       --tmpdir=<directory>
              allows   you    to    override    the    configured

              be useful if you are about to  download  a  lot  of
              packages  but you do not have enough space to store
              them in the default location.

       -u, --update
              Completely update the system.  All  relevant  pack­
              ages will be downloaded (and possibly installed, if
              you have configured Update Agent to do so).

       --nox  do not even attempt to display the gui.

       -h, --help
              display help on command line arguments and exit.

       -v, --verbose
              print more information about what Update  Agent  is
              doing.

       --justdb
              only  add  packages  to the database,do not install
              them to the filesystem.  --dbpath  Specify  a  path
              where an alternat rpm database to use is found.

       --version
              output version information and exit.


RETURN CODES

       Update Agent returns 0 on success, 1 on error.


FILES

       /etc/sysconfig/rhn/up2date
              Configuration settings for Update Agent.
       /etc/sysconfig/rhn/systemid
              Unique  system  identification  certificate for Red
              Hat Network.


EXAMPLES

       The  following  example  starts  up  the  interactive  gui
       client.

              up2date

       The  following  example  shows  up2date being used in non-
       interactive batch mode.

              up2date -u

       This example shows up2date being used  to  discover  which
       packages  solve  a set of deps manually on a Red Hat Linux
       7.0 machine.

              up2date --whatprovides "/bin/bash,gimp,libhistory.so.4.1"
              bash-2.04-11

              gimp-1.1.25-1

       This example shows how to start up the text  based  config
       tool.

              up2date --nox --configure

       This example shows how to use up2date to install a package
       with many deps that isnt currently installed.

              up2date kdebase


SEE ALSO

       Configuration is performed  through  up2date-config.   The
       Update  Agent  is  tightly  coupled  with Red Hat Network.
       Visit <http://www.redhat.com/network>  for  access  or  to
       sign up.  You can also run rhn_register to register a sys­
       tem with Red Hat Network.


AUTHORS

       Written by Preston Brown <pbrown@redhat.com> and
       Cristian Gafton <gafton@redhat.com>


REPORTING BUGS

       Report bugs to <http://bugzilla.redhat.com>.


COPYRIGHT

       Copyright © 1999-2001 Red Hat, Inc.
       This is free software; see the source for  copying  condi­
       tions.  There is NO warranty; not even for MERCHANTABILITY
       or FITNESS FOR A PARTICULAR PURPOSE.


Man(1) output converted with man2html