Header Ads Widget

[MAN] org

Content-type: text/html; charset=UTF-8 Man page of org.debian.apt

org.debian.apt

Section: D-Bus Interface (7)
Updated: December 2009
Index Return to Main Contents
 

NAME

org.debian.apt - the main interface of aptdaemon  

SYNOPSIS

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

DESCRIPTION

 

METHODS

AddRepository
AddRepository (in 's' type,
in 's' uri,
in 's' dist,
in 'as' comps,
in 's' comment,
in '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 (in 's' comp)

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

GetTrustedVendorKeys
GetTrustedVendorKeys (out 'as' keys)

Return the GnuPG keys which are used to authenticate packages.

GetAtiveTransactions
GetActiveTransactions (out 'as' tids)

Return an array of the currently queued transactions.

Quit

Quit ()

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

 

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 org.debian.apt.transaction(7) interface. Afterwards the transaction has to be queued for processing by calling its Run method on the org.debian.apt.transaction(7) interface.
UpdateCache
UpdateCache (out 's' tid)

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.

UpdateCachePartially
UpdateCachePartially (in 's' sources_list,
out 's' tid)

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.

InstallPackages
InstallPackages (in 'as' package_names,
out 's' tid)

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

Optionally the to be installed version can be specified by appending a "=" and the version to the package name, e.g. "xterm=256-1".

InstallFile
InstallFile (in 's' path,
out 's' tid)

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

UpgradePackages
UpgradePackages (in 'as' package_names,
out 's' tid)

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

Optionally the to be installed version can be specified by appending a "=" and the version to the package name, e.g. "xterm=256-1".

RemovePackages
RemovePackages (in 'as' package_names,
out 's' tid)

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

Optionally the version of the to be removed packages can be specified by appending a "=" and the version to the package name, e.g. "xterm=256-1".

UpgradeSystem
UpgradeSystem (in 'b' safe_mode,
out '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 (in 'as' install,
in 'as' reinstall,
in 'as' remove,
in 'as' purge,
in 'as' upgrade,
in 'as' downgrade,
out '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.

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 "=" and the version to the package name, e.g. "xterm=256-1".

AddVendorKeyFromFile
AddVendorKeyFromFile (in 's' path,
out 's' tid)

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

AddVendorKeyFromKeyserver
AddVendorKeyFromKeyserver (in 's' keyid,
in 's' keyserver,
out 's' tid)

Return the id of a newly created transaction which will download and install the public GnuPG key of the keyid from the given keyserver to the list of trusted software vendors. The list will be used to authenticate packages.

RemoveVendorKey
RemoveVendorKey (in 's' fingerprint,
out 's' tid)

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

FixBrokenDepends
FixBrokenDepends (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 (out 's' tid)

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

 

SIGNALS

ActiveTransactionsChanged
ActiveTransactionsChanged ('s' active,
'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.

 

HOMEPAGE

https://launchpad.net/aptdaemon  

BUGS

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

AUTHOR

Sebastian Heinlein <devel at glatzor dot de>  

SEE ALSO

org.debian.apt.transaction(7), aptd(2), aptdcon(2)


 

Index

NAME
SYNOPSIS
DESCRIPTION
METHODS
TRANSACTION BASED METHODS
SIGNALS
HOMEPAGE
BUGS
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 04:45:56 GMT, September 16, 2022 Content-type: text/html; charset=UTF-8 Man page of org.debian.apt.transaction

org.debian.apt.transaction

Section: D-Bus Interface (7)
Updated: December 2009
Index Return to Main Contents
 

NAME

org.debian.apt.transaction - the main interface of an aptdaemon transaction  

SYNOPSIS

Each transaction is represented as an unique D-Bus object, e.g. at the D-Bus path /or/debian/apt/transaction/12123-123-123213. Which provides the following interface.  

DESCRIPTION

 

METHODS

ProvideMedium
ProvideMedium (in 's' medium)

Continue a paused transaction which is waiting for the given medium.

If a media change is required to e.g. install packages from a CD/DVD the transaction will be paused and the RequiredMedium property changed to an array of the medium label and its mount point. Furthermore the MediumRequired signal will be emitted.

ResolveConfigFileConflict
ResolveConfigFilePrompt (in 's' config,
in 's' answer)

Continue a paused transaction which is waiting for an answer to handle a configuration file conflict. Config is the path to the current configuration file and answer can be either "replace" or "keep".

If a later config file is shipped in a package which overrides some user modifications the transaction will be paused and the ConfigFileConflict property of the transaction will be set to an array of the old and new configuration file path. The later one is supposed to replace the former one. Furthermore the ConfigFileConflict signal will be emitted.

Simulate
Simulate ()

Simulate the transaction and calculate dependencies, required disk space and download size. If a transaction would fail the corresponding error will be raised.

Run
Run ()

Queue the transaction for processing. Afterwards there cannot be made any further changes to the transaction, e.g. modifing the http proxy.

Cancel
Cancel ()

Cancel the transaction if possible.

 

SIGNALS

Finished
Finished ('s' exit_state)

The signal will be emitted when the transaction has been processed. The exit_state indicates if the transaction was completed, cancelled or failed.

MediumRequired
MediumRequired ('s' label,
's' mount_point)

The signal will be emitted if the transaction has been paused and waits for a media change to install packages.

ConfigFileConflict
ConfigFileConflict ('s' old,
's' new)

The signal will be emitted if the transaction has been paused because a new configuration file is shipped in a package which would override changes by the user in the old configuration file.

PropertyChanged
PropertyChanged ('s' property_name ,
'v' value)

The signal will be emitted if one of the following properties has changed.

 

PROPERTIES

The properties of the transaction are available through the Get And GetAll methods of the D-Bus properties interface and can be changed using the Set method.
Role read 's'
The role enum of the transaction, e.g. update-cache.
Status read 's'
The current status enum of the transaction, e.g. downloading
StatusDetails read 's'
A clear text message describing the current status.
Progress read 'i'
The progress of the transaction in percent.
ProgressDownload read 'sssiis'
The last download progress information recieved from APT. It is an array of the URI, status enum, short description, full size, already downloaded size and an error or status message.
Space read 'i'
The additional disk space in Bytes which will be required by the transaction. The Simulate method has to be called to calculate the download size.
Download read 'i'
The required download size in Bytes of the transaction. The Simulate method has to be called to calculate the download size.
Packages read 'a(a(s)a(s)a(s)a(s)a(s)a(s)a(s))'
The lists of packages which are initially queued to be installed, reinstalled, removed, purged, upgraded, downgraded or skipped from upgrading.
Dependenciens read 'a(a(s)a(s)a(s)a(s)a(s)a(s)a(s))'
The lists of packages which are additionally required to be installed, reinstalled, removed, purged, upgraded, downgraded or skipped from upgrading. The Simulate method has to be called to calculate the dependencies.
Cancellable read 'b'
If the transaction can be cancelled.
TerminalAttached read 'b'
If the master pty which has to be set using the Terminal property is attached as controlling terminal to the underlying dpkg call.
RequiredMedium read 'a(ss)'
The transaction will be stopped if a media change is required to install packages. This property provides the label and the mount point of the requested medium.
ConfigFileConflict read 'a(ss)'
The transaction will be stopped if a configuration file shipped in the package overrides changes of the user. This property provides the path to current and the path to the new configuration file.
ExitState read 's'
The exit state enum of the transaction.
Error read 'a(ss)'
If an error occured this property provides the error enum and the error message.
Locale read-write 's'
This is the locale which will be used for translating status and error messages of apt, e.g. de_DE@utf-8.
Terminal read-write 's'
The path to the master pty which will be the controlling terminal of the underlying dpkg call. This allows to have an interactive terminal session.
DebconfSocket read-write 's'
The path to the socket which will be used by the debconf passthrough backend to forward the debconf communication to the user session.
Paused read 'b'
If the transaction is paused, e.g. waiting for a conflict file resolution or media change.
Unauthenticated read 'as'
List of unauthenticated packages which are going to be installed.
RemoveObsoletedDepends read-write 'b'
If obsoleted dependencies of to be removed packages which have been installed automatically should be removed too.
AllowUnauthenticated read-write 'b'
If it is allowed to install not authenticated software packages.
HttpProxy read-write 's'
The URL of an http proxy which should be used to download repository meta data and package files, e.g. http://myproxy.athome:8080. You should set the system wide proxy if you use this feature regularly. MetaData read-write 'a{ss}' A dictonary which allows client application to store additional data in the transaction. The key name has to include an identifier of the client application separated by an unterscore from the key name, e.g. sc_icon for the application icon name stored by software-center. The property cannot be changed anymore after the transaction has been queued.
 

HOMEPAGE

https://launchpad.net/aptdaemon  

BUGS

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

AUTHOR

Sebastian Heinlein <devel at glatzor dot de>  

SEE ALSO

org.debian.apt.transaction(7), aptd(2), aptdcon(2)


 

Index

NAME
SYNOPSIS
DESCRIPTION
METHODS
SIGNALS
PROPERTIES
HOMEPAGE
BUGS
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 04:45:57 GMT, September 16, 2022

댓글 쓰기

0 댓글