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

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