pkcon

PackageKit

          richard@hughsie.com;

Richard Hughes
2007 - 2013 Richard Hughes
July 29, 2013
pkcon 1 User Commands
&package; PackageKit console client
`&package;` `OPTION` `COMMAND`

## DESCRIPTION

This manual page documents briefly the `&package;` command.

`&package;` is the command line client for PackageKit.

## Commands

&package; knows about the following commands. Depending on the backend in use, not all of them may be available.

backend-details

  Print information about the PackageKit backend in use.

get-roles

  List the roles that a transaction can have.

get-groups

  List the available package groups.

get-filters

  List the available filters.

get-transactions

  List known transactions.

get-time ROLE

  Print the time that has passed since the last transaction with the given role.

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.

install PACKAGES

  Install the given packages from repositories.

install-local FILES

  Install the given packages from the local filesystem.

download DIRECTORY PACKAGES

  Download the given packages from repositories, and store them in the given directory.

install-sig TYPE KEY_ID PACKAGE

  Install a package signature. Only GPG signatures are supported at this time.

remove PACKAGE

  Remove the given package.

update [PACKAGES]

  Update the system by installing available updates. If a list of packages is specified, only install updates for these packages.

refresh [force]

  Refresh the cached information about available updates.

resolve PACKAGE

  Resolve the given package name and print information about installed or available packages and updates.

get-updates

  List available updates.

get-distro-upgrades

  List available distribution upgrades.

depends-on PACKAGE

  List dependencies fo the given package.

required-by PACKAGE

  List packages that require the given package.

get-details PACKAGE

  Print details about the available or installed package with the given name.

get-details-local FILE

  Print details about the local package.

get-files PACKAGE

  List the files contained in the given package.

get-files-local FILE

  List the files contained in the local package.

get-update-detail PACKAGE

  Print the package changelog for the given package.

get-packages

  List all available and installed packages.

repo-list

  List all configured package repositories.

repo-enable REPOSITORY

  Enable the given repository.

repo-disable REPOSITORY

  Disable the given repository.

repo-set-data REPOSITORY PARAMETER DATA

  Set the given parameter to the given value for the repository.

repo-remove REPOSITORY PARAMETER

  Removes the repository and optionally any packages installed from it.

what-provides STRING

  List packages that provide the given string.

accept-eula EULA_ID

  Accept the EULA with the given id.

get-categories

  List available categories.

repair

  Attempt to repair the system package database.

offline-get-prepared

  Print information about the prepared offline update. If no offline update is prepared, exit with an exit code of 1.

offline-trigger

  Trigger an offline update.

offline-status

  Print information about the result of the last offline update.

## Options

The following options can be used to influence the behavior of `&package;`.

--version

  Print the program version and exit.

-h, --help

  Show help options.

--help-all

  Show all help options.

--filter FILTER

  Set the filter to use.

-y, --noninteractive

  Install packages without asking for confirmation.

--only-download

  Prepare the transaction by downloading packages only.

-n, --background

  Run the command using idle network bandwidth and also using less power.

-p, --plain

  Print to screen a machine-readable output, rather than using animated widgets.

-v, --verbose

  Show debugging information.

-c, --cache-age AGE

  Set the maximum acceptable age for cached metadata, in seconds. Use -1 for 'never'.

## Return values

`0`

  Success

`1`

  Failed with miscellaneous internal error.

`3`

  Failed with syntax error, or failed to parse command.

`4`

  Failed as a file or directory was not found.

`5`

  Nothing useful was done.

`6`

  The initial setup failed, e.g. setting the network proxy.

`7`

  The transaction failed, see the detailed error for more information.

## SEE ALSO

pkmon (1).

The programs are documented fully on http://www.packagekit.org.

## AUTHOR

This manual page was written by Richard Hughes richard@hughsie.com.