2.3. Command Line Version

If you are not running X, you can still run the Red Hat Update Agent from a virtual console or remote terminal. If you are running X but want to use the command line version, you can force it not to display the graphical interface with the following command:

        up2date --nox

The command line version of the Red Hat Update Agent allows you to perform advanced functions or to perform actions with little or no interaction. For example, the following command updates your system with no interaction. It downloads the newer packages and installs them if you configured it to do so.

        up2date -u

The command line version of the Red Hat Update Agent accepts the following arguments:

Option	Description
`-?`, `--usage`	Briefly describe the available options.
`-h`, `--help`	List the available options and exit.
`--arch=architecture`	Force `up2date` to install this architecture of the package. Not valid with `--update`, `--list`, or `--dry-run`.
`--channel=channel`	Specify from which channels to update using channel labels.
`--configure`	Configure Red Hat Update Agent options. Refer to Section 2.4, “Configuration” for detailed instructions.
`-d`, `--download`	Download packages only; do not install them. This argument temporarily overrides the configuration option Do not install packages after retrieval. Use this option if you prefer to install the packages manually.
`--dbpath=dir`	Specify an alternate RPM database to use temporarily.
`--dry-run`	Do everything but download and install packages. This is useful in checking dependencies and other requirements prior to actual installation.
`-f`, `--force`	Force package installation. This option temporarily overrides the file, package, and configuration skip lists.
`--firstboot`	Pop up in the center of the screen for Firstboot.
`--get`	Fetch the package specified without resolving dependencies.
`--get-source`	Fetch the source package specified without resolving dependencies.
`--gpg-flags`	Show the flags with which GPG is invoked, such as the keyring.
`--hardware`	Update this system's hardware profile on RHN.
`-i`, `--install`	Install packages after they are downloaded. This argument temporarily overrides the configuration option Do not install packages after retrieval.
`--installall=<channel-label>`	Install all available packages from a given channel
`--justdb`	Only add packages to the database and do not install them.
`-k`, `--packagedir`	Specify a colon-separated path of directories in which to look for packages before trying to download them.
`-l`, `--list`	List packages relevant to the system.
`--list-rollbacks`	Show the package rollbacks available.
`--nodownload`	Do not download packages at all. This is useful in testing.
`--nosig`	Do not use GPG to check package signatures. This option temporarily overrides the saved configuration option.
`--nosrc`	Do not download source packages (SRPMs).
`--nox`	Do not attempt to run in X. This launches the command line version of the Red Hat Update Agent.
`-p`, `--packages`	Update packages associated with this System Profile.
`--proxy=proxy URL`	Specify an HTTP proxy to use.
`--proxyPassword=proxy password`	Specify a password to use with an authenticated HTTP proxy.
`--proxyUser=proxy user ID`	Specify a username to use with an authenticated HTTP proxy.
`--register`	Register (or re-register) this system with RHN. Refer to Section 2.2, “Registration” for detailed instructions.
`--serverUrl=server URL`	Specify an alternate server from which to retrieve packages.
`--showall`	List all packages available for download.
`--show-available`	List all packages available that are not currently installed.
`--show-channels`	Show the channel name associated with each package.
`--show-orphans`	List all packages currently installed that are not in channels to which the system is subscribed.
`--show-package-dialog`	Show the package installation dialog in GUI mode.
`--solvedeps=dependencies`	Find, download, and install the packages necessary to resolve dependencies.
`--src`	Download source packages, as well as binary RPMs.
`--tmpdir=directory`	Temporarily override the configured package directory. The default location is `/var/spool/up2date`. This option is useful if you do not have enough space in the configured location.
`-u`, `--update`	Update system with all relevant packages.
`--undo`	Reverse the last package set update.
`--upgrade-to-release=release version`	Upgrade to the channel specified.
`--uuid=uuid`	Pass in a Unique User ID generated by the Alert Notification tool.
`-v`, `--verbose`	Show additional output while updating.
`--version`	Show `up2date` version information.
`--whatprovides=dependencies`	Show the packages that resolve the comma-separated list of dependencies.

Table 2.2. Update Agent Command Line Arguments

Note

The --solvedeps and --whatprovides options can be used to solve the dependencies for an RPM regardless even if your system does not currently have access to a channel that contains that package.