1. NAME

org.debian.apt - the main interface of aptdaemon

2. SYNOPSIS

The daemon is accessed through the D-Bus object at /or/debian/apt . Which provides the following interface.

3. DESCRIPTION

3.1. METHODS

AddRepository

    AddRepository\t(in 's' type ,
\t\tin 's' uri ,
\t\tin 's' dist ,
\t\tin 'as' comps ,
\t\tin 's' comment ,
\t\tin 's' sourcesfile )

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. http://archive.debian.org/debian), the distribution (e.g. stable) and a list of components (e.g. main).

Optionally a comment and an alternative sources.list file can be specified.

EnableDistroComponent

    EnableDistroComponent\t(in 's' comp )

Enable a component for all distro repositories, e.g. main or universe.

GetTrustedVendorKeys

    GetTrustedVendorKeys\t(out 'as' keys )

Return the GnuPG keys which are used to authenticate packages.

GetAtiveTransactions

    GetActiveTransactions\t(out 'as' tids )

Return an array of the currently queued transactions.

Quit

    
Quit\t()

Request the shutdown of the daemon. The daemon will finish a currently running transaction before.

3.2. TRANSACTION BASED METHODS

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

R org.debian.apt.transaction (7) interface. Afterwards the transaction has to be queued for processing by calling its Run method on the

R org.debian.apt.transaction (7) interface.

UpdateCache

    UpdateCache\t(out 's' tid )

Return the id of a newly created transaction which will fetch the latest meta data from the repositories an rebuild the cache of available and installed packages.

InstallPackages

    InstallPackages\t(in 'as' package_names ,
\t\tout 's' tid )

Return the id of a newly created transaction which will install the packages of the given names.

InstallFile

    InstallFile\t(in 's' path ,
\t\tout 's' tid )

Return the id of a newly create transaction which will install a local *.deb package file at the given path .

UpgradePackages

    UpgradePackages\t(in 'as' package_names ,
\t\t\tout 's' tid )

Return the id of a newly created transaction which will upgrade the packages of the given names to their latest version.

RemovePackages

    RemovePackages\t(in 'as' package_names ,
\t\t\tout 's' tid )

Return the id of a newly created transaction which will remove the packages of the given names.

UpgradeSystem

    UpgradeSystem\t(in 'b' safe_mode ,
\t\tout 's' tid )

Return the id of a newly created transaction which will upgrade the whole system.

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.

CommitPackages

    CommitPackages\t(in 'as' install ,
\t\t\tin 'as' reinstall,
\t\t\tin 'as' remove,
\t\t\tin 'as' purge,
\t\t\tin 'as' upgrade ,
\t\t\tout 's' tid )

Return the id of a newly created transaction which will perform a complex install/removal task at once. Install ", " reinstall ", " remove ", " purge " and " upgrade are lists of package names.

AddVendorKeyFromFile

    AddVendorKeyFromFile\t(in 's' path ,
"\t\t\tout 's' " tid )

Return the id of a newly created transaction which will install the public GnuPB key at the given path to the list of trusted software vendors. The list will be used to authenticate packages.

RemoveVendorKey

    AddVendorKeyFromFile\t(in 's' fingerprint ,
"\t\t\tout 's' " tid )

Return the id of a newly created transaction which will remove the public GnuPB key with the given fingerprint from the list of trusted software vendors. The list will be used to authenticate packages.

FixBrokenDepends

    FixBrokenDepends\t(out 's' tid )

Return the id of a newly created transaction which will try to resolve unsatisfied dependencies by installing required packages or removing conflicting ones.

FixIncompleteInstall

    FixIncompleteInstall\t(out 's' tid )

Return the id of a newly created transaction which will try to complete previously failed installations by calling "dpkg --configure -a".

3.3. SIGNALS

ActiveTransactionsChanged

    ActiveTransactionsChanged\t('s' active ,
\t\t\t\t'as' queued )

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.

4. HOMEPAGE

5. BUGS

You can report bugs at the Launchpad site of aptdaemon: https://bugs.launchpad.net/aptdaemon/+filebug

6. AUTHOR

Sebastian Heinlein <devel at glatzor dot de>

7. SEE ALSO

R org.debian.apt.transaction (7),

R aptd (2),

R aptdcon (2)