org.freedesktop.PackageKit

org.freedesktop.PackageKit — PackageKit interface

Methods

CanAuthorize       (in  's'  action_id,
                    out 's'  result)
GetActions         (out 's'  actions)
GetBackendDetail   (out 's'  name,
                    out 's'  author)
GetFilters         (out 's'  filters)
GetGroups          (out 's'  groups)
GetMimeTypes       (out 's'  types)
GetTid             (out 's'  tid)
GetTimeSinceAction (in  's'  role,
                    out 'u'  seconds)
GetTransactionList (out 'as' transactions)
StateHasChanged    (in  's'  reason)
SuggestDaemonQuit  ()
GetNetworkState    (out 's'  state)
GetDaemonState     (out 's'  state)
SetProxy           (in  's'  proxy_http,
                    in  's'  proxy_ftp)

Signals

TransactionListChanged ('as' transactions)
Locked                 ('b'  is_locked)
NetworkStateChanged    ('s'  state)
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.

GetActions ()

GetActions (out 's' actions)

Gets a list of all the actions that are supported by the backend.

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

actions:

A list of actions, e.g. search-name;get-updates;update-system

GetBackendDetail ()

GetBackendDetail (out 's' name,
                  out 's' author)

Gets any details about the backend being used by PackageKit

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

name:

The name of the backend, e.g. yum

author:

The author of the backend, e.g. Richard Hughes <richard@hughsie.com>

GetFilters ()

GetFilters (out 's' filters)

Gets the list of filters that the backend supports

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

filters:

The list of filters as a string, e.g. installed;devel

GetGroups ()

GetGroups (out 's' groups)

Gets the groups that are supported

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

groups:

The group list, e.g. accesories;games;system

GetMimeTypes ()

GetMimeTypes (out 's' types)

Gets the MIME types of packages that are supported

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

types:

The MIME list, e.g. application/x-rpm;application/x-deb

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.


GetNetworkState ()

GetNetworkState (out 's' state)

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.

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

state:

The network state. 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.

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_ftp)

Sets the proxy used by the dameon.

proxy_http:

The HTTP proxy, e.g. username:password@server:port.

proxy_ftp:

The FTP proxy, e.g. username:password@server:port.

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

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 Locked signal

Locked ('b' is_locked)

This signal is emitted when the backend is locked and native tools would fail.

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

is_locked:

If we have locked the package backend.

The NetworkStateChanged signal

NetworkStateChanged ('s' state)

This signal is emitted when the network state has changed

THIS FUNCTION IS DEPRECATED. It will be removed in a future release. Use the properties interface for the transaction instead.

state:

The new network state

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".