X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=src%2Flibsystemd-bus%2FDIFFERENCES;fp=src%2Flibsystemd-bus%2FDIFFERENCES;h=1c2bf99dd473ab3e757bf04d723261eae8db39e9;hb=bc25a2fb66ebf14589bb7ce5ecbd35301ee484ac;hp=0000000000000000000000000000000000000000;hpb=ea6ad56836bcbb09038eb1c0912e97dc8686b1d8;p=elogind.git

diff --git a/src/libsystemd-bus/DIFFERENCES b/src/libsystemd-bus/DIFFERENCES
new file mode 100644
index 000000000..1c2bf99dd
--- /dev/null
+++ b/src/libsystemd-bus/DIFFERENCES
@@ -0,0 +1,26 @@
+Known differences between dbus1 and kdbus:
+
+- NameAcquired/NameLost is gone entirely on kdbus backends if
+  libsystemd-bus is used. It is still added in by systemd-bus-proxyd
+  for old dbus1 clients, and it is available if libsystemd-bus is used
+  against the classic dbus1 daemon. If you want to write compatible
+  code with libsystem-bus you need to explicitly subscribe to
+  NameOwnerChanged signals and just ignore NameAcquired/NameLost
+
+- Applications have to deal with spurious signals they didn't expect,
+  due to the probabilistic bloom filters. They need to handle this
+  anyway, given that any client can send anything to arbitrary clients
+  anyway, even in dbus1, so not much changes.
+
+- clients of the system bus when kdbus is used must roll their own
+  security. Only legacy dbus1 clients get the old XML policy enforced,
+  which is implemented by systemd-bus-proxyd.
+
+- Serial numbers of synthesized messages are always (uint32_t) -1.
+
+- The org.freedesktop.DBus "driver" service is not special on
+  kdbus. It is a bus activated service like any other with its own
+  unique name.
+
+- NameOwnerChanged is a synthetic message, generated locally and not
+  by the driver.