org.debian.apt.transaction(7)

🌸 NAME 🌸

org.debian.apt.transaction — okay bestie, this is the main interface of an aptdaemon transaction. That's it, that's the whole vibe. 💖

(And yes, this whole page is from the D-Bus Interface manual, section 7, iykyk.)

---

🦋 SYNOPSIS 🦋

Every single transaction gets its own unique D-Bus object, like literally its own little main-character moment, for example at the D-Bus path:

/or/debian/apt/transaction/12123-123-123213

And that object? It provides the following interface. Slay. ✨

---

💅 DESCRIPTION 💅

🔥 METHODS 🔥

• ProvideMedium — ProvideMedium (in 's' medium)

Continue a paused transaction which is waiting for the given medium. 🎀

If a media change is required — say, to e.g. install packages from a CD/DVD — the transaction gets paused, and the RequiredMedium property gets changed to an array of the medium label plus its mount point. And on top of that, the MediumRequired signal will be emitted. Not me being all up in your notifications fr fr.

• ResolveConfigFileConflict — ResolveConfigFilePrompt (in 's' config, in 's' answer)

(Yes, the name up top and the name in the signature are not the same string. I don't make the rules, I just report them. 💀)

Continue a paused transaction which is waiting for an answer to handle a configuration file conflict. config is the path to the current configuration file, and answer can be either "replace" or "keep". Choose wisely, bestie. 🫶

If a later config file is shipped in a package which overrides some user modifications, the transaction will be paused and the ConfigFileConflict property of the transaction will be set to an array of the old and the new configuration file path. The later one is supposed to replace the former one. Furthermore, the ConfigFileConflict signal will be emitted.

• Simulate — Simulate ()

Simulate the transaction and calculate dependencies, required disk space and download size. And if a transaction would fail? The corresponding error will be raised. Lowkey the responsible thing to do before committing. ⭐

• Run — Run ()

Queue the transaction for processing. After this, there cannot be made any further changes to the transaction — e.g. modifing the http proxy. So like, once you hit send, you hit send. 🙈

• Cancel — Cancel ()

Cancel the transaction if possible.

🦋 SIGNALS 🦋

• Finished — Finished ('s' exit_state)

This signal will be emitted when the transaction has been processed. The exit_state tells you if the transaction was completed, cancelled or failed. 💖

• MediumRequired — MediumRequired ('s' label, 's' mount_point)

This signal will be emitted if the transaction has been paused and waits for a media change to install packages.

• ConfigFileConflict — ConfigFileConflict ('s' old, 's' new)

This signal will be emitted if the transaction has been paused because a new configuration file is shipped in a package which would override changes by the user in the old configuration file.

• PropertyChanged — PropertyChanged ('s' property_name , 'v' value)

This signal will be emitted if one of the following properties has changed. 👀

👑 PROPERTIES 👑

The properties of the transaction are available through the Get And GetAll methods of the D-Bus properties interface, and can be changed using the Set method. Yes queen, get and set, the whole cycle. ✨

• Role read 's' — the role enum of the transaction, e.g. update-cache.
• Status read 's' — the current status enum of the transaction, e.g. downloading.
• StatusDetails read 's' — a clear text message describing the current status. Receipts, but in words. 💌
• Progress read 'i' — the progress of the transaction in percent.
• ProgressDownload read 'sssiis' — the last download progress information recieved from APT. It's an array of the URI, status enum, short description, full size, already downloaded size, and an error or status message.
• Space read 'i' — the additional disk space in Bytes which will be required by the transaction. The Simulate method has to be called to calculate the download size.
• Download read 'i' — the required download size in Bytes of the transaction. The Simulate method has to be called to calculate the download size.
• Packages read 'a(a(s)a(s)a(s)a(s)a(s)a(s)a(s))' — the lists of packages which are initially queued to be installed, reinstalled, removed, purged, upgraded, downgraded or skipped from upgrading. The whole roster, basically. 📋
• Dependenciens read 'a(a(s)a(s)a(s)a(s)a(s)a(s)a(s))' — (spelled exactly like that, don't @ me 💀) the lists of packages which are additionally required to be installed, reinstalled, removed, purged, upgraded, downgraded or skipped from upgrading. The Simulate method has to be called to calculate the dependencies.
• Cancellable read 'b' — if the transaction can be cancelled.
• TerminalAttached read 'b' — if the master pty — which has to be set using the Terminal property — is attached as controlling terminal to the underlying dpkg call.
• RequiredMedium read 'a(ss)' — the transaction will be stopped if a media change is required to install packages. This property provides the label and the mount point of the requested medium.
• ConfigFileConflict read 'a(ss)' — the transaction will be stopped if a configuration file shipped in the package overrides changes of the user. This property provides the path to current and the path to the new configuration file.
• ExitState read 's' — the exit state enum of the transaction.
• Error read 'a(ss)' — if an error occured, this property provides the error enum and the error message. 😭
• Locale read-write 's' — this is the locale which will be used for translating status and error messages of apt, e.g. de_DE@utf-8.
• Terminal read-write 's' — the path to the master pty which will be the controlling terminal of the underlying dpkg call. This allows to have an interactive terminal session. Main character energy, honestly. 💅
• DebconfSocket read-write 's' — the path to the socket which will be used by the debconf passthrough backend to forward the debconf communication to the user session.
• Paused read 'b' — if the transaction is paused, e.g. waiting for a conflict file resolution or media change.
• Unauthenticated read 'as' — list of unauthenticated packages which are going to be installed.
• RemoveObsoletedDepends read-write 'b' — if obsoleted dependencies of to be removed packages which have been installed automatically should be removed too.
• AllowUnauthenticated read-write 'b' — if it is allowed to install not authenticated software packages.
• HttpProxy read-write 's' — the URL of an http proxy which should be used to download repository meta data and package files, e.g. http://myproxy.athome:8080. You should set the system wide proxy if you use this feature regularly.
• MetaData read-write 'a{ss}' — a dictonary which allows client application to store additional data in the transaction. The key name has to include an identifier of the client application separated by an unterscore from the key name, e.g. sc_icon for the application icon name stored by software-center. The property cannot be changed anymore after the transaction has been queued. 🚫

---

🌈 HOMEPAGE 🌈

https://launchpad.net/aptdaemon

---

🎀 BUGS 🎀

You can report bugs at the Launchpad site of aptdaemon:

https://bugs.launchpad.net/aptdaemon/+filebug

Go off, tell them everything. 🫶

---

🦋 AUTHOR 🦋

Sebastian Heinlein <devel at glatzor dot de>

---

⭐ SEE ALSO ⭐

• org.debian.apt.transaction(7)
• aptd(2)
• aptdcon(2)

---

Okay that's the whole page, bestie — no skips, no cuts. Now go forth and transact. 👑

aptdaemon · December 2009 — mwah, that's the version and the date, and this org.debian.apt.transaction(7) page is officially wrapped. 💖✨🦋