531 lines
8.7 KiB
HTML
531 lines
8.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of PKCON</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>PKCON</H1>
|
|
Section: User Commands (1)<BR>Updated: July 29, 2013<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
pkcon - PackageKit console client
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">
|
|
<B>pkcon</B> [<B>OPTION</B>...] [<B>COMMAND</B>]
|
|
</DL>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
<DD>This manual page documents briefly the
|
|
<B>pkcon</B>
|
|
command.
|
|
<P>
|
|
|
|
<B>pkcon</B>
|
|
is the command line client for PackageKit.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMANDS</H2>
|
|
|
|
<P>
|
|
|
|
pkcon knows about the following commands. Depending on the backend in use, not all of them may be available.
|
|
<P>
|
|
|
|
backend-details
|
|
<DL COMPACT><DT id="2"><DD>
|
|
Print information about the PackageKit backend in use.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-roles
|
|
<DL COMPACT><DT id="3"><DD>
|
|
List the roles that a transaction can have.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-groups
|
|
<DL COMPACT><DT id="4"><DD>
|
|
List the available package groups.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-filters
|
|
<DL COMPACT><DT id="5"><DD>
|
|
List the available filters.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-transactions
|
|
<DL COMPACT><DT id="6"><DD>
|
|
List known transactions.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-time <I>ROLE</I>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
Print the time that has passed since the last transaction with the given role.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
search [name|details|group|file] <I>DATA</I>
|
|
<DL COMPACT><DT id="8"><DD>
|
|
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.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
install <I>PACKAGES</I>
|
|
<DL COMPACT><DT id="9"><DD>
|
|
Install the given packages from repositories.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
install-local <I>FILES</I>
|
|
<DL COMPACT><DT id="10"><DD>
|
|
Install the given packages from the local filesystem.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
download <I>DIRECTORY</I> <I>PACKAGES</I>
|
|
<DL COMPACT><DT id="11"><DD>
|
|
Download the given packages from repositories, and store them in the given directory.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
install-sig <I>TYPE</I> <I>KEY_ID</I> <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="12"><DD>
|
|
Install a package signature. Only GPG signatures are supported at this time.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
remove <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="13"><DD>
|
|
Remove the given package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
update [<I>PACKAGES</I>]
|
|
<DL COMPACT><DT id="14"><DD>
|
|
Update the system by installing available updates. If a list of packages is specified, only install updates for these packages.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
refresh [force]
|
|
<DL COMPACT><DT id="15"><DD>
|
|
Refresh the cached information about available updates.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
resolve <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="16"><DD>
|
|
Resolve the given package name and print information about installed or available packages and updates.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
upgrade-system <I>DISTRIBUTION</I> [minimal|default|complete]
|
|
<DL COMPACT><DT id="17"><DD>
|
|
Upgrade the system to the given distribution.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-updates
|
|
<DL COMPACT><DT id="18"><DD>
|
|
List available updates.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-distro-upgrades
|
|
<DL COMPACT><DT id="19"><DD>
|
|
List available distribution upgrades.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
depends-on <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="20"><DD>
|
|
List dependencies fo the given package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
required-by <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="21"><DD>
|
|
List packages that require the given package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-details <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="22"><DD>
|
|
Print details about the available or installed package with the given name.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-details-local <I>FILE</I>
|
|
<DL COMPACT><DT id="23"><DD>
|
|
Print details about the local package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-files <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="24"><DD>
|
|
List the files contained in the given package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-files-local <I>FILE</I>
|
|
<DL COMPACT><DT id="25"><DD>
|
|
List the files contained in the local package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-update-detail <I>PACKAGE</I>
|
|
<DL COMPACT><DT id="26"><DD>
|
|
Print the package changelog for the given package.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-packages
|
|
<DL COMPACT><DT id="27"><DD>
|
|
List all available and installed packages.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repo-list
|
|
<DL COMPACT><DT id="28"><DD>
|
|
List all configured package repositories.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repo-enable <I>REPOSITORY</I>
|
|
<DL COMPACT><DT id="29"><DD>
|
|
Enable the given repository.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repo-disable <I>REPOSITORY</I>
|
|
<DL COMPACT><DT id="30"><DD>
|
|
Disable the given repository.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repo-set-data <I>REPOSITORY</I> <I>PARAMETER</I> <I>DATA</I>
|
|
<DL COMPACT><DT id="31"><DD>
|
|
Set the given parameter to the given value for the repository.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repo-remove <I>REPOSITORY</I> <I>PARAMETER</I>
|
|
<DL COMPACT><DT id="32"><DD>
|
|
Removes the repository and optionally any packages installed from it.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
what-provides <I>STRING</I>
|
|
<DL COMPACT><DT id="33"><DD>
|
|
List packages that provide the given string.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
accept-eula <I>EULA_ID</I>
|
|
<DL COMPACT><DT id="34"><DD>
|
|
Accept the EULA with the given id.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
get-categories
|
|
<DL COMPACT><DT id="35"><DD>
|
|
List available categories.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
repair
|
|
<DL COMPACT><DT id="36"><DD>
|
|
Attempt to repair the system package database.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
offline-get-prepared
|
|
<DL COMPACT><DT id="37"><DD>
|
|
Print information about the prepared offline update. If no offline update is prepared, exit with an exit code of 1.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
offline-trigger
|
|
<DL COMPACT><DT id="38"><DD>
|
|
Trigger an offline update.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
offline-status
|
|
<DL COMPACT><DT id="39"><DD>
|
|
Print information about the result of the last offline update.
|
|
</DL>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
|
|
The following options can be used to influence the behavior of
|
|
<B>pkcon</B>.
|
|
<P>
|
|
|
|
--version
|
|
<DL COMPACT><DT id="40"><DD>
|
|
Print the program version and exit.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-h, --help
|
|
<DL COMPACT><DT id="41"><DD>
|
|
Show help options.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--help-all
|
|
<DL COMPACT><DT id="42"><DD>
|
|
Show all help options.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--filter <I>FILTER</I>
|
|
<DL COMPACT><DT id="43"><DD>
|
|
Set the filter to use.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-y, --noninteractive
|
|
<DL COMPACT><DT id="44"><DD>
|
|
Install packages without asking for confirmation.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--only-download
|
|
<DL COMPACT><DT id="45"><DD>
|
|
Prepare the transaction by downloading packages only.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-n, --background
|
|
<DL COMPACT><DT id="46"><DD>
|
|
Run the command using idle network bandwidth and also using less power.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-p, --plain
|
|
<DL COMPACT><DT id="47"><DD>
|
|
Print to screen a machine-readable output, rather than using animated widgets.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-v, --verbose
|
|
<DL COMPACT><DT id="48"><DD>
|
|
Show debugging information.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
-c, --cache-age <I>AGE</I>
|
|
<DL COMPACT><DT id="49"><DD>
|
|
Set the maximum acceptable age for cached metadata, in seconds. Use -1 for 'never'.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--allow-untrusted
|
|
<DL COMPACT><DT id="50"><DD>
|
|
Allow untrusted packages to be installed.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--allow-downgrade
|
|
<DL COMPACT><DT id="51"><DD>
|
|
Allow packages to be downgraded during transaction.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
--allow-reinstall
|
|
<DL COMPACT><DT id="52"><DD>
|
|
Allow packages to be reinstalled during transaction.
|
|
</DL>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>RETURN VALUES</H2>
|
|
|
|
<P>
|
|
|
|
<B>0</B>
|
|
<DL COMPACT><DT id="53"><DD>
|
|
Success
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>1</B>
|
|
<DL COMPACT><DT id="54"><DD>
|
|
Failed with miscellaneous internal error.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>3</B>
|
|
<DL COMPACT><DT id="55"><DD>
|
|
Failed with syntax error, or failed to parse command.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>4</B>
|
|
<DL COMPACT><DT id="56"><DD>
|
|
Failed as a file or directory was not found.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>5</B>
|
|
<DL COMPACT><DT id="57"><DD>
|
|
Nothing useful was done.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>6</B>
|
|
<DL COMPACT><DT id="58"><DD>
|
|
The initial setup failed, e.g. setting the network proxy.
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<B>7</B>
|
|
<DL COMPACT><DT id="59"><DD>
|
|
The transaction failed, see the detailed error for more information.
|
|
</DL>
|
|
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
|
|
pkmon (1).
|
|
<P>
|
|
|
|
The programs are documented fully on <A HREF="http://www.packagekit.org.">http://www.packagekit.org.</A>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
|
|
This manual page was written by Richard Hughes
|
|
<<A HREF="mailto:richard@hughsie.com">richard@hughsie.com</A>>.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
|
|
<B>Richard Hughes</B>
|
|
<DL COMPACT><DT id="60"><DD>
|
|
Author.
|
|
</DL>
|
|
|
|
<A NAME="lbAK"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
<BR>
|
|
|
|
Copyright © 2007 - 2013 Richard Hughes
|
|
<BR>
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="61"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="62"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="63"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="64"><A HREF="#lbAE">COMMANDS</A><DD>
|
|
<DT id="65"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="66"><A HREF="#lbAG">RETURN VALUES</A><DD>
|
|
<DT id="67"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="68"><A HREF="#lbAI">AUTHOR</A><DD>
|
|
<DT id="69"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
<DT id="70"><A HREF="#lbAK">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:23 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|