Unix/Linux Go Back    


RedHat 9 (Linux i386) - man page for up2date (redhat section 8)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


UP2DATE(8)			   Red Hat Linux System Manual			       UP2DATE(8)

NAME
       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 sys-
       temid  file  in	/etc/sysconfig/rhn/systemid  ,	and  it's  configuration  in /etc/syscon-
       fig/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 run-
       ning 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 run-
       time 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 packages, and more.

       --register
	      Register	a  system with Red Hat Network. This is mainly useful for reregis-
	      tering a system, as up2date will automatically invoke this mode if the  cur-
	      rent system isnt registered.

       -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 retrieval."  It is mutually exclusive with the --install option.

       --nodownload
	      Do not download packages at all. This is for testing purposes.

       -f, --force
	      Force  package  installation.  This option is provided so that you can over-
	      ride 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.". It is mutually exlusive with the the --download option.

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

       --dry-run
	      Output a list of packages available for updates, and all the deps they need,
	      including obsoletes.

       --showall
	      Show a list of all packages available from the channels the system  is  cur-
	      rently subscribed to, including those not currently 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 (overrides configuration option).

       --src  Download source rpms as well as binary rpms.

       --nosrc
	      Do not download source package (overrides 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 Pro-
	      file.

       --whatprovides=<deps>
	      Queries the RHN servers to resolve the comma seperated list of dependencies.
	      It will return a list of packages that will satisfy these deps.

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

       --show-channels
	      Show the channels associated with a package where approriate. If used alone,
	      it  shows  the  currently  subscribed  channels.	If  used with --showall or
	      --whatprovides it will show channels as well as package names.

       --installall
	      Used in combo with --channel to install all the packages from a given
	      channel.

       --show-orphans
	      List  all  packages currently installed that are not present in chan-
	      nels the server is subscribed to.

       --show-available
	      List all packages available in the channels the server is  subscribed
	      to, but are not currently installed.

       --channel
	      Specify a specific channel. Used in combo with --installall.

       --list-rollbacks
	      Shows all currently available rpm rollbacks.

       --tmpdir=<directory>
	      allows  you to override the configured package/temporary file storage
	      directory.  This can 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.

       --serverURL=<url>
	      Specify what server url to use.

       --gpg-flags
	      Shows the flags that gpg will be invoked with (the keyring, the  home
	      directory,  etc). Intentend for useage in scripts that want to invoke
	      gpg the same way up2date does.

       -u, --update
	      Completely update the system.  All relevant packages  will  be  down-
	      loaded  (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.
       /etc/sysconfig/rhn/up2date-keyring.gpg
	      The  default  keyring  used specificaly for up2date, if
	      used with versions of rpm that support it (rpm-4.0.4 or
	      higher)
       /var/spool/up2date
	      The  spool  directory  where  rpm stores package lists,
	      package headers and packages.
       /var/spool/repackage
	      The spool directory where rpm/up2date  stores  rollback
	      rpms.
       /var/log/up2date
	      This is the log file for up2date.
       /usr/share/rhn/RHNS-CA-CERT
	      The  ssl	certificate authority file used by up2date to
	      validate the Red Hat Network ssl servers.
       /usr/share/rhn/RPM-GPG-KEY
	      A copy of the Red Hat, Inc  rpm  package	signing  key.
	      This  is the gpg key that can be used to verify a pack-
	      age is signed by Red Hat, Inc.

EXAMPLES
       The following example starts up the interactive gui client.

	      up2date

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

	      up2date -u

       This  example shows up2date being used to discover which pack-
       ages 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
	      readline-4.1-5
	      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

       This example shows how to install all the  packages  from  the
       channel foobar-1.0-i386

	      up2date --installall --channel foobar-1.0-i386

       This  example  shows  how  to list all the currently installed
       packages that are not part of channels the system is currently
       subscribed to.

	      up2date --show-orphans


SEE ALSO
       Configuration is performed through up2date-config.  The Update
       Agent  is  tightly  coupled  with  Red  Hat  Network.	Visit
       <http://rhn.redhat.com> for access or to sign up.

AUTHORS
       Written by Preston Brown <pbrown@redhat.com>, Cristian Gafton <gafton@redhat.com>,
       and Adrian Likins <alikins@redhat.com>

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

COPYRIGHT
       Copyright (C) 1999-2002 Red Hat, Inc.
       This  is free software; see the source for copying conditions.
       There is NO warranty; not even for MERCHANTABILITY or  FITNESS
       FOR A PARTICULAR PURPOSE.

4th Berkeley Distribution	       Wed 29 November 2000			       UP2DATE(8)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:51 AM.