| PKCON(1) | User Commands | PKCON(1) |
.SH "NAME" pkcon - PackageKit console client
.SH "SYNOPSIS"
.HP 144u
pkcon
[OPTION...]
[COMMAND]
.SH "DESCRIPTION"
.PP This manual page documents briefly the pkcon command.
.PP pkcon is the command line client for PackageKit.
.SH "COMMANDS"
.PP pkcon knows about the following commands. Depending on the backend in
use, not all of them may be available.
.PP backend-details
Print information about the PackageKit backend in use.
.RE
.PP get-roles
List the roles that a transaction can have.
.RE
.PP get-groups
List the available package groups.
.RE
.PP get-filters
List the available filters.
.RE
.PP get-transactions
List known transactions.
.RE
.PP get-time ROLE
Print the time that has passed since the last transaction with the given
role.
.RE
.PP search [name|details|group|file] DATA
Search for a package matching the given data. The search is performed in the
package information that is indicated by the first argument: name, details,
group or files.
.RE
.PP install PACKAGES
Install the given packages from repositories.
.RE
.PP install-local FILES
Install the given packages from the local filesystem.
.RE
.PP download DIRECTORY PACKAGES
Download the given packages from repositories, and store them in the given
directory.
.RE
.PP install-sig TYPE KEY_ID PACKAGE
Install a package signature. Only GPG signatures are supported at this
time.
.RE
.PP remove PACKAGE
Remove the given package.
.RE
.PP update [PACKAGES]
Update the system by installing available updates. If a list of packages is
specified, only install updates for these packages.
.RE
.PP refresh [force]
Refresh the cached information about available updates.
.RE
.PP resolve PACKAGE
Resolve the given package name and print information about installed or
available packages and updates.
.RE
.PP upgrade-system DISTRIBUTION [minimal|default|complete]
Upgrade the system to the given distribution.
.RE
.PP get-updates
List available updates.
.RE
.PP get-distro-upgrades
List available distribution upgrades.
.RE
.PP depends-on PACKAGE
List dependencies fo the given package.
.RE
.PP required-by PACKAGE
List packages that require the given package.
.RE
.PP get-details PACKAGE
Print details about the available or installed package with the given
name.
.RE
.PP get-details-local FILE
Print details about the local package.
.RE
.PP get-files PACKAGE
List the files contained in the given package.
.RE
.PP get-files-local FILE
List the files contained in the local package.
.RE
.PP get-update-detail PACKAGE
Print the package changelog for the given package.
.RE
.PP get-packages
List all available and installed packages.
.RE
.PP repo-list
List all configured package repositories.
.RE
.PP repo-enable REPOSITORY
Enable the given repository.
.RE
.PP repo-disable REPOSITORY
Disable the given repository.
.RE
.PP repo-set-data REPOSITORY PARAMETER DATA
Set the given parameter to the given value for the repository.
.RE
.PP repo-remove REPOSITORY PARAMETER
Removes the repository and optionally any packages installed from it.
.RE
.PP what-provides STRING
List packages that provide the given string.
.RE
.PP accept-eula EULA_ID
Accept the EULA with the given id.
.RE
.PP get-categories
List available categories.
.RE
.PP repair
Attempt to repair the system package database.
.RE
.PP offline-get-prepared
Print information about the prepared offline update. If no offline update is
prepared, exit with an exit code of 1.
.RE
.PP offline-trigger
Trigger an offline update.
.RE
.PP offline-status
Print information about the result of the last offline update.
.RE
.SH "OPTIONS"
.PP The following options can be used to influence the behavior of
pkcon.
.PP --version
Print the program version and exit.
.RE
.PP -h, --help
Show help options.
.RE
.PP --help-all
Show all help options.
.RE
.PP --filter FILTER
Set the filter to use.
.RE
.PP -y, --noninteractive
Install packages without asking for confirmation.
.RE
.PP --only-download
Prepare the transaction by downloading packages only.
.RE
.PP -n, --background
Run the command using idle network bandwidth and also using less power.
.RE
.PP -p, --plain
Print to screen a machine-readable output, rather than using animated
widgets.
.RE
.PP -v, --verbose
Show debugging information.
.RE
.PP -c, --cache-age AGE
Set the maximum acceptable age for cached metadata, in seconds. Use -1 for
'never'.
.RE
.PP --allow-untrusted
Allow untrusted packages to be installed.
.RE
.PP --allow-downgrade
Allow packages to be downgraded during transaction.
.RE
.PP --allow-reinstall
Allow packages to be reinstalled during transaction.
.RE
.SH "RETURN VALUES"
.PP 0
Success
.RE
.PP 1
Failed with miscellaneous internal error.
.RE
.PP 3
Failed with syntax error, or failed to parse command.
.RE
.PP 4
Failed as a file or directory was not found.
.RE
.PP 5
Nothing useful was done.
.RE
.PP 6
The initial setup failed, e.g. setting the network proxy.
.RE
.PP 7
The transaction failed, see the detailed error for more information.
.RE
.SH "SEE ALSO"
.PP pkmon (1).
.PP The programs are documented fully on
https://www.freedesktop.org/software/PackageKit.
.SH "AUTHOR"
.PP This manual page was written by Richard Hughes
<richard@hughsie.com>.
AUTHOR
Richard Hughes
COPYRIGHT
Copyright © 2007 - 2013 Richard Hughes
| July 29, 2013 | PackageKit |