DNF5DAEMON-DBUS-API(8) dnf5 DNF5DAEMON-DBUS-API(8) (NAME) dnf5daemon-dbus-api - D-Bus API dnf5daemon (SYNOPSIS) D-Bus. XML D-Bus. (DESCRIPTION) : () ( Goal.do_transaction() Repo.confirm_key() Repo.enable() Repo.disable()). CheckAuthorization() D-Bus org.freedesktop.PolicyKit1.Authority Polkit . () AllowUserInteraction . . (INTERFACES) org.rpm.dnf.v0.SessionManager interface org.rpm.dnf.v0.SessionManager method open_session(a{sv} options) -> (o session_object_path) (Arguments) o options (a{sv}) -- - / (Returns) o session_object_path (o) -- . : o load_system_repo: bool, default true true . o load_available_repos: bool, default true true . o config: map {string: string} . o releasever: string releasever . o locale: string (locale) . . . method close_session(o session_object_path) -> (b success) (Arguments) o session_object_path (o) -- (Returns) o success (b) -- . org.rpm.dnf.v0.Base interface org.rpm.dnf.v0.Base method read_all_repos() -> (b success) (Returns) o success (b) -- true false. . method clean_with_options(s cache_type, a{sv} options) -> (b success, s error_msg) (Arguments) o cache_type (s) -- . "all" "packages" "metadata" "dbcache" "expire-cache". o options (a{sv}) -- / (Returns) o success (b) -- true false. o error_msg (s) -- . . @options : o interactive: boolean, default true "true" . . method clean(s cache_type) -> (b success, s error_msg) (Arguments) o cache_type (s) -- . "all" "packages" "metadata" "dbcache" "expire-cache". (Returns) o success (b) -- true false. o error_msg (s) -- . . "clean_with_options()" . method reset() -> (b success, s error_msg) (Returns) o success (b) -- true false. o error_msg (s) -- . signal download_add_new(o session_object_path, s download_id, s description, x total_to_download) (Arguments) o session_object_path (o) -- dnf5daemon o download_id (s) -- ( ) o description (s) -- o total_to_download (x) -- . signal download_progress(o session_object_path, s download_id, x total_to_download, x downloaded) (Arguments) o session_object_path (o) -- dnf5daemon o download_id (s) -- ( ) o total_to_download (x) -- o downloaded (x) -- . signal download_mirror_failure(o session_object_path, s download_id, s message, s url, s metadata) (Arguments) o session_object_path (o) -- dnf5daemon o download_id (s) -- ( ) o message (s) -- o url (s) -- URL o metadata (s) -- (mirror) . signal download_end(o session_object_path, s download_id, u transfer_status, s message) (Arguments) o session_object_path (o) -- dnf5daemon o download_id (s) -- ( ) o transfer_status (u) -- libdnf5::repo::DownloadCallbacks::TransferStatus (: 0 - 1 - 2 - ) o message (s) -- . signal repo_key_import_request(o session_object_path, s key_id, as user_ids, s key_fingerprint, s key_url, x timestamp) (Arguments) o session_object_path (o) -- dnf5daemon o key_id (s) -- OpenPGP o user_ids (as) -- o key_fingerprint (s) -- OpenPGP o key_url (s) -- URL OpenPGP o timestamp (x) -- (import) . signal repo_key_imported(o session_object_path, s key_id, as user_ids, s key_fingerprint, s key_url, x timestamp) (Arguments) o session_object_path (o) -- dnf5daemon o key_id (s) -- OpenPGP o user_ids (as) -- o key_fingerprint (s) -- OpenPGP o key_url (s) -- URL OpenPGP o timestamp (x) -- . org.rpm.dnf.v0.rpm.Repo interface org.rpm.dnf.v0.rpm.Repo method list(a{sv} options) -> (aa{sv} repositories) (Arguments) o options (a{sv}) -- / (Returns) o repositories (aa{sv}) -- . : o patterns: list of strings o repo_attrs: list of strings o enable_disable: string (default "enabled") "enabled" "disabled" / . . o interactive: boolean, default false "true" . . method confirm_key_with_options(s key_id, b confirmed, a{sv} options) -> () (Arguments) o key_id (s) -- o confirmed (b) -- o options (a{sv}) -- / OpenPGP . @options : o interactive: boolean, default true "true" . . method confirm_key(s key_id, b confirmed) -> () (Arguments) o key_id (s) -- o confirmed (b) -- OpenPGP . "confirm_key_with_options()" . method enable_with_options(as repo_ids, a{sv} options) -> () (Arguments) o repo_ids (as) -- o options (a{sv}) -- / . @options : o interactive: boolean, default true "true" . . method enable(as repo_ids) -> () (Arguments) o repo_ids (as) -- . "enable_with_options()" . method disable_with_options(as repo_ids, a{sv} options) -> () (Arguments) o repo_ids (as) -- o options (a{sv}) -- / . @options : o interactive: boolean, default true "true" . . method disable(as repo_ids) -> () (Arguments) o repo_ids (as) -- . "disable_with_options()" . org.rpm.dnf.v0.rpm.Rpm interface org.rpm.dnf.v0.rpm.Rpm method list(a{sv} options) -> (aa{sv} packages) (Arguments) o options (a{sv}) -- / (Returns) o packages (aa{sv}) -- . D-Bus . / list_fd() . : o package_attrs: list of strings . : name, epoch, version, release, arch, repo_id, from_repo_id, is_installed, install_size, download_size, buildtime, install_time, sourcerpm, summary, url, license, description, files, changelogs, provides, requires, requires_pre, conflicts, obsoletes, recommends, suggests, enhances, supplements, evr, nevra, full_nevra, reason, vendor, group. o with_nevra: bool (default true) NEVRA o with_provides: bool (default true) (provides) o with_filenames: bool (default true) o with_binaries: bool (default true) /usr/(s)bin o with_src: bool (default true) rpm (source rpms) o icase: bool (default true) o interactive: boolean, default false "true" . o patterns: list of strings o scope: string (default "all") "all" "installed" "available" "upgrades" "upgradable" o arch: list of strings o repo: list of strings o latest-limit: int o whatprovides: list of strings o whatdepends: list of strings (requires) (enhances) (recommends) (suggests) (supplements) o whatrequires: list of strings o whatrecommends: list of strings o whatenhances: list of strings o whatsuggests: list of strings o whatsupplements: list of strings o whatobsoletes: list of strings o whatconflicts: list of strings . method list_fd(a{sv} options, h file_descriptor) -> (s transfer_id) (Arguments) o options (a{sv}) -- / o file_descriptor (h) -- (Returns) o transfer_id (s) -- . . . JSON JSON . (file_descriptor) . list() . (pipe) . list() . method install(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / @pkg_specs . @options : o repo_ids: list of strings . o skip_broken: boolean, default false . o skip_unavailable: boolean, default false . . method upgrade(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / @pkg_specs . @options : o repo_ids: list of strings . . method remove(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / @pkg_specs . . method distro_sync(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / distro_sync @options : . method downgrade(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / @pkg_specs . @options : . method reinstall(as pkg_specs, a{sv} options) -> () (Arguments) o pkg_specs (as) -- o options (a{sv}) -- / @pkg_specs . @options : . method system_upgrade(a{sv} options) -> () (Arguments) o options (a{sv}) -- / system_upgrade . ( offline do_transaction Goal ). releasever open_session() . @options : o mode: string (one of "distrosync", "upgrade", default is "distrosync") system_upgrade dnf distro-sync . "upgrade" ( dnf upgrade). o interactive: boolean, default true "true" . . signal transaction_elem_progress(o session_object_path, s nevra, t processed, t total) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o processed (t) -- o total (t) -- . . signal transaction_before_begin(o session_object_path, t total) (Arguments) o session_object_path (o) -- dnf5daemon o total (t) -- rpm rpm . signal transaction_after_complete(o session_object_path, b success) (Arguments) o session_object_path (o) -- dnf5daemon o success (b) -- true rpm rpm . signal transaction_action_start(o session_object_path, s nevra, u action, t total) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o action (u) -- dnfdaemon::RpmTransactionItem::Actions o total (t) -- / ( ) . signal transaction_action_progress(o session_object_path, s nevra, t processed, t total) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o processed (t) -- / o total (t) -- / . D-Bus . @processed . signal transaction_action_stop(o session_object_path, s nevra, t total) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o total (t) -- / . signal transaction_script_start(o session_object_path, s nevra, u scriptlet_type) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o scriptlet_type (u) -- (pre post ...) . signal transaction_script_stop(o session_object_path, s nevra, u scriptlet_type, t return_code) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o scriptlet_type (u) -- (pre post ...) o return_code (t) -- . signal transaction_script_error(o session_object_path, s nevra, u scriptlet_type, t return_code) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA o scriptlet_type (u) -- (pre post ...) o return_code (t) -- . signal transaction_verify_start(o session_object_path, t total) (Arguments) o session_object_path (o) -- dnf5daemon o total (t) -- . signal transaction_verify_progress(o session_object_path, t processed, t total) (Arguments) o session_object_path (o) -- dnf5daemon o processed (t) -- o total (t) -- . signal transaction_verify_stop(o session_object_path, t total) (Arguments) o session_object_path (o) -- dnf5daemon o total (t) -- . signal transaction_transaction_start(o session_object_path, t total) (Arguments) o session_object_path (o) -- dnf5daemon o total (t) -- . signal transaction_transaction_progress(o session_object_path, t processed, t total) (Arguments) o session_object_path (o) -- dnf5daemon o processed (t) -- o total (t) -- . signal transaction_transaction_stop(o session_object_path, t total) (Arguments) o session_object_path (o) -- dnf5daemon o total (t) -- . signal transaction_unpack_error(o session_object_path, s nevra) (Arguments) o session_object_path (o) -- dnf5daemon o nevra (s) -- NEVRA (unpack) . signal write_to_fd_finished(b success, s transfer_id, s error_msg) (Arguments) o success (b) -- true o transfer_id (s) -- o error_msg (s) -- . transfer_id . org.rpm.dnf.v0.Goal interface org.rpm.dnf.v0.Goal method resolve(a{sv} options) -> (a(sssa{sv}a{sv}) transaction_items, u result) (Arguments) o options (a{sv}) -- / (Returns) o transaction_items (a(sssa{sv}a{sv})) -- (object_type, action, reason, {transaction_item_attributes}, {object}). object_type libdnf5::transaction::TransactionItemType action libdnf5::transaction::TransactionItemAction reason libdnf5::transaction::TransactionItemReason . libdnf5::transaction::*_to_string() . transaction_item_attributes {attribute: value} . "reason_change_group_id" ReasonChange Group "replaces" . {attribute: value} ( object_type) . : "name" "epoch" "version" "release" "arch" "repo_id" "from_repo_id" "package_size" "install_size" "evr" "reason". "groupid" "name" . o result (u) -- . : 0 - 1 - / 2 - . . @options : o allow_erasing: boolean, default false . o interactive: boolean, default false "true" . . method get_transaction_problems_string() -> (as problems) (Returns) o problems (as) -- . . method get_transaction_problems() -> (aa{sv} problems) (Returns) o problems (aa{sv}) -- {key: value} . : : action - include/libdnf5/base/goal_elements.hpp: GoalAction problem - include/libdnf5/base/goal_elements.hpp: GoalProblem : goal_job_settings - {string: variant} (goal) spec - NEVRA additional_data - solver_problems - libsolv method do_transaction(a{sv} options) -> () (Arguments) o options (a{sv}) -- / . @options : o comment: string () . o offline: boolean, default false true . . o interactive: boolean, default true "true" . o downloadonly: boolean, default false, since 5.2.16 true RPM . offline . . method cancel() -> (b success, s error_msg) (Returns) o success (b) -- true o error_msg (s) -- do_transaction() . . RPM . method reset() -> () rpm . rpm . org.rpm.dnf.v0.Offline interface org.rpm.dnf.v0.Offline method get_status() -> (b pending, a{sv} transaction_status) (Returns) o pending (b) -- true o transaction_status (a{sv}) -- dnf5 dnf5 . method cancel_with_options(a{sv} options) -> (b success, s error_msg) (Arguments) o options (a{sv}) -- / (Returns) o success (b) -- dnf5 false . true . o error_msg (s) -- dnf5 . . @options : o interactive: boolean, default true "true" . . method cancel() -> (b success, s error_msg) (Returns) o success (b) -- dnf5 false . true . o error_msg (s) -- dnf5 . . "cancel_with_options()" . method clean_with_options() -> (b success, s error_msg) (Returns) o success (b) -- false . true . o error_msg (s) -- dnf5 . . @options : o interactive: boolean, default true "true" . . method clean(a{sv} options) -> (b success, s error_msg) (Arguments) o options (a{sv}) (Returns) o success (b) -- false . true . o error_msg (s) -- dnf5 . . "clean_with_options()" . method set_finish_action_with_options(s action, a{sv} options) -> (b success, s error_msg) (Arguments) o action (s) -- "poweroff" "reboot". "poweroff" . . o options (a{sv}) -- / (Returns) o success (b) -- true o error_msg (s) -- . action "poweroff" ( ). libdnf5 . @options : o interactive: boolean, default true "true" . . method set_finish_action(s action) -> (b success, s error_msg) (Arguments) o action (s) -- "poweroff" "reboot". "poweroff" . . (Returns) o success (b) -- true o error_msg (s) -- . action "poweroff" ( ). libdnf5 . "set_finish_action_with_options()" . method schedule_for_next_boot(a{sv} options) -> (b success, s error_msg) (Arguments) o options (a{sv}) -- / (Returns) o success (b) -- true o error_msg (s) -- . /system-update "ready" . . "download-complete" "ready" libdnf5 . @options : o interactive: boolean, default true "true" . . org.rpm.dnf.v0.comps.Group interface org.rpm.dnf.v0.comps.Group method list(a{sv} options) -> (aa{sv} groups) (Arguments) o options (a{sv}) -- / (Returns) o groups (aa{sv}) -- . : o attributes: list of strings o match_group_id: bool (default true) o match_group_name: bool (default false) o scope: string (default "all") "all" "installed" "available" o with_hidden: bool (default false) o patterns: list of strings o contains_pkgs: list of strings o lang: string (default current locale) translated_name translated_description o interactive: boolean, default false "true" . . org.rpm.dnf.v0.Advisory interface org.rpm.dnf.v0.Advisory method list(a{sv} options) -> (aa{sv} advisories) (Arguments) o options (a{sv}) -- / (Returns) o advisories (aa{sv}) -- . : o advisory_attrs: list of strings advisories . "advisoryid" "name" "title" "type" "severity" "status" "vendor" "description" "buildtime" "message" "rights" "collections" "references". o availability: string, default "available" . : o "available" o "all" - o "installed" - o "updates" - o names: list of strings . ( "FEDORA-2025-beb4c9a336" "RHSA-2024:1234"). . o types: list of strings . "security" "bugfix" "enhancement" "newpackage". o contains_pkgs: list of strings . ( "kernel" "bash" "buildah"). NEVRA name.arch . o severities: list of strings . "critical" "important" "moderate" "low" "none". o reference_bzs: list of strings Bugzilla . 123456. o reference_cves: list of strings CVE . CVE CVE-2201-0123. o with_bz: boolean, default False Bugzilla . o with_cve: boolean, default False CVE . o interactive: boolean, default false "true" . . org.rpm.dnf.v0.History interface org.rpm.dnf.v0.History method recent_changes(a{sv} options) -> (a{saa{sv}} changeset) (Arguments) o options (a{sv}) -- / (Returns) o changeset (a{saa{sv}}) -- {"":[,,...]} . . "type_of_change" : "installed" "removed" "upgraded" "downgraded". . . "original_evr" "original_arch" EVR . "advisories" ( ) . "all_advisories" . evr . "transaction_time" ( uint64 ) . : o upgraded_packages: boolean, default "true" . o downgraded_packages: boolean, default "true" . o installed_packages: boolean, default "true" . o removed_packages: boolean, default "true" . o include_advisory: boolean, default "true" "advisories" . o all_advisories: boolean, default "false" include_advisory=true . . o package_attrs: list of strings, default ["name", "summary", "evr", "arch"] . list() Rpm . o since: int64, unix timestamp . o interactive: boolean, default false "true" . . method list(a{sv} options) -> (aa{sv} transactions) (Arguments) o options (a{sv}) -- / (Returns) o transactions (aa{sv}) -- . . . "original_evr" EVR . : o limit: int64 . o since: int64, unix timestamp . o reverse: boolean, default "false" true . . o contains_pkgs: list of strings . o transaction_attrs: list of strings, default ["id", "start", "end", "user_id", "description", "status"] . : id, start, end, user_id, description, status, releasever, comment. o package_attrs: list of strings, default ["name", "arch", "evr"] . : name, epoch, version, release, arch, evr, repo_id, action, reason. o include_packages: boolean, default "true" ( ) . . (AUTHOR) AUTHORS.md dnf5 . (COPYRIGHT) dnf5. September 6, 2026 DNF5DAEMON-DBUS-API(8)