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