PKCON(1)

  .SH "NAME" pkcon - PackageKit console client
  .SH "SYNOPSIS"
    .HP u
      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
    Author.

COPYRIGHT
Copyright © 2007 - 2013 Richard Hughes