From bc25a2fb66ebf14589bb7ce5ecbd35301ee484ac Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Thu, 5 Dec 2013 03:16:15 +0100 Subject: bus: start maintaining a list of difference between kdbus/dbus1 --- Makefile.am | 4 +++- src/libsystemd-bus/DIFFERENCES | 26 ++++++++++++++++++++++++++ 2 files changed, 29 insertions(+), 1 deletion(-) create mode 100644 src/libsystemd-bus/DIFFERENCES diff --git a/Makefile.am b/Makefile.am index 194aaa8fbf..7bedd76f39 100644 --- a/Makefile.am +++ b/Makefile.am @@ -2027,7 +2027,9 @@ pkgconfiglib_DATA += \ src/libsystemd-bus/libsystemd-bus.pc EXTRA_DIST += \ - src/libsystemd-bus/libsystemd-bus.pc.in + src/libsystemd-bus/libsystemd-bus.pc.in \ + src/libsystemd-bus/DIFFERENCES \ + src/libsystemd-bus/GVARIANT-SERIALIZATION lib_LTLIBRARIES += \ libsystemd-bus.la diff --git a/src/libsystemd-bus/DIFFERENCES b/src/libsystemd-bus/DIFFERENCES new file mode 100644 index 0000000000..1c2bf99dd4 --- /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. -- cgit v1.2.3-54-g00ecf