man-pages/man7/org.debian.apt.7.html
2021-03-31 01:06:50 +01:00

435 lines
10 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of org.debian.apt</TITLE>
</HEAD><BODY>
<H1>org.debian.apt</H1>
Section: D-Bus Interface (7)<BR>Updated: December 2009<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
org.debian.apt - the main interface of aptdaemon
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
The daemon is accessed through the D-Bus object at
<I>/org/debian/apt</I>.
Which provides the following interface.
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<A NAME="lbAE">&nbsp;</A>
<H3>METHODS</H3>
<DL COMPACT>
<DT id="1"><B>AddRepository </B>
<DD>
<B>AddRepository (in 's' </B><I>type</I><B>,</B>
<BR>
<B> in 's' </B><I>uri</I><B>,</B>
<BR>
<B> in 's' </B><I>dist</I><B>,</B>
<BR>
<B> in 'as' </B><I>comps</I><B>,</B>
<BR>
<B> in 's' </B><I>comment</I><B>,</B>
<BR>
<B> in 's' </B><I>sourcesfile</I><B>)</B>
<DL COMPACT><DT id="2"><DD>
<P>
Add a new repository to the sources list file. The repository has to define the type (e.g. deb or deb-src), uri (e.g. <A HREF="http://archive.debian.org/debian),">http://archive.debian.org/debian),</A> the distribution (e.g. stable) and a list of components (e.g. main).
<P>
Optionally a comment and an alternative sources.list file can be specified.
</DL>
<DT id="3"><B>EnableDistroComponent</B>
<DD>
<B>EnableDistroComponent (in 's' </B><I>comp</I><B>)</B>
<DL COMPACT><DT id="4"><DD>
<P>
Enable a component for all distro repositories, e.g. main or universe.
</DL>
<DT id="5"><B>GetTrustedVendorKeys</B>
<DD>
<B>GetTrustedVendorKeys (out 'as' </B><I>keys</I><B>)</B>
<DL COMPACT><DT id="6"><DD>
<P>
Return the GnuPG keys which are used to authenticate packages.
</DL>
<DT id="7"><B>GetAtiveTransactions</B>
<DD>
<B>GetActiveTransactions (out 'as' </B><I>tids</I><B>)</B>
<DL COMPACT><DT id="8"><DD>
<P>
Return an array of the currently queued transactions.
</DL>
<DT id="9"><B>Quit</B>
<DD>
<BR>
<B>Quit ()</B>
<DL COMPACT><DT id="10"><DD>
<P>
Request the shutdown of the daemon. The daemon will finish a currently running transaction before.
</DL>
</DL>
<A NAME="lbAF">&nbsp;</A>
<H3>TRANSACTION BASED METHODS</H3>
The following methods are handled by transactions. By calling the methods a new transaction will be created for the task. The return value of the method is the D-Bus object path of the corresponding transaction. The transaction can be modified, to use an http proxy or to run in a specific language by setting the corresponding properties on the
<B><A HREF="/cgi-bin/man/man2html?7+org.debian.apt.transaction">org.debian.apt.transaction</A></B>(7)
interface. Afterwards the transaction has to be queued for processing by calling its Run method on the
<B><A HREF="/cgi-bin/man/man2html?7+org.debian.apt.transaction">org.debian.apt.transaction</A></B>(7)
interface.
<DL COMPACT>
<DT id="11"><B>UpdateCache</B>
<DD>
<B>UpdateCache (out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="12"><DD>
<P>
Return the id of a newly created transaction which will fetch the latest meta data from the repositories and rebuild the cache of available and installed packages.
</DL>
<DT id="13"><B>UpdateCachePartially</B>
<DD>
<B>UpdateCachePartially (in 's' </B><I>sources_list</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="14"><DD>
<P>
Return the id of a newly created transaction which will fetch the latest meta data from the repositories specified in the given sources.list snippet only and rebuild the cache of available and installed packages.
</DL>
<DT id="15"><B>InstallPackages</B>
<DD>
<B>InstallPackages (in 'as' </B><I>package_names</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="16"><DD>
<P>
Return the id of a newly created transaction which will install the packages
of the given names.
<P>
Optionally the to be installed version can be specified by
appending a &quot;=&quot; and the version to the package name, e.g. &quot;xterm=256-1&quot;.
</DL>
<DT id="17"><B>InstallFile</B>
<DD>
<B>InstallFile (in 's' </B><I>path</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="18"><DD>
<P>
Return the id of a newly create transaction which will install a local *.deb
package file at the given
<I>path</I>.
</DL>
<DT id="19"><B>UpgradePackages</B>
<DD>
<B>UpgradePackages (in 'as' </B><I>package_names</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="20"><DD>
<P>
Return the id of a newly created transaction which will upgrade the packages of the given names to their latest version.
<P>
Optionally the to be installed version can be specified by
appending a &quot;=&quot; and the version to the package name, e.g. &quot;xterm=256-1&quot;.
</DL>
<DT id="21"><B>RemovePackages</B>
<DD>
<B>RemovePackages (in 'as' </B><I>package_names</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="22"><DD>
<P>
Return the id of a newly created transaction which will remove the packages of the given names.
<P>
Optionally the version of the to be removed packages can be specified by
appending a &quot;=&quot; and the version to the package name, e.g. &quot;xterm=256-1&quot;.
</DL>
<DT id="23"><B>UpgradeSystem</B>
<DD>
<B>UpgradeSystem (in 'b' </B><I>safe_mode</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="24"><DD>
<P>
Return the id of a newly created transaction which will upgrade the whole system.
<P>
If in safe mode only already installed packages will be updated. Updates which require to remove installed packages or to install additional packages will be skipped.
</DL>
<DT id="25"><B>CommitPackages</B>
<DD>
<B>CommitPackages (in 'as' </B><I>install</I><B>,</B>
<BR>
<B> in 'as' </B><I>reinstall,</I>
<BR>
<B> in 'as' </B><I>remove,</I>
<BR>
<B> in 'as' </B><I>purge,</I>
<BR>
<B> in 'as' </B><I>upgrade</I><B>,</B>
<BR>
<B> in 'as' </B><I>downgrade</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="26"><DD>
<P>
Return the id of a newly created transaction which will perform a complex install/removal task at once.
<I>Install</I>, <I>reinstall</I>, <I>remove</I>, <I>purge</I> and <I>upgrade</I>
are lists of package names.
<P>
Optionally the version of the to be removed packages or the version of the
package which should be installed can be specified by
appending a &quot;=&quot; and the version to the package name, e.g. &quot;xterm=256-1&quot;.
</DL>
<DT id="27"><B>AddVendorKeyFromFile</B>
<DD>
<B>AddVendorKeyFromFile (in 's' </B><I>path</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="28"><DD>
<P>
Return the id of a newly created transaction which will install the public GnuPG key at the given
<I>path</I>
to the list of trusted software vendors. The list will be used to authenticate packages.
</DL>
<DT id="29"><B>AddVendorKeyFromKeyserver</B>
<DD>
<B>AddVendorKeyFromKeyserver (in 's' </B><I>keyid</I><B>,</B>
<BR>
<B> in 's' </B><I>keyserver,</I>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="30"><DD>
<P>
Return the id of a newly created transaction which will download and install the public GnuPG key of the
<I>keyid</I>
from the given
<I>keyserver</I>
to the list of trusted software vendors. The list will be used to authenticate packages.
</DL>
<DT id="31"><B>RemoveVendorKey</B>
<DD>
<B>RemoveVendorKey (in 's' </B><I>fingerprint</I><B>,</B>
<BR>
<B> out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="32"><DD>
<P>
Return the id of a newly created transaction which will remove the public GnuPG key with the given
<I>fingerprint</I>
from the list of trusted software vendors. The list will be used to authenticate packages.
</DL>
<DT id="33"><B>FixBrokenDepends</B>
<DD>
<B>FixBrokenDepends (out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="34"><DD>
<P>
Return the id of a newly created transaction which will try to resolve unsatisfied dependencies by installing required packages or removing conflicting ones.
</DL>
<DT id="35"><B>FixIncompleteInstall</B>
<DD>
<B>FixIncompleteInstall (out 's' </B><I>tid</I><B>)</B>
<DL COMPACT><DT id="36"><DD>
<P>
Return the id of a newly created transaction which will try to complete previously failed installations by calling &quot;dpkg --configure -a&quot;.
</DL>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>SIGNALS</H3>
<DL COMPACT>
<DT id="37"><B>ActiveTransactionsChanged</B>
<DD>
<B>ActiveTransactionsChanged ('s' </B><I>active</I><B>,</B>
<BR>
<B> 'as' </B><I>queued</I><B>)</B>
<DL COMPACT><DT id="38"><DD>
<P>
The signal is used to report changes of the currently running or queued
transactions. If there's any active transaction active will be an empty
string.
</DL>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H2>HOMEPAGE</H2>
<A HREF="https://launchpad.net/aptdaemon">https://launchpad.net/aptdaemon</A>
<A NAME="lbAI">&nbsp;</A>
<H2>BUGS</H2>
You can report bugs at the Launchpad site of aptdaemon:
<A HREF="https://bugs.launchpad.net/aptdaemon/+filebug">https://bugs.launchpad.net/aptdaemon/+filebug</A>
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
Sebastian Heinlein &lt;devel at glatzor dot de&gt;
<A NAME="lbAK">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?7+org.debian.apt.transaction">org.debian.apt.transaction</A></B>(7),
<B><A HREF="/cgi-bin/man/man2html?2+aptd">aptd</A></B>(2),
<B><A HREF="/cgi-bin/man/man2html?2+aptdcon">aptdcon</A></B>(2)
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="39"><A HREF="#lbAB">NAME</A><DD>
<DT id="40"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="41"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="42"><A HREF="#lbAE">METHODS</A><DD>
<DT id="43"><A HREF="#lbAF">TRANSACTION BASED METHODS</A><DD>
<DT id="44"><A HREF="#lbAG">SIGNALS</A><DD>
</DL>
<DT id="45"><A HREF="#lbAH">HOMEPAGE</A><DD>
<DT id="46"><A HREF="#lbAI">BUGS</A><DD>
<DT id="47"><A HREF="#lbAJ">AUTHOR</A><DD>
<DT id="48"><A HREF="#lbAK">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:09 GMT, March 31, 2021
</BODY>
</HTML>