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)](/man/enterprise-packages/packagekit/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](#AUTHOR)

**Richard Hughes**

Author.

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2007 - 2013 Richard Hughes

July 29, 2013 PackageKit

---

Document: pkcon(1) from packagekit 1.4.0-r2 (Chainguard OS)
Source: https://github.com/PackageKit/PackageKit.git