DNF5DAEMON-DBUS-API(8) dnf5 DNF5DAEMON-DBUS-API(8)

dnf5daemon-dbus-api - DBus API Reference for Dnf5daemon

Dbus methods and arguments. Generated from dbus XMLs.

Note: While most of the following methods can be invoked successfully by a regular user, authentication by an administrative user is required for some of them (e.g. Goal.do_transaction(), Repo.confirm_key(), Repo.enable(), Repo.disable()). This authentication is managed by calling CheckAuthorization() method of the org.freedesktop.PolicyKit1.Authority Polkit D-Bus interface. The AllowUserInteraction flag is set for this call, indicating that if an authentication agent is available, the call is blocked while the user is prompted to authenticate. A hardcoded timeout of 2 minutes is set for the user interaction.

•
options (a{sv}) -- an array of key/value pairs to modify dependency resolving
  • transaction_items (a(sssa{sv}a{sv})) -- array of (object_type, action, reason, {transaction_item_attributes}, {object}) tuples. object_type is one of libdnf5::transaction::TransactionItemType, action is one of libdnf5::transaction::TransactionItemAction, reason is one of libdnf5::transaction::TransactionItemReason enums. Each of these enums are represented as strings using corresponding libdnf5::transaction::*_to_string() methods. transaction_item_attributes is a map {attribute: value}. Currently "reason_change_group_id" attribute is used for target group id in case the action is ReasonChange and the reason Group, and "replaces" containing a vector of packages ids being replaced by this item. Finally the object is a map {attribute: value} and represents (according to object_type) package, group, environment, or module. These package attributes are returned: "name", "epoch", "version", "release", "arch", "repo_id", "from_repo_id", "package_size", "install_size", "evr", and "reason". For groups the object contains "groupid" and "name" attributes.
  • result (u) -- problems detected during transaction resolving. Possible values are 0 - no problem, 1 - no problem, but some info / warnings are present or 2 - resolving failed.

Resolve the transaction.

•
Whether removal of installed package is allowed to resolve the transaction.

Unknown options are ignored.

•
problems (as) -- array of strings containing all problems found during the transaction resolution.

Return all problems found during the transaction resolution as human readable messages.

•
problems (aa{sv}) -- array of {key: value} maps

Return all problems found during the transaction resolution as structures. This is the list of problem keys: always present: action - see include/libdnf5/base/goal_elements.hpp: GoalAction problem - see include/libdnf5/base/goal_elements.hpp: GoalProblem optional: goal_job_settings - {string: variant}, settings used to resolve the goal spec - string, usually nevra of affected package additional_data - array of strings, more details on the problem solver_problems - problems reported by underlying libsolv

•
options (a{sv}) -- an array of key/value pairs to modify transaction running

Perform the resolved transaction.

•
Adds a comment to a transaction.
•
If true, the transaction will be prepared to run during the next reboot. Otherwise, it will run immediately.

Unknown options are ignored.

  • success (b) -- true if the cancellation was sucessfully requested
  • error_msg (s) -- error message if the cancellation was refused

Cancel the transaction that was initiated by do_transaction(). The transaction can only be canceled during the package download phase. Once the RPM transaction has begun, cancellation is no longer permitted.

Reset the prepared rpm transaction. After this call the session is ready to perform another rpm transaction.

•
options (a{sv}) -- session configuration - an array of key/value pairs
•
session_object_path (o) -- object path to created Session object

Opens a new session.

Following configuration options are supported:

•
If true information about currently installed packages is loaded.
•
If true information about packages available in enabled repositories is loaded.
•
Override configuration options.
•
Override releasever variable used for substitutions in repository configurations.
•
Override server locale for this session. Affects language used in various error messages.

Unknown options are ignored.

•
session_object_path (o) -- object path of session to close
•
success (b) -- bool whether the requested session was successfully closed

Close session on given object path.

•
options (a{sv}) -- an array of key/value pairs
•
repositories (aa{sv}) -- array of returned repositories with requested attributes

Get list of repositories that match to given filters.

Following options are supported:

•
any repository with id matching to any of patterns is returned
•
list of repository attributes that are returned
•
When set to "enabled" or "disabled", only enabled / disabled repositories are listed. Any other value means all repositories are returned.

Unknown options are ignored.

  • key_id (s) -- id of the key in question
  • confirmed (b) -- whether the key import is confirmed by user

Confirm repository OpenPGP key import.

•
repo_ids (as) -- array of strings containing all repo ids to be enabled

Enable repositories based on the list of given ids.

•
repo_ids (as) -- array of strings containing all repo ids to be disabled

Disable repositories based on the list of given ids.

•
options (a{sv}) -- an array of key/value pairs
•
packages (aa{sv}) -- array of returned packages with requested attributes

Get list of packages that match to given filters. Since the method returns packages directly in the D-Bus method reply message, which has a limited size, there is a possibility that the requested package set size would exceed this limit. If you request a large number of packages and/or a great number of package attributes, please consider using the list_fd() method.

Following options and filters are supported:

•
list of package attributes that are returned. Supported attributes are name, epoch, version, release, arch, repo_id, from_repo_id, is_installed, install_size, download_size, buildtime, sourcerpm, summary, url, license, description, files, changelogs, provides, requires, requires_pre, conflicts, obsoletes, recommends, suggests, enhances, supplements, evr, nevra, full_nevra, reason, vendor, group.
•
match patterns against available packages NEVRAs
•
match patterns against available packages provides
•
match patterns against names of the files in available packages
•
match patterns against names of the binaries in /usr/(s)bin in available packages
•
include source rpms into the results
•
ignore case while matching patterns
•
any package matching to any of patterns is returned
•
limit packages to one of "all", "installed", "available", "upgrades", "upgradable"
•
limit the resulting set only to packages of given architectures
•
limit the resulting set only to packages from given repositories
•
limit the resulting set to only <limit> of latest packages for every name and architecture
•
limit the resulting set only to packages that provide any of given capabilities
•
limit the resulting set only to packages that require, enhance, recommend, suggest or supplement any of given capabilities
•
limit the resulting set only to packages that require any of given capabilities
•
limit the resulting set only to packages that recommend any of given capabilities
•
limit the resulting set only to packages that enhance any of given capabilities
•
limit the resulting set only to packages that suggest any of given capabilities
•
limit the resulting set only to packages that supplement any of given capabilities
•
limit the resulting set only to packages that obsolete any of given capabilities
•
limit the resulting set only to packages that conflict with any of given capabilities

Unknown options are ignored.

  • options (a{sv}) -- an array of key/value pairs
  • file_descriptor (h) -- File descriptor opened for writing used to transfer data
•
transfer_id (s) -- Identifier of this transfer. Used for signaling the end of transfer.

Retrieve a list of packages that match the provided filters. Packages are transmitted as a stream of JSON objects, with each JSON object representing one package as a dictionary. This stream is then written into the given file_descriptor. Unlike the list() method, this approach does not encounter issues with large output data. The server has a 30-second timeout during which it waits for the client to read data from the pipe if the pipe is full.

The same options as in list() method are supported.

  • pkg_specs (as) -- an array of package specifications to be installed on the system
  • options (a{sv}) -- an array of key/value pairs to modify install behavior

Mark packages specified by @pkg_specs for installation.

Following @options are supported:

•
Identifiers of the repos from which the packages could be installed.
•
Whether solver can skip packages with broken dependencies to resolve transaction
•
Whether nonexisting packages can be skipped.

Unknown options are ignored.

  • pkg_specs (as) -- an array of package specifications to be upgraded on the system
  • options (a{sv}) -- an array of key/value pairs to modify upgrade behavior

Mark packages specified by @pkg_specs for upgrade.

Following @options are supported:

•
Identifiers of the repos from which the packages could be upgraded.

Unknown options are ignored.

  • pkg_specs (as) -- an array of package specifications to be removed on the system
  • options (a{sv}) -- an array of key/value pairs to modify remove behavior

Mark packages specified by @pkg_specs for removal.

Unknown options are ignored.

  • pkg_specs (as) -- array of package specifications to synchronize to the latest available versions
  • options (a{sv}) -- an array of key/value pairs to modify distro_sync behavior

Following @options are supported:

Unknown options are ignored.

  • pkg_specs (as) -- an array of package specifications to be downgraded on the system
  • options (a{sv}) -- an array of key/value pairs to modify downgrade behavior

Mark packages specified by @pkg_specs for downgrade.

Following @options are supported:

Unknown options are ignored.

  • pkg_specs (as) -- an array of package specifications to be reinstalled on the system
  • options (a{sv}) -- an array of key/value pairs to modify reinstall behavior

Mark packages specified by @pkg_specs for reinstall.

Following @options are supported:

Unknown options are ignored.

•
options (a{sv}) -- an array of key/value pairs to modify system_upgrade behavior

Prepare a transaction for upgrade to the new distribution release. The prepared transaction should be executed during reboot (see offline option of the do_transaction method of the Goal interface). The method relies on the releasever option being correctly set to the new distribution release during the open_session() call.

Following @options are supported:

•
By default the system_upgrade behaves like dnf distro-sync, always installing packages from the new release, even if they are older than the currently installed version. If set to "upgrade", packages from the new release are not installed if they are older than what is currently installed (behave like dnf upgrade).

Unknown options are ignored.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package
  • processed (t) -- amount already processed
  • total (t) -- total to process

Overall progress in transaction item processing. Called right before an item is processed.

  • session_object_path (o) -- object path of the dnf5daemon session
  • total (t) -- number of elements in the rpm transaction

Send right before the rpm transaction is run.

  • session_object_path (o) -- object path of the dnf5daemon session
  • success (b) -- true if the rpm transaction was completed successfully

Send right after the rpm transaction run finished.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package
  • action (u) -- one of the dnfdaemon::RpmTransactionItem::Actions enum
  • total (t) -- total to process

Processing (installation or removal) of the package has started.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package
  • processed (t) -- amount already processed
  • total (t) -- total to process

Progress in processing of the package.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package
  • total (t) -- total processed

Processing of the package has finished.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package script belongs to
  • scriptlet_type (u) -- scriptlet type that started (pre, post,...)

The scriptlet has started.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package script belongs to
  • scriptlet_type (u) -- scriptlet type that started (pre, post,...)
  • return_code (t) -- return value of the script

The scriptlet has successfully finished.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package script belongs to
  • scriptlet_type (u) -- scriptlet type that started (pre, post,...)
  • return_code (t) -- return value of the script

The scriptlet has finished with an error.

  • session_object_path (o) -- object path of the dnf5daemon session
  • total (t) -- total to process

Package files verification has started.

  • session_object_path (o) -- object path of the dnf5daemon session
  • processed (t) -- amount already processed
  • total (t) -- total to process

Progress in processing of the package.

  • session_object_path (o) -- object path of the dnf5daemon session
  • total (t) -- total to process

Package files verification has finished.

  • session_object_path (o) -- object path of the dnf5daemon session
  • total (t) -- total to process

Preparation of transaction packages has started.

  • session_object_path (o) -- object path of the dnf5daemon session
  • processed (t) -- amount already processed
  • total (t) -- total to process

Progress in preparation of transaction packages.

  • session_object_path (o) -- object path of the dnf5daemon session
  • total (t) -- total to process

Preparation of transaction packages has finished.

  • session_object_path (o) -- object path of the dnf5daemon session
  • nevra (s) -- full NEVRA of the package

Error while unpacking the package.

  • success (b) -- true if the transfer finished successfully
  • transfer_id (s) -- id of the finished transfer
  • error_msg (s) -- error message if the transfer was not successful.

Notify the user that writing to the file descriptor with given transfer_id has finished and the descriptor has been closed.

•
options (a{sv}) -- an array of key/value pairs
•
groups (aa{sv}) -- array of returned groups with requested attributes

Get list of groups that match to given filters.

Following options and filters are supported:

•
list of group attributes that are returned
•
match patterns against ids of the groups
•
match patterns against names of the groups
•
limit groups to one of "all", "installed", "available"
•
include hidden groups into the result
•
any group matching to any of patterns is returned
•
include only groups containing given packages

Unknown options are ignored.

•
options (a{sv}) -- an array of key/value pairs
•
advisories (aa{sv}) -- array of returned advisories with requested attributes

Get list of security advisories that match to given filters.

Following options and filters are supported:

•
List of advisory attributes that are returned in advisories array. Supported attributes are "advisoryid", "name", "title", "type", "severity", "status", "vendor", "description", "buildtime", "message", "rights", "collections", and "references".
•
Limit returned advisories based on their relation to installed packages. Accepted values are
  • "available" to return only advisories containing newer versions of installed packages
  • "all" - to return all advisories
  • "installed" - to return only advisories containing equal or older versions of installed packages
  • "updates" - to return only advisories containing newer versions of installed packages for which an update is available
•
Consider only advisories with one of given names.
•
Consider only advisories of given types. Possible types are "security", "bugfix", "enhancement", and "newpackage".
•
Consider only advisories containing one of given packages.
•
Consider only advisories of given severity. Possible values are "critical", "important", "moderate", "low", and "none".
•
Consider only advisories referencing given Bugzilla ticket ID. Expected values are numeric IDs, e.g. 123456.
•
Consider only advisoried referencing given CVE ID. Expected values are strings IDs in CVE format, e.g. CVE-2201-0123.
•
Consider only advisories referencing a Bugzilla ticket.
•
Consider only advisories referencing a CVE ticket.

Unknown options are ignored.

See AUTHORS.md in dnf5 source distribution.

Contributors to the dnf5 project.

April 18, 2025