1 D-Bus 1.6.2 (UNRELEASED)
4 D-Bus 1.6.0 (2012-06-05)
7 The “soul of this machine has improved” release.
9 This version starts a new stable branch of D-Bus: only bug fixes will
10 be accepted into 1.6.x. Other changes will now go to the 1.7.x branch.
12 Summary of changes since 1.4.x:
15 · PTHREAD_MUTEX_RECURSIVE on Unix
16 · compiler support for 64-bit integers (int64_t or equivalent)
18 • D-Bus Specification v0.19
20 • New dbus-daemon features
21 · <allow own_prefix="com.example.Service"/> rules allow the service to
22 own names like com.example.Service.Instance3
23 · optional systemd integration when checking at_console policies
24 · --nopidfile option, mainly for use by systemd
25 · path_namespace and arg0namespace may appear in match rules
26 · eavesdropping is disabled unless the match rule contains eavesdrop=true
29 · functions to validate various string types (dbus_validate_path() etc.)
30 · dbus_type_is_valid()
31 · DBusBasicValue, a union of every basic type
34 · removed an unsafe reimplementation of recursive mutexes
35 · dbus-daemon no longer busy-loops if it has far too many file descriptors
36 · dbus-daemon.exe --print-address works on Windows
37 · all the other bug fixes from 1.4.20
39 • Other major implementation changes
40 · on Linux, dbus-daemon uses epoll if supported, for better scalability
41 · dbus_threads_init() ignores its argument and behaves like
42 dbus_threads_init_default() instead
43 · removed the per-connection link cache, improving dbus-daemon performance
46 · optional Valgrind instrumentation (--with-valgrind)
47 · optional Stats interface on the dbus-daemon (--enable-stats)
48 · optionally abort whenever malloc() fails (--enable-embedded-tests
49 and export DBUS_MALLOC_CANNOT_FAIL=1)
53 • Be more careful about monotonic time vs. real time, fixing DBUS_COOKIE_SHA1
54 spec-compliance (fd.o #48580, David Zeuthen)
56 • Don't use install(1) within the source/build trees, fixing the build as
57 non-root when using OpenBSD install(1) (fd.o #48217, Antoine Jacoutot)
59 • Add missing commas in some tcp and nonce-tcp addresses, and remove
60 an unused duplicate copy of the nonce-tcp transport in Windows builds
61 (fd.o #45896, Simon McVittie)
63 D-Bus 1.5.12 (2012-03-27)
66 The “Big Book of Science” release.
68 • Add public API to validate various string types:
69 dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
70 dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
71 (fd.o #39549, Simon McVittie)
73 • Turn DBusBasicValue into public API so bindings don't need to invent their
74 own "union of everything" type (fd.o #11191, Simon McVittie)
76 • Enumerate data files included in the build rather than using find(1)
77 (fd.o #33840, Simon McVittie)
79 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
80 in dbus-daemon (fd.o #46273, Alban Crequy)
83 · make dbus-daemon.exe --print-address (and --print-pid) work again
84 on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
85 · fix duplicate case value when compiling against mingw-w64
86 (fd.o #47321, Andoni Morales Alastruey)
88 D-Bus 1.5.10 (2012-02-21)
91 The "fire in Delerium" release.
93 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
94 and SUSv2) is now required.
96 • D-Bus Specification 0.19:
97 · Formally define unique connection names and well-known bus names,
98 and document best practices for interface, bus, member and error names,
99 and object paths (fd.o #37095, Simon McVittie)
100 · Document the search path for session and system services on Unix, and
101 where they should be installed by build systems (fd.o #21620, fd.o #35306;
103 · Document the systemd transport (fd.o #35232, Lennart Poettering)
105 • Make dbus_threads_init() use the same built-in threading implementation
106 as dbus_threads_init_default(); the user-specified primitives that it
107 takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
109 • Allow all configured auth mechanisms, not just one (fd.o #45106,
112 • Improve cmake build system (Ralf Habacker):
113 · simplify XML parser dependencies (fd.o #41027)
114 · generate build timestamp (fd.o #41029)
115 · only create batch files on Windows
116 · fix option and cache syntax
117 · add help-options target
118 · share dbus-arch-deps.h.in with autotools rather than having our
119 own version (fd.o #41033)
121 • Build tests successfully with older GLib, as found in e.g. Debian 6
122 (fd.o #41219, Simon McVittie)
124 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
126 • Build documentation correctly if man2html doesn't support filenames on
127 its command-line (fd.o #43875, Jack Nagel)
129 • Improve test coverage. To get even more coverage, run the tests with
130 DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
132 • Reduce the size of the shared library by moving functionality only used
133 by dbus-daemon, tests etc. into their internal library and deleting
134 unused code (fd.o #34976, #39759; Simon McVittie)
136 • Add dbus-daemon --nopidfile option, overriding the configuration, for
137 setups where the default configuration must include <pidfile/> to avoid
138 breaking traditional init, but the pid file is in fact unnecessary; use
139 it under systemd to improve startup time a bit (fd.o #45520,
142 • Optionally (if configured --with-valgrind) add instrumentation to debug
143 libdbus and associated tools more meaningfully under Valgrind
144 (fd.o #37286, Simon McVittie)
146 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
148 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
150 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
151 abort on failure to malloc() (like GLib does), to turn runaway memory leaks
152 into a debuggable core-dump if a resource limit is applied (fd.o #41048,
155 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
159 · Replace our broken reimplementation of recursive mutexes, which has
160 been broken since 2006, with an ordinary pthreads recursive mutex
161 (fd.o #43744; Sigmund Augdal, Simon McVittie)
162 · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
163 welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
164 event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
165 · When running under systemd, use it instead of ConsoleKit to check
166 whether to apply at_console policies (fd.o #39609, Lennart Poettering)
167 · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
168 · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
169 · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
170 (fd.o #41218, Simon McVittie)
171 · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
172 helper doesn't obey environment variables to avoid privilege escalation
173 attacks, so make the system bus follow the same rules
174 (fd.o #21620, Simon McVittie)
177 · Find the dbus-daemon executable next to the shared library (fd.o #41558;
178 Jesper Dam, Ralf Habacker)
179 · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
182 D-Bus 1.5.8 (2011-09-21)
185 The "cross-metering" release.
187 In addition to dead code removal and refactoring, this release contains all
188 of the bugfixes from 1.4.16.
190 • Clean up dead code, and make more warnings fatal in development builds
191 (fd.o #39231, fd.o #41012; Simon McVittie)
193 • If full test coverage is requested via --enable-tests, strictly require
194 Python, pygobject and dbus-python, which are required by some tests; if not,
195 and Python is missing, skip those tests rather than failing
196 (fd.o #37847, Simon McVittie)
198 • When using cmake, provide the same version-info API in the installed headers
199 as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
201 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
203 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
205 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
208 • Fix duplicates in authors list (Ralf Habacker)
210 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
211 (fd.o #39879, Chris Mayo)
213 • Fix a small memory leak, and a failure to report errors, when updating
214 a service file entry for activation (fd.o #39230, Simon McVittie)
217 · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
218 Brian Cameron, Simon McVittie)
219 · On systems that use libcap-ng but not systemd, drop supplemental groups
220 when switching to the daemon user (Red Hat #726953, Steve Grubb)
221 · Make the cmake build work again on GNU platforms (fd.o #29228,
223 · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
224 like Solaris (fd.o #40313, Dagobert Michelsen)
225 · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
226 (fd.o #40235, Simon McVittie)
227 · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
228 (fd.o #39987, Simon McVittie)
229 · Cope with platforms whose vsnprintf violates both POSIX and C99, like
230 Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
233 · Fix compilation on MSVC, which doesn't understand "inline" with its
234 C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
235 · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
236 · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
238 D-Bus 1.5.6 (2011-07-29)
241 The "weird, gravy-like aftertaste" release.
243 In addition to new features and refactoring, this release contains all of the
244 bugfixes from 1.4.14.
246 Potentially incompatible (Bustle and similar debugging tools will need
247 changes to work as intended):
249 • Do not allow match rules to "eavesdrop" (receive messages intended for a
250 different recipient) by mistake: eavesdroppers must now opt-in to this
251 behaviour by putting "eavesdrop='true'" in the match rule, which will
252 not have any practical effect on buses where eavesdropping is not allowed
253 (fd.o #37890, Cosimo Alfarano)
257 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
258 Cosimo Alfarano, Simon McVittie)
259 · add the "eavesdrop" keyword to match rules
260 · define eavesdropping, unicast messages and broadcast messages
261 · stop claiming that match rules are needed to match unicast messages to you
262 · promote the type system to be a top-level section
264 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
265 or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
266 and simplify object-path registration (fd.o #38874, Jiří Klimeš)
268 • Consistently use atomic operations on everything that is ever manipulated
269 via atomic ops, as was done for changes to DBusConnection's refcount in
270 1.4.12 (fd.o #38005, Simon McVittie)
272 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
275 • Make "make check" in a clean tree work, by not running tests until
276 test data has been set up (fd.o #34405, Simon McVittie)
278 • The dbus-daemon no longer busy-loops if it has a very large number of file
279 descriptors (fd.o #23194, Simon McVittie)
281 • Refactor message flow through dispatching to avoid locking violations if
282 the bus daemon's message limit is hit; remove the per-connection link cache,
283 which was meant to improve performance, but now reduces it (fd.o #34393,
286 • Some cmake fixes (Ralf Habacker)
288 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
289 Simon McVittie, Lennart Poettering)
291 • Stop storing two extra byte order indicators in each D-Bus message
292 (fd.o #38287, Simon McVittie)
294 • Add an optional Stats interface which can be used to get statistics from
295 a running dbus-daemon if enabled at configure time with --enable-stats
296 (fd.o #34040, Simon McVittie)
298 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
300 • Documentation (fd.o #36156, Simon McVittie):
301 · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
302 · install more documentation automatically, including man2html output
303 · put dbus.devhelp in the right place (it must go in ${htmldir})
306 · look for system services in /lib/dbus-1/system-services in addition to all
307 the other well-known locations; note that this should always be /lib,
308 even on platforms where shared libraries on the root FS would go in /lib64,
309 /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
310 · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
312 • Windows-specific (Ralf Habacker):
313 · fix use of a mutex for autolaunch server detection
314 · don't crash on malloc failure in _dbus_printf_string_upper_bound
316 D-Bus 1.5.4 (2011-06-10)
319 Security (local denial of service):
321 • Byte-swap foreign-endian messages correctly, preventing a long-standing
322 local DoS if foreign-endian messages are relayed through the dbus-daemon
323 (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
324 (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
328 • The constant to use for an infinite timeout now has a name,
329 DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
330 which can be used for source compatibility with older versions of libdbus.
332 • If GLib and DBus-GLib are already installed, more tests will be built,
333 providing better coverage. The new tests can also be installed via
334 ./configure --enable-installed-tests
335 for system integration testing, if required. (fd.o #34570, Simon McVittie)
339 • Consistently use atomic operations for the DBusConnection's refcount,
340 fixing potential threading problems (fd.o #38005, Simon McVittie)
342 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
343 small (300KiB on x86-64) and it frequently doesn't work in unusual
344 toolchains. To optimize for minimum installed size, you should benchmark
345 various possibilities for CFLAGS and LDFLAGS, and set the best flags for
346 your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
348 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
349 (fd.o #35880, Timothy Redaelli)
351 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
352 when not using a DESTDIR (fd.o #37870, Simon McVittie)
354 • Windows-specific changes:
355 · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
357 D-Bus 1.5.2 (2011-06-01)
360 The "Boar Hunter" release.
362 Notes for distributors:
364 This version of D-Bus no longer uses -fPIE by default. Distributions wishing
365 to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
366 toolchain supports it reliably, via something like:
368 ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
370 or by using distribution-specific wrappers such as Debian's hardening-wrapper.
374 • D-Bus Specification v0.17
375 · Reserve the extra characters used in signatures by GVariant
376 (fd.o #34529, Simon McVittie)
377 · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
378 • Don't force -fPIE: distributions and libtool know better than we do whether
379 it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
380 • Allow --disable-gc-sections, in case your toolchain offers the
381 -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
382 but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
383 • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
384 (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
385 • Ensure that maintainers upload documentation with the right permissions
386 (fd.o #36130, Simon McVittie)
387 • Don't force users of libdbus to be linked against -lpthread, -lrt
388 (fd.o #32827, Simon McVittie)
389 • Log system-bus activation information to syslog (fd.o #35705,
391 • Log messages dropped due to quotas to syslog (fd.o #35358,
393 • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
394 • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
395 (fd.o #35228, Lennart Poettering)
396 • In the regression tests, don't report fds as "leaked" if they were open
397 on startup (fd.o #35173, Simon McVittie)
398 • Make dbus-monitor bail out if asked to monitor more than one bus,
399 rather than silently using the last one (fd.o #26548, Will Thompson)
400 • Clarify documentation (fd.o #35182, Simon McVittie)
401 • Clean up minor dead code and some incorrect error handling
402 (fd.o #33128, fd.o #29881; Simon McVittie)
403 • Check that compiler options are supported before using them (fd.o #19681,
406 • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
408 D-Bus 1.5.0 (2011-04-11)
411 The "you never know when you need to tow something from your giant
412 flying shark" release.
414 • D-Bus Specification v0.16
415 · Add support for path_namespace and arg0namespace in match rules
416 (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
417 · Make argNpath support object paths, not just object-path-like strings,
418 and document it better (fd.o #31818, Will Thompson)
419 • Let the bus daemon implement more than one interface (fd.o #33757,
421 • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
423 • Require user intervention to compile with missing 64-bit support
424 (fd.o #35114, Simon McVittie)
425 • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
426 • Raise UnknownObject instead of UnknownMethod for calls to methods on
427 paths that are not part of the object tree, and UnknownInterface for calls
428 to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
430 D-Bus 1.4.8 (2011-04-08)
433 The "It's like the beginning of a lobster" release.
435 • Rename configure.in to configure.ac, and update it to modern conventions
436 (fd.o #32245; Javier Jardón, Simon McVittie)
437 • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
439 • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
440 --disable-x11-autolaunch configure option to prevent it altogether
441 in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
442 • Install the documentation, and an index for Devhelp (fd.o #13495,
443 Debian #454142; Simon McVittie, Matthias Clasen)
444 • If checks are not disabled, check validity of string-like types and
445 booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
446 • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
447 errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
448 • Break up a huge conditional in config-parser so gcov can produce coverage
449 data (fd.o #10887, Simon McVittie)
450 • List which parts of the Desktop Entry specification are applicable to
451 .service files (fd.o #19159, Sven Herzberg)
452 • Don't suppress service activation if two services have the same Exec=
453 (fd.o #35750, Colin Walters)
455 · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
457 · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
458 (fd.o #32805, Mark Brand)
460 D-Bus 1.4.6 (2010-02-17)
463 The "1, 2, miss a few, 99, 100" release.
465 • Remove unfinished changes intended to support GTest-based tests,
466 which were mistakenly included in 1.4.4
468 D-Bus 1.4.4 (2010-02-17)
471 • Switch back to using even micro versions for stable releases; 1.4.1
472 should have been called 1.4.2, so skip that version number
473 • Don't leave bad file descriptors being watched when spawning processes,
474 which could result in a busy-loop (fd.o #32992, NB#200248; possibly
475 also LP#656134, LP#680444, LP#713157)
476 • Check for MSG_NOSIGNAL correctly
477 • Fix failure to detect abstract socket support (fd.o #29895)
478 • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
479 (fd.o #32262, NB#180486)
480 • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
481 fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
482 • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
483 • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
484 • Improve gcc malloc annotations (fd.o #32710)
485 • If the system bus is launched via systemd, protect it from the OOM killer
486 • Documentation improvements (fd.o #11190)
487 • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
488 fd.o #15922, LP#241619)
489 • Cope with invalid files in session.d, system.d (fd.o #19186,
491 • Don't distribute generated files that embed our builddir (fd.o #30285,
493 • Raise the system bus's fd limit to be sufficient for its configuration
494 (fd.o #33474, LP#381063)
495 • Fix syslog string processing
497 • Remove broken gcov parsing code and --enable-gcov, and replace them
498 with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
500 · avoid live-lock in Windows CE due to unfair condition variables
502 · support credentials-passing (fd.o #32542)
504 · opt-in to thread safety (fd.o #33464)
506 D-Bus 1.4.1 (20 December 2010)
509 • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
510 crash the bus. The existing restriction to 64-levels of nesting previously
511 only applied to the static type signature; now it also applies to dynamic
512 nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
514 • OS X portability fixes, including launchd support.
515 • Windows autolaunch improvements.
518 D-Bus 1.4.0 (6 Sep 2010)
522 D-Bus 1.3.1 (23 June 2010)
524 - New standardized PropertiesChanged signal in the properties interface
525 - Various portability fixes, in particular to Windows platforms
526 - Support forking bus services, for compatibility
528 D-Bus 1.3.0 (29 July 2009)
530 - ability for dbus-send to send to any bus (--address)
531 - file descriptor passing on Unix socket transports
532 - use of GCC atomic intrinsics for better processor support
533 (requires -march=i486 or above for x86 compilation)
534 - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
535 and glibc (2.9 for pipe2 and 2.10 for accept4)
536 - feature negotiation in the bus daemon