org.freedesktop.PackageKit

org.freedesktop.PackageKit — PackageKit interface

Methods

CanAuthorize       (in  's'  action_id,
                    out 's'  result)
GetTid             (out 's'  tid)
GetTimeSinceAction (in  's'  role,
                    out 'u'  seconds)
GetTransactionList (out 'as' transactions)
StateHasChanged    (in  's'  reason)
SuggestDaemonQuit  ()
GetDaemonState     (out 's'  state)
SetProxy           (in  's'  proxy_http,
                    in  's'  proxy_https,
                    in  's'  proxy_ftp,
                    in  's'  proxy_socks,
                    in  's'  no_proxy,
                    in  's'  pac)
SetRoot            (in  's'  root)

Signals

TransactionListChanged ('as' transactions)
RestartSchedule        ()
RepoListChanged        ()
UpdatesChanged         ()
Changed                ()

Implemented Interfaces

org.freedesktop.PackageKit implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties

Properties

'VersionMajor'       read      'u'
'VersionMinor'       read      'u'
'VersionMicro'       read      'u'
'BackendName'        read      's'
'BackendDescription' read      's'
'BackendAuthor'      read      's'
'Roles'              read      's'
'Groups'             read      's'
'Filters'            read      's'
'MimeTypes'          read      's'
'Locked'             read      'b'
'NetworkState'       read      's'
'DistroId'           read      's'

Description

The root interface is used for interacting with the daemon.

Details

CanAuthorize ()

CanAuthorize (in  's' action_id,
              out 's' result)

Allows a client to find out if it would be allowed to authorize an action.

`action_id`:	The action ID, e.g. org.freedesktop.packagekit.system-network-proxy-configure
`result`:	The result, either yes, no or interactive.

GetTid ()

GetTid (out 's' tid)

Gets a new transaction ID from the daemon

tid:

The tid, e.g. 45_dafeca_checkpoint32

GetTimeSinceAction ()

GetTimeSinceAction (in  's' role,
                    out 'u' seconds)

This method allows us to query how long since an action has successfully completed.

`role`:	The role, e.g. update-system
`seconds`:	The amount of time in seconds

GetTransactionList ()

GetTransactionList (out 'as' transactions)

Gets the transaction list of any transactions that are in progress

transactions:

A list of transaction ID's

StateHasChanged ()

StateHasChanged (in  's' reason)

This method suggests to PackageKit that the package backend state may have changed. This allows plugins to the native package manager to suggest that PackageKit drops it's caches.

reason:

The reason of the state change. Valid reasons are resume or posttrans. Resume is given a lower priority than posttrans.

SuggestDaemonQuit ()

SuggestDaemonQuit ()

Suggests to the daemon that it should quit as soon as possible, for instance if a native package management tool is waiting to be used.

GetDaemonState ()

GetDaemonState (out 's' state)

Gets the debugging state from the daemon. No secure state will be shown, and all information is for reference only.

state:

The state of the dameon at this specific moment.

SetProxy ()

SetProxy (in  's' proxy_http,
          in  's' proxy_https,
          in  's' proxy_ftp,
          in  's' proxy_socks,
          in  's' no_proxy,
          in  's' pac)

Sets the proxy used by the dameon.

`proxy_http`:	The HTTP proxy, e.g. username:password@server:port.
`proxy_https`:	The HTTPS proxy, e.g. username:password@server:port.
`proxy_ftp`:	The FTP proxy, e.g. username:password@server:port.
`proxy_socks`:	The SOCKS proxy, e.g. username:password@server:port.
`no_proxy`:	The comma seporated list of sites to not use the proxy for, e.g. 127.0.0.1,localmirror.org.
`pac`:	The PAC file for the proxy, e.g. /etc/network/school.pac. Note: Most backends will not be able to use a PAC file.

Callers need the org.freedesktop.packagekit.set-proxy

SetRoot ()

SetRoot (in  's' root)

Sets the root used by the dameon backend.

root:

The install root, e.g. / or /mnt/ltsp.

Callers need the org.freedesktop.packagekit.system-change-install-root

Signal Details

The TransactionListChanged signal

TransactionListChanged ('as' transactions)

The transaction list has changed, because either a transaction has finished or a new transaction created.

transactions:

A list of transaction ID's.

The RestartSchedule signal

RestartSchedule ()

A system restart has been sceduled

The RepoListChanged signal

RepoListChanged ()

This signal is emitted when the repository list has changed

The UpdatesChanged signal

UpdatesChanged ()

This signal is emitted when the number of updates has changed

The Changed signal

Changed ()

This signal is emitted when a property on the interface changes.

Property Details

The "VersionMajor" property

'VersionMajor'  read      'u'

The major version number.

The "VersionMinor" property

'VersionMinor'  read      'u'

The minor version number.

The "VersionMicro" property

'VersionMicro'  read      'u'

The micro version number.

The "BackendName" property

'BackendName'  read      's'

The backend name, e.g. "yum".

The "BackendDescription" property

'BackendDescription'  read      's'

The backend description, e.g. "Yellow Dog Update Modifier".

The "BackendAuthor" property

'BackendAuthor'  read      's'

The backend author, e.g. "Joe Bloggs <joe&blogs.com>".

The "Roles" property

'Roles'  read      's'

The roles the backend supports, e.g. "search-name;refresh-cache".

The "Groups" property

'Groups'  read      's'

The groups the backend supports, e.g. "accessories;games".

The "Filters" property

'Filters'  read      's'

The filters the backend supports, e.g. "installed;newest".

The "MimeTypes" property

'MimeTypes'  read      's'

The mime-types the backend supports, e.g. "application/x-rpm;application/x-deb".

The "Locked" property

'Locked'  read      'b'

Set when the backend is locked and native tools would fail.

The "NetworkState" property

'NetworkState'  read      's'

Gets the network state from the daemon. This is provided as some clients may not want to use NetworkManager if the system daemon is configured to use something else.

If the system is managed using NetworkManager then the following states are supported: unknown, offline, online, wifi, mobile or wired. If the system is configured for legacy UNIX network fallback, or NetworkManager is not running then the folowing states are supported: unknown, offline or online.

The "DistroId" property

'DistroId'  read      's'

The distribution identification, in the distro;version;arch form e.g. "debian;squeeze/sid;x86_64".

			PackageKit Reference Manual
Top \| Description \| Implemented Interfaces \| Properties \| Signals