org.freedesktop.packagekit1 D-Bus Interface

org.freedesktop.packagekit1

Description

The root interface is used for interacting with the daemon.

Properties

org.freedesktop.packagekit1:VersionMajor

    VersionMajor readable u

The major version number.

org.freedesktop.packagekit1:VersionMinor

    VersionMinor readable u

The minor version number.

org.freedesktop.packagekit1:VersionMicro

    VersionMicro readable u

The micro version number.

org.freedesktop.packagekit1:BackendName

    BackendName readable s

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

org.freedesktop.packagekit1:BackendDescription

    BackendDescription readable s

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

org.freedesktop.packagekit1:BackendAuthor

    BackendAuthor readable s

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

org.freedesktop.packagekit1:Roles

    Roles readable t

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

org.freedesktop.packagekit1:Groups

    Groups readable t

The groups the backend supports, e.g. accessories|games.

org.freedesktop.packagekit1:Filters

    Filters readable t

The filters the backend supports, e.g. installed|newest.

org.freedesktop.packagekit1:MimeTypes

    MimeTypes readable as

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

org.freedesktop.packagekit1:Locked

    Locked readable b

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

org.freedesktop.packagekit1:NetworkState

    NetworkState readable u

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.

org.freedesktop.packagekit1:DistroId

    DistroId readable s

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

org.freedesktop.packagekit1:RebootRequired

    RebootRequired readable a{sv}

Whether a system restart is required to complete package changes made since the system was booted. Recognized keys are "restart", the restart type which is either none or system [u], and "package-ids", the packages that caused the restart to be required [as].

Only system restarts are tracked, as the daemon cannot tell when a session or an application has been restarted.

Methods

org.freedesktop.packagekit1.CanAuthorize

    CanAuthorize (
      IN action_id s,
      OUT result u
    )

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

Returns:

  • result: The result, either yes, no or interactive.

  • action_id: The action ID, e.g. org.freedesktop.packagekit.system-network-proxy-configure

org.freedesktop.packagekit1.CreateTransaction

    CreateTransaction (
      OUT object_path o
    )

Creates a new transaction that can have operations done on it. Note: The dameon will automatically destroy this transaction if it is not used after a few minutes.

Returns:

  • object_path: The object_path, e.g. /45_dafeca

org.freedesktop.packagekit1.GetTimeSinceAction

    GetTimeSinceAction (
      IN role u,
      OUT seconds u
    )

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

Returns:

  • seconds: The amount of time in seconds

  • role: The role enum, e.g. update-system

org.freedesktop.packagekit1.GetTransactionList

    GetTransactionList (
      OUT transactions ao
    )

Gets the transaction list of any transactions that are in progress

Returns:

  • transactions: A list of transaction ID’s

org.freedesktop.packagekit1.StateHasChanged

    StateHasChanged (
      IN reason s
    )

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.

org.freedesktop.packagekit1.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.

org.freedesktop.packagekit1.GetPackageHistory

    GetPackageHistory (
      IN names as,
      IN count u,
      OUT history a{saa{sv}}
    )

Gets the history for a given package name. This uses the internal PackageKit history database and will not return transactions done outside of PackageKit using a distribution native tool.

Returns:

  • history: The list of actions performed on this package. The array may contain the following keys of types: info[uint], user-id[uint], version[string], source[string], timestamp[uint64]. Other keys and values may be added in the future.

  • names: The package names to return history for, e.g. [ colord ].

  • count: The maximum number of past transactions to return, or 0 for no limit.

org.freedesktop.packagekit1.GetDaemonState

    GetDaemonState (
      OUT state s
    )

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

Returns:

  • state: The state of the dameon at this specific moment.

org.freedesktop.packagekit1.SetProxy

    SetProxy (
      IN proxy_http s,
      IN proxy_https s,
      IN proxy_ftp s,
      IN proxy_socks s,
      IN no_proxy s,
      IN pac s
    )

Sets the proxy used by the dameon.

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

  • proxy_http: The HTTP proxy, e.g. username:passwordserver:port.

  • proxy_https: The HTTPS proxy, e.g. username:passwordserver:port.

  • proxy_ftp: The FTP proxy, e.g. username:passwordserver:port.

  • proxy_socks: The SOCKS proxy, e.g. username:passwordserver: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.

Signals

org.freedesktop.packagekit1::TransactionListChanged

    TransactionListChanged (
      transactions as
    )

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

transactions A list of transaction ID’s.

org.freedesktop.packagekit1::RestartSchedule

    RestartSchedule ()

A system restart has been sceduled

org.freedesktop.packagekit1::InstalledChanged

    InstalledChanged ()

This signal is emitted when the set of installed apps has potentially changed.

org.freedesktop.packagekit1::RepoListChanged

    RepoListChanged ()

This signal is emitted when the repository list has changed

org.freedesktop.packagekit1::UpdatesChanged

    UpdatesChanged ()

This signal is emitted when the number of updates has changed