Merge branch 'dbus-1.10'
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.11.16 (UNRELEASED)
2 ==
3
4 Build-time configuration changes:
5
6 • The Autotools build system now supports varying ${runstatedir}
7   independently of ${localstatedir}, if using an Autoconf version
8   that has that feature; version 2.70 will eventually have this, but
9   many Linux distributions add it to version 2.69 as a patch.
10   A typical use is to set prefix=/usr, sysconfdir=/etc, localstatedir=/var
11   and runstatedir=/run. (fd.o #101569, Simon McVittie)
12
13 Enhancements:
14
15 • New APIs DBUS_MESSAGE_ITER_INIT_CLOSED, dbus_message_iter_init_closed()
16   and dbus_message_iter_abandon_container_if_open() simplify the
17   single-exit-point ("goto out") style of resource cleanup. The API
18   documentation around DBusMessageIter and containers has also been
19   clarified. (fd.o #101568, Simon McVittie)
20
21 Fixes:
22
23 • Make the dbus-daemon's Properties interface, as introduced in 1.11.14,
24   available to all users on the system bus (fd.o #101700, Simon McVittie)
25
26 • dbus_message_iter_append_basic() no longer leaks memory if it fails to
27   append a file descriptor to a message. (fd.o #101568, Simon McVittie)
28
29 • dbus_message_iter_open_container() no longer leaks memory if it runs out
30   of memory. (fd.o #101568, Simon McVittie)
31
32 • dbus_message_append_args_valist() no longer leaks memory if given an
33   unsupported type. This situation is still considered to be a programming
34   error which needs to be corrected by the user of libdbus.
35   (fd.o #101568, Simon McVittie)
36
37 • dbus_message_iter_append_basic() and dbus_message_iter_open_container()
38   will no longer report that their arguments were invalid if they run out
39   of memory at exactly the wrong time. (fd.o #101568, Simon McVittie)
40
41 • Ensure that tests fail if they would otherwise have tried to connect to
42   the real session bus (fd.o #101698, Simon McVittie)
43
44 • Make build-time tests cope with finding Python 3, but not Python 2
45   (fd.o #101716, Simon McVittie)
46
47 Internal changes relevant to dbus developers:
48
49 • DBusVariant is a new mechanism to copy single values from a message into
50   a buffer without copying the entire message (fd.o #101568, Simon McVittie)
51
52 • DBUS_SYSTEM_LOG_FATAL has been replaced by DBUS_SYSTEM_LOG_ERROR.
53   Logging an ERROR message does not make the process exit; the caller
54   is responsible for calling abort() or exit(), whichever is more appropriate.
55   (fd.o #101568, Simon McVittie)
56
57 • Better test coverage (fd.o #101568, Simon McVittie)
58
59 D-Bus 1.11.14 (2017-06-29)
60 ==
61
62 The “irrational fear of bees” release.
63
64 Dependencies:
65
66 • Expat >= 2.1.0 is always required
67 • libselinux >= 2.0.86 is required if SELinux support is enabled
68 • GLib >= 2.40 is required if full test coverage is enabled
69
70 Build-time configuration changes:
71
72 • We now use pkg-config to find libexpat in Autotools builds. This requires
73   Expat 2.1.0 (March 2012) or later. In particular, this should remove the
74   need to configure with LDFLAGS=-L/usr/local/lib on OpenBSD, which can
75   itself cause compilation failures.
76
77   As with all pkg-config-based configure checks, you can use
78   PKG_CONFIG_PATH=/whatever/lib/pkgconfig to find expat.pc in a
79   non-standard prefix, or EXPAT_CFLAGS="-I/whatever/include" and
80   EXPAT_LIBS="-L/whatever/lib -lexpat" to avoid needing a .pc file
81   at all.
82
83   (fd.o #69801, Simon McVittie)
84
85 • Similarly, we now use pkg-config to find libselinux. Version 2.0.86
86   is required due to the removal of explicit refcounting for SIDs.
87   (fd.o #100912, Laurent Bigonville)
88
89 Behaviour changes:
90
91 • Previously, /etc/machine-id could be copied to /var/lib/dbus/machine-id
92   as a side-effect of a sufficiently privileged process merely reading the
93   machine ID. It is no longer copied as a side-effect of reading.
94   Running dbus-uuidgen --ensure, which should be done after installing dbus,
95   continues to copy /etc/machine-id to /var/lib/dbus/machine-id if the
96   former exists and the latter does not.
97   (fd.o #101257, Simon McVittie)
98
99 • The undocumented Verbose interface, and the GetAllMatchRules method on
100   the undocumented Stats interface, must now be used via the object path
101   /org/freedesktop/DBus. Previously, they existed on all object paths.
102   (fd.o #101257, Simon McVittie)
103
104 • AddMatch() with a match rule containing eavesdrop='true' will now fail
105   unless called by either the same user as the dbus-daemon, or Unix uid 0
106   (root), matching the restrictions applied to the newer BecomeMonitor()
107   method. On the session bus this has no practical effect. On the system
108   bus this will prevent certain configurations that already did not
109   work well in practice. (fd.o #101567, Simon McVittie)
110
111 Enhancements:
112
113 • D-Bus Specification version 0.31
114   · Don't require implementation-specific search paths to be lowest
115     priority
116   · Correct regex syntax for optionally-escaped bytes in addresses so it
117     includes hyphen-minus, forward slash and underscore as intended
118   · Describe all message bus methods in the same section
119   · Clarify the correct object path for method calls to the message bus
120     (/org/freedesktop/DBus, DBUS_PATH_DBUS in the reference implementation)
121   · Document that the message bus implements Introspectable, Peer and
122     Properties
123   · Add new Features and Interfaces properties for message bus
124     feature-discovery
125   · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
126     abstract sockets
127   · Don't require eavesdrop='true' to be accepted from connections not
128     sufficiently privileged to use it successfully
129   · Formally deprecate eavesdropping in favour of BecomeMonitor
130   (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
131   Simon McVittie, Tom Gundersen)
132
133 • Implement the Properties and Peer interfaces in dbus-daemon
134   (fd.o #101257, Simon McVittie)
135
136 • New function dbus_try_get_local_machine_id() is like
137   dbus_get_local_machine_id(), but returning a DBusError. Other code
138   that needs the machine ID will now report a recoverable error (instead
139   of logging to stderr and aborting) if no machine ID is available.
140   Generating a machine ID is still considered to be a required part of
141   installing dbus correctly. (fd.o #13194, Simon McVittie)
142
143 • Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
144   (fd.o #101315, Laurent Bigonville)
145
146 • Avoid deprecated API calls when using SELinux
147   (fd.o #100912, Laurent Bigonville)
148
149 • Switch a test from the deprecated g_test_trap_fork() to
150   g_test_trap_subprocess(), for Windows support and better robustness
151   on Unix (fd.o #101362, Simon McVittie)
152
153 • On systemd systems, if ${localstatedir}/dbus/machine-id doesn't exist,
154   instruct systemd-tmpfiles to make it a symbolic link to /etc/machine-id.
155   This prevents the two files from going out of sync on stateless or live
156   images without needing to run dbus-uuidgen, and supports older D-Bus
157   implementations that do not necessarily read /etc/machine-id themselves.
158   (fd.o #101570, Simon McVittie)
159
160 • Implement unix:dir=..., which resembles unix:tmpdir=... but never uses
161   abstract sockets. This is preferable when used with Linux containers.
162   (fd.o #101567, Simon McVittie)
163
164 Fixes:
165
166 • Fix a reference leak when blocking on a pending call on a connection
167   that has been disconnected (fd.o #101481, Shin-ichi MORITA)
168
169 • Don't put timestamps in the Doxygen-generated documentation,
170   or hard-code the build directory into builds with embedded tests,
171   for reproducible builds (fd.o #100692, Simon McVittie)
172
173 • Fix some integration test issues (fd.o #100686, Simon McVittie)
174
175 • Fix memory leaks in the tests (fd.o #101257, Simon McVittie)
176
177 • If we somehow get an autolaunch address with multiple semicolon-separated
178   components, and they don't work, don't invalidly "pile up" errors
179   (fd.o #101257, Simon McVittie)
180
181 Documentation:
182
183 • Update git URIs in HACKING document to sync up with cgit.freedesktop.org
184   (fd.o #100715, Simon McVittie)
185
186 D-Bus 1.11.12 (2017-04-07)
187 ==
188
189 The “it's something humans do” release.
190
191 Enhancements:
192
193 • The session dbus-daemon now supports transient .service files
194   in $XDG_RUNTIME_DIR/dbus-1/services. Unlike the other standard
195   service directories, this directory is not monitored with inotify
196   or similar, and the service files must be named exactly
197   ${bus_name}.service. (fd.o #99825, Simon McVittie)
198
199 • dbus can be configured with --enable-relocation when building with
200   Autotools, or with -DDBUS_RELOCATABLE=ON when building with cmake,
201   to make the pkg-config metadata relocatable. This is useful for
202   non-standard prefixes, and in particular for Windows installations.
203   However, it is not recommended for system-wide installations into
204   /usr, because it interferes with pkg-config's ability to filter out
205   compiler default linker directories.
206
207   With Autotools, the default is --enable-relocation when building
208   for Windows or --disable-relocation otherwise. With CMake, the default
209   is -DDBUS_RELOCATABLE=ON.
210
211   (fd.o #99721; Ralf Habacker, Simon McVittie)
212
213 • Users of CMake ≥ 2.6 can now link to libdbus without providing their
214   own FindDBus.cmake macros, whether dbus was compiled with Autotools
215   or with CMake. See the end of README.cmake for more information.
216   (fd.o #99721; Ralf Habacker, Simon McVittie)
217
218 Fixes:
219
220 • Always read service file directories in the intended order
221   (fd.o #99825, Simon McVittie)
222
223 • When tests are skipped, don't try to kill nonexistent process 0
224   (fd.o #99825, Simon McVittie)
225
226 • Avoid valgrind false positives (fd.o #88808, Philip Withnall)
227
228 • Fix a harmless read overflow and some memory leaks in a unit test
229   (fd.o #100568, Philip Withnall)
230
231 • Fix some typos in test code
232   (fd.o #99999, Coverity #141876, #141877; Philip Withnall)
233
234 • Clarify the roles of /etc/dbus-1/s*.d and /usr/share/dbus-1/s*.d
235   in documentation (fd.o #99901, Philip Withnall)
236
237 • Fix and enable compiler warnings related to -Wswitch
238   (fd.o #98191; Thomas Zimmermann, Simon McVittie)
239
240 • Fix writing off the end of a fd_set when testing with valgrind
241   (fd.o #99839, Philip Withnall)
242
243 D-Bus 1.11.10 (2017-02-16)
244 ==
245
246 The “purple hair gives you telekinesis?” release.
247
248 Dependencies:
249
250 • AppArmor support requires at least libapparmor 2.8.95, reduced
251   from 2.10 in previous versions. One test requires 2.10 and is
252   skipped if building with an older version.
253
254 Enhancements:
255
256 • Do the Travis-CI build in Docker containers for Ubuntu LTS, Debian
257   stable and Debian testing in addition to the older Ubuntu that is
258   the default (fd.o #98889, Simon McVittie)
259
260 • Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
261
262 • Silence many -Wswitch-enum and -Wswitch-default warnings
263   (fd.o #98191; Thomas Zimmermann, Simon McVittie)
264
265 • Install a sysusers.d snippet so `dbus-daemon --system` can be used
266   with an unpopulated /etc (fd.o #99162, Lennart Poettering)
267
268 • Install pkg-config metadata on Unix even if building with CMake
269   (fd.o #99752, Ralf Habacker)
270
271 • Exclude auth mechanisms from REJECTED message if they are supported
272   in the code but but configured to be disallowed (fd.o #99621,
273   Ralf Habacker)
274
275 Fixes:
276
277 • Prevent symlink attacks in the nonce-tcp transport on Unix that could
278   allow an attacker to overwrite a file named "nonce", in a directory
279   that the user running dbus-daemon can write, with a random value
280   known only to the user running dbus-daemon. This is unlikely to be
281   exploitable in practice, particularly since the nonce-tcp transport
282   is really only useful on Windows.
283
284   On Unix systems we strongly recommend using only the unix: and systemd:
285   transports, together with EXTERNAL authentication. These are the only
286   transports and authentication mechanisms enabled by default.
287
288   (fd.o #99828, Simon McVittie)
289
290 • Avoid symlink attacks in the "embedded tests", which are not enabled
291   by default and should never be enabled in production builds of dbus.
292   (fd.o #99828, Simon McVittie)
293
294 • Fix the implementation of re-enabling a timeout so that its
295   countdown is restarted as intended, instead of continually
296   decreasing. (fd.o #95619; Michal Koutný, Simon McVittie)
297
298 • When receiving a message with file descriptors, do not start reading
299   the beginning of the next message, so that only one such message
300   is processed at a time. In conjunction with the fix for #95619
301   this means that processes sending many file descriptors, such as
302   systemd-logind on a system that receives very rapid ssh connections,
303   are not treated as abusive and kicked off the bus. Revert the previous
304   workaround that special-cased uid 0.
305   (fd.o #95263, LP#1591411; Simon McVittie)
306
307 • Do not require TMPDIR, TEMP or TMP to be set when cross-compiling
308   for Windows with CMake (fd.o #99586, Ralf Habacker)
309
310 • Do not set Unix-specific variables when targeting Windows
311   (fd.o #99586, Ralf Habacker)
312
313 • Install Unix executables to ${CMAKE_INSTALL_PREFIX}/bin as intended,
314   not ${CMAKE_INSTALL_PREFIX}/lib (fd.o #99752, Ralf Habacker)
315
316 • Use relative install locations in CMake on Unix to respect DESTDIR,
317   and use GNU-style install layout (fd.o #99721, #99752; Ralf Habacker)
318
319 • Install dbus-arch-deps.h correctly when using CMake
320   (fd.o #99586, #99721; Ralf Habacker)
321
322 • Improve argument validation for `dbus-test-tool spam`
323   (ffd.o #99693, Coverity #54759; Philip Withnall)
324
325 • Don't shift by a negative integer if a hash table becomes monstrously
326   large (fd.o #99641, Coverity #54682; Philip Withnall)
327
328 • Don't leak LSM label if dbus-daemon runs out of memory when dealing with
329   a new connection (fd.o #99612, Coverity #141058; Philip Withnall)
330
331 • Remove an unnecessary NULL check
332   (fd.o #99642, Coverity #141062; Philip Withnall)
333
334 • Improve error handling in unit tests and dbus-send
335   (fd.o #99643, #99694, #99712, #99722, #99723, #99724, #99758,
336   #99759, #99793, Coverity #54688, #54692, #54693, #54697, #54701,
337   #54710, #54711, #54714, #54715, #54718, #54721, #54724, #54726,
338   #54730, #54740, #54822, #54823, #54824, #54825; Philip Withnall)
339
340 • Do not print verbose messages' timestamps to stderr if the actual message
341   has been redirected to the Windows debug port (fd.o #99749, Ralf Habacker)
342
343 D-Bus 1.11.8 (2016-11-28)
344 ==
345
346 The “panics in the face of breakfast foods” release.
347
348 Build-time configuration:
349
350 • The new --enable-debug configure option provides an easy way to
351   enable debug symbols, disable optimization and/or enable profiling.
352
353 • The --enable-compile-warnings configure option can be used to control
354   compiler warnings.
355
356 • The --disable-compiler-optimisations configure option is no longer
357   supported. Use --enable-debug=yes or CFLAGS=-O0 instead.
358
359 Enhancements:
360
361 • D-Bus Specification version 0.30
362   · Define the jargon term "activation" more clearly
363   · Define the jargon term "auto-starting", which is one form of activation
364   · Document the optional SystemdService key in service files
365   · Use versioned interface and bus names in most examples
366   · Clarify intended behaviour of Properties.GetAll
367   (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
368
369 • Fix and enable a lot of compiler warnings to improve future code
370   quality. This might incidentally also fix some environment variable
371   accesses on OS X.
372   · In particular, printf-style functions in the libdbus API are now annotated
373     with __attribute__((__format__(__printf__, *, *))) when compiling with
374     gcc or clang. This might make printf bugs in other software visible
375     at compile time.
376   (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
377   Thomas Zimmermann, Simon McVittie)
378
379 • When running with AppArmor mediation (for example using Ubuntu's patched
380   Linux kernel), clients can no longer auto-start services unless they would
381   have been able to send the auto-starting message to the service after it
382   starts. StartServiceByName() is unaffected, and continues to be allowed by
383   default in AppArmor's <abstractions/dbus-strict> and
384   <abstractions/dbus-session-strict>. (fd.o #98666, Simon McVittie)
385
386 Fixes:
387
388 • Work around an undesired effect of the fix for CVE-2014-3637
389   (fd.o #80559), in which processes that frequently send fds, such as
390   logind during a flood of new PAM sessions, can get disconnected for
391   continuously having at least one fd "in flight" for too long;
392   dbus-daemon interprets that as a potential denial of service attack.
393   The workaround is to disable that check for uid 0 process such as
394   logind, with a message in the system log. The bug remains open while
395   we look for a more general solution.
396   (fd.o #95263, LP#1591411; Simon McVittie)
397
398 • Don't run the test test-dbus-launch-x11.sh if X11 autolaunching
399   was disabled at compile time. That test is not expected to work
400   in that configuration. (fd.o #98665, Simon McVittie)
401
402 D-Bus 1.11.6 (2016-10-10)
403 ==
404
405 The “darkly whimsical” release.
406
407 Security fixes:
408
409 • Do not treat ActivationFailure message received from root-owned systemd
410   name as a format string. In principle this is a security vulnerability,
411   but we do not believe it is exploitable in practice, because only
412   privileged processes can own the org.freedesktop.systemd1 bus name, and
413   systemd does not appear to send activation failures that contain "%".
414
415   Please note that this probably *was* exploitable in dbus versions
416   older than 1.6.30, 1.8.16 and 1.9.10 due to a missing check which at
417   the time was only thought to be a denial of service vulnerability
418   (CVE-2015-0245). If you are still running one of those versions,
419   patch or upgrade immediately.
420
421   (fd.o #98157, Simon McVittie)
422
423 Enhancements:
424
425 • D-Bus Specification version 0.29
426   · Recommend not using '/' for object paths (fd.o #37095, Philip Withnall)
427   · Allow <annotation> in <arg> elements (fd.o #86162, Philip Withnall)
428
429 • Log to syslog when we exceed various anti-DoS limits, and add test
430   coverage for them (fd.o #86442, Simon McVittie)
431
432 • Improve syslog handling so that _dbus_warn() and similar warnings
433   go to syslog, add dbus-daemon --syslog|--nosyslog|--syslog-only options,
434   and log to syslog (instead of /dev/null) when dbus-daemon is started by
435   dbus-launch. (fd.o #97009, Simon McVittie)
436
437 • Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
438   (fd.o #89011, Philip Withnall)
439
440 • When logging messages about service activation, mention which peer
441   requested the activation (fd.o #68212, Philip Withnall)
442
443 • On Linux, mention the LSM label (if available) whenever we print
444   debug information about a peer (fd.o #68212, Philip Withnall)
445
446 Other fixes:
447
448 • Harden dbus-daemon against malicious or incorrect ActivationFailure
449   messages by rejecting them if they do not come from a privileged
450   process, or if systemd activation is not enabled
451   (fd.o #98157, Simon McVittie)
452
453 • Avoid undefined behaviour when setting reply serial number without going
454   via union DBusBasicValue (fd.o #98035, Marc Mutz)
455
456 • Fix CMake build for Unix platforms that do not have -lrt, such as Android,
457   or that do need -lsocket, such as QNX (fd.o #94096, Ralf Habacker)
458
459 • autogen.sh: fail cleanly if autoconf fails (Simon McVittie)
460
461 D-Bus 1.11.4 (2016-08-15)
462 ==
463
464 The “copper pickaxe” release.
465
466 Dependencies:
467
468 • Building from git (but not from tarballs) now requires
469   macros from the GNU Autoconf Archive, for example the autoconf-archive
470   package in Debian or Fedora derivatives.
471
472 Build-time configuration:
473
474 • The option to enable coverage instrumentation has changed from
475   --enable-compiler-coverage to --enable-code-coverage.
476
477 Enhancements:
478
479 • D-Bus Specification version 0.28
480   · Clarify some details of serialization (fd.o #93382, Philip Withnall)
481
482 • Increase listen() backlog of AF_UNIX sockets to the maximum possible,
483   minimizing failed connections under heavy load
484   (fd.o #95264, Lennart Poettering)
485
486 • Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)
487
488 • Use the same regression tests for subprocess starting on Unix and Windows
489   (fd.o #95191, Ralf Habacker)
490
491 • Print timestamps and thread IDs in verbose messages
492   (fd.o #95191, Ralf Habacker)
493
494 • On Unix, unify the various places that reopen stdin, stdout and/or stderr
495   pointing to /dev/null (fd.o #97008, Simon McVittie)
496
497 • Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
498   (fd.o #88922, Thomas Zimmermann)
499
500 Fixes:
501
502 • On Windows, fix a memory leak in replacing the installation prefix
503   (fd.o #95191, Ralf Habacker)
504
505 • On Linux, when dbus-daemon is run with reduced susceptibility to the
506   OOM killer (typically via systemd), do not let child processes inherit
507   that setting (fd.o #32851; Kimmo Hämäläinen, WaLyong Cho)
508
509 • On Unix, make dbus-launch and dbus-daemon --fork work as intended
510   even if a parent process incorrectly starts them with stdin, stdout
511   and/or stderr closed (fd.o #97008, Simon McVittie)
512
513 • Output valid shell syntax in ~/.dbus/session-bus/ if the bus address
514   contains a semicolon (fd.o #94746, Thiago Macieira)
515
516 • Fix memory leaks and thread safety in subprocess starting on Windows
517   (fd.o #95191, Ralf Habacker)
518
519 • Stop test-dbus-daemon incorrectly failing on platforms that cannot
520   discover the process ID of clients (fd.o #96653, Руслан Ижбулатов)
521
522 • In tests that exercise correct handling of crashing D-Bus services,
523   suppress Windows crash handler (fd.o #95155; Yiyang Fei, Ralf Habacker)
524
525 • Explicitly check for stdint.h (Ioan-Adrian Ratiu)
526
527 • In tests, add an invalid DBusAuthState to avoid undefined behaviour
528   in some test cases (fd.o #93909, Nick Lewycky)
529
530 • Add assertions to reassure a static analysis tool
531   (fd.o #93210, Deepika Aggarwal)
532
533 • Be explicit about enum comparison when loading XML
534   (fd.o #93205, Deepika Aggarwal)
535
536 • update-activation-environment: produce better diagnostics on error
537   (fd.o #96653, Simon McVittie)
538
539 • Avoid various compiler warnings with gcc 6
540   (fd.o #97282; Thomas Zimmermann, Simon McVittie)
541
542 • On Unix when configured to use the system log, report as "dbus-daemon",
543   not as "dbus" (fd.o #97009, Simon McVittie)
544
545 • During unit tests, reduce the amount we write to the system log
546   (fd.o #97009, Simon McVittie)
547
548 D-Bus 1.11.2 (2016-03-07)
549 ==
550
551 The “pneumatic drill vs. Iron Maiden” release.
552
553 Fixes:
554
555 • Enable "large file support" on systems where it exists: dbus-daemon
556   is not expected to open large files, but it might need to stat files
557   that happen to have large inode numbers (fd.o #93545, Hongxu Jia)
558
559 • Eliminate padding inside DBusMessageIter on 64-bit platforms,
560   which might result in a pedantic C compiler not copying the entire contents
561   of a DBusMessageIter; statically assert that this is not an ABI change
562   in practice (fd.o #94136, Simon McVittie)
563
564 • Document dbus-test-tool echo --sleep-ms=N instead of incorrect --sleep=N
565   (fd.o #94244, Dmitri Iouchtchenko)
566
567 • Correctly report test failures in C tests from run-test.sh
568   (fd.o #93379; amit tewari, Simon McVittie)
569
570 • When tests are enabled, run all the marshal-validate tests, not just
571   the even-numbered ones (fd.o #93908, Nick Lewycky)
572
573 • Correct the expected error from one marshal-validate test, which was
574   previously not run due to the above bug (fd.o #93908, Simon McVittie)
575
576 • Fix compilation under CMake when embedded tests are disabled
577   (fd.o #94094, eric.hyer)
578
579 Internal changes:
580
581 • Fix all -Wpointer-sign (signed/unsigned mismatch) warnings, and enable the
582   warning (fd.o #93069; Ralf Habacker, Simon McVittie)
583
584 • When building with CMake, use the same gcc/clang warnings as under Autotools,
585   or MSVC warnings that are broadly similar (fd.o #93069, Ralf Habacker)
586
587 • test/name-test: make C tests produce TAP output and run them directly, not
588   via run-test.sh (fd.o #92899, Simon McVittie)
589
590 • Under CMake when cross-compiling for Windows on Unix, run the tests
591   under Wine even if binfmt_misc support is not available
592   (fd.o #88966, Ralf Habacker)
593
594 • The DBUS_USE_TEST_BINARY environment variable is no longer used by builds with
595   embedded tests; DBUS_TEST_DBUS_LAUNCH replaces it (fd.o #92899, Simon McVittie)
596
597 • Factor out some functions that will be needed in future for a Windows
598   implementation of dbus-run-session (fd.o #92899, Ralf Habacker)
599
600 D-Bus 1.11.0 (2015-12-02)
601 ==
602
603 The “peppermint deer” release.
604
605 Dependencies:
606
607 • On non-Windows platforms, dbus now requires an <inttypes.h> that defines
608   C99 constants such as PRId64 and PRIu64.
609
610 Enhancements:
611
612 • D-Bus Specification version 0.27
613   · Specify that services should not reply if NO_REPLY_EXPECTED was used
614     (fd.o #75749, Lars Uebernickel)
615
616 • Add a script to do continuous-integration builds, and metadata to run it
617   on travis-ci.org. To use this, clone the dbus git repository on GitHub
618   and set it up with travis-ci.org; the only special setting needed is
619   "only build branches with a .travis.yml". (fd.o #93194, Simon McVittie)
620
621 • If dbus-daemon is run with --systemd-activation, do not require
622   org.freedesktop.systemd1.service to exist (fd.o #93194, Simon McVittie)
623
624 Fixes:
625
626 • Re-order dbus-daemon startup so that on SELinux systems, the thread
627   that reads AVC notifications retains the ability to write to the
628   audit log (fd.o #92832, Laurent Bigonville)
629
630 • Print 64-bit integers on non-GNU Unix platforms (fd.o #92043, Natanael Copa)
631
632 • When using the Monitoring interface, match messages' destinations
633   (fd.o #92074, Simon McVittie)
634
635 • On Linux with systemd, stop installing a reference to the obsolete
636   dbus.target, and enable dbus.socket statically (fd.o #78412, #92402;
637   Simon McVittie)
638
639 • On Windows, when including configuration files with <include> or
640   <includedir>, apply the same relocation as for the Exec paths
641   in .service files (fd.o #92028, Simon McVittie)
642
643 • Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)
644
645 • Fix many -Wpointer-sign warnings (fd.o #93069, Ralf Habacker)
646
647 D-Bus 1.10.6 (2015-12-01)
648 ==
649
650 The “marzipan beetles” release.
651
652 Fixes:
653
654 • On Unix when running tests as root, don't assert that root and
655   the dbus-daemon user can still call UpdateActivationEnvironment;
656   assert that those privileged users can call BecomeMonitor instead
657   (fd.o #93036, Simon McVittie)
658
659 • On Windows, fix a memory leak in the autolaunch transport (fd.o #92899,
660   Simon McVittie)
661
662 • On Windows Autotools builds, don't run tests that rely on
663   dbus-run-session and other Unix-specifics (fd.o #92899, Simon McVittie)
664
665 D-Bus 1.10.4 (2015-11-17)
666 ==
667
668 The “Frostburn Canyon” release.
669
670 Enhancements:
671
672 • GetConnectionCredentials, GetConnectionUnixUser and
673   GetConnectionUnixProcessID with argument "org.freedesktop.DBus"
674   will now return details of the dbus-daemon itself. This is required
675   to be able to call SetEnvironment on systemd.
676   (fd.o #92857, Jan Alexander Steffens)
677
678 Fixes:
679
680 • Make UpdateActivationEnvironment always fail with AccessDenied on the
681   system bus. Previously, it was possible to configure it so root could
682   call it, but the environment variables were not actually used,
683   because the launch helper would discard them.
684   (fd.o #92857, Jan Alexander Steffens)
685
686 • On Unix with --systemd-activation on a user bus, make
687   UpdateActivationEnvironment pass on its arguments to systemd's
688   SetEnvironment method, solving inconsistency between the environments
689   used for traditional activation and systemd user-service activation.
690   (fd.o #92857, Jan Alexander Steffens)
691
692 • On Windows, don't crash if <syslog/> or --syslog is used
693   (fd.o #92538, Ralf Habacker)
694
695 • On Windows, fix a memory leak when setting a DBusError from a Windows
696   error (fd.o #92721, Ralf Habacker)
697
698 • On Windows, don't go into infinite recursion if we abort the process
699   with backtraces enabled (fd.o #92721, Ralf Habacker)
700
701 • Fix various failing tests, variously on Windows and cross-platform:
702   · don't test system.conf features (users, groups) that only make sense
703     on the system bus, which is not supported on Windows
704   · don't call _dbus_warn() when we skip a test, since it is fatal
705   · fix computation of expected <standard_session_servicedirs/>
706   · when running TAP tests, translate newlines to Unix format, fixing
707     cross-compiled tests under Wine on Linux
708   · don't stress-test refcounting under Wine, where it's really slow
709   · stop assuming that a message looped-back to the test will be received
710     immediately
711   · skip some system bus tests on Windows since they make no sense there
712   (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
713
714 D-Bus 1.10.2 (2015-10-26)
715 ==
716
717 The “worst pies in London” release.
718
719 Fixes:
720
721 • Correct error handling for activation: if there are multiple attempts
722   to activate the same service and it fails immediately, the first attempt
723   would get the correct reply, but the rest would time out. We now send
724   the same error reply to each attempt. (fd.o #92200, Simon McVittie)
725
726 • If BecomeMonitor is called with a syntactically invalid match rule,
727   don't crash with an assertion failure, fixing a regression in 1.9.10.
728   This was not exploitable as a denial of service, because the check
729   for a privileged user is done first. (fd.o #92298, Simon McVittie)
730
731 • On Linux with --enable-user-session, add the bus address to the
732   environment of systemd services for better backwards compatibility
733   (fd.o #92612, Jan Alexander Steffens)
734
735 • On Windows, fix the logic for replacing the installation prefix
736   in service files' Exec lines (fd.o #83539; Milan Crha, Simon McVittie)
737
738 • On Windows, if installed in the conventional layout with ${prefix}/etc
739   and ${prefix}/share, use relative paths between bus configuration files
740   to allow the tree to be relocated (fd.o #92028, Simon McVittie)
741
742 • Make more of the regression tests pass in Windows builds (fd.o #92538,
743   Simon McVittie)
744
745 D-Bus 1.10.0 (2015-08-25)
746 ==
747
748 The “0x20” release.
749
750 This is a new stable branch, recommended for use in OS distributions.
751
752 Fixes since 1.9.20:
753
754 • distribute test/tap-test.sh.in, even if the tarball was built without
755   tests enabled (fd.o #91684, Simon McVittie)
756 • work around a fd leak in libcap-ng < 0.7.7 (fd.o #91684, Simon McVittie)
757
758 Summary of major changes since 1.8.0:
759
760 • The basic setup for the well-known system and session buses is
761   now done in read-only files in ${datadir} (normally /usr/share).
762   See the NEWS entry for 1.9.18 for details.
763
764 • AppArmor integration has been merged, with features similar to the
765   pre-existing SELinux integration. It is mostly compatible with the
766   patches previously shipped by Ubuntu, with one significant change:
767   Ubuntu's GetConnectionAppArmorSecurityContext method has been superseded
768   by GetConnectionCredentials and was not included.
769
770 • The --enable-user-session configure option can be enabled
771   by OS integrators intending to use systemd to provide a session bus
772   per user (in effect, treating all concurrent graphical and non-graphical
773   login sessions as one large session).
774
775 • The new listenable address mode "unix:runtime=yes" listens on
776   $XDG_RUNTIME_DIR/bus, the same AF_UNIX socket used by the systemd
777   user session. libdbus and "dbus-launch --autolaunch" will connect to
778   this address by default. GLib ≥ 2.45.3 and sd-bus ≥ 209 have a
779   matching default.
780
781 • All executables are now dynamically linked to libdbus-1.
782   Previously, some executables, most notably dbus-daemon, were statically
783   linked to a specially-compiled variant of libdbus. This results in
784   various private functions in the _dbus namespace being exposed by the
785   shared library. These are not API, and must not be used outside
786   the dbus source tree.
787
788 • On platforms with ELF symbol versioning, all public symbols
789   are versioned LIBDBUS_1_3.
790
791 New bus APIs:
792
793 • org.freedesktop.DBus.GetConnectionCredentials returns
794   LinuxSecurityLabel where supported
795 • org.freedesktop.DBus.Monitoring interface (privileged)
796   · BecomeMonitor method supersedes match rules with eavesdrop=true,
797     which are now deprecated
798 • org.freedesktop.DBus.Stats interface (semi-privileged)
799   · now enabled by default
800   · new GetAllMatchRules method
801 • org.freedesktop.DBus.Verbose interface (not normally compiled)
802   · toggles the effect of DBUS_VERBOSE
803
804 New executables:
805
806 • dbus-test-tool
807 • dbus-update-activation-environment
808
809 New optional dependencies:
810
811 • The systemd: pseudo-transport requires libsystemd or libsd-daemon
812 • Complete documentation requires Ducktype and yelp-tools
813 • Full test coverage requires GLib 2.36 and PyGI
814 • AppArmor integration requires libapparmor and optionally libaudit
815
816 Dependencies removed:
817
818 • dbus-glib
819
820 D-Bus 1.9.20 (2015-08-06)
821 ==
822
823 The “Remember Tomorrow” release.
824
825 This is a release-candidate for D-Bus 1.10.0. OS distribution vendors
826 should test it.
827
828 Fixes:
829
830 • Don't second-guess what the ABI of poll() is, allowing it to be used
831   on Integrity RTOS and other unusual platforms (fd.o #90314;
832   Rolland Dudemaine, Simon McVittie)
833
834 • Don't duplicate audit subsystem integration if AppArmor and SELinux are
835   both enabled (fd.o #89225, Simon McVittie)
836
837 • Log audit events for AppArmor/SELinux policy violations whenever
838   we have CAP_AUDIT_WRITE, even if not the system bus
839   (fd.o #83856, Laurent Bigonville)
840
841 D-Bus 1.9.18 (2015-07-21)
842 ==
843
844 The “Pirate Elite” release.
845
846 Configuration changes:
847
848 • The basic setup for the well-known system and session buses is now done
849   in read-only files in ${datadir}, moving a step closer to systems
850   that can operate with an empty /etc directory. In increasing order
851   of precedence:
852
853   · ${datadir}/dbus-1/s*.conf now perform the basic setup such as setting
854     the default message policies.
855   · ${sysconfdir}/dbus-1/s*.conf are now optional. By default
856     dbus still installs a trivial version of each, for documentation
857     purposes; putting configuration directives in these files is deprecated.
858   · ${datadir}/dbus-1/s*.d/ are now available for third-party software
859     to install "drop-in" configuration snippets (any packages
860     using those directories should explicitly depend on at least this
861     version of dbus).
862   · ${sysconfdir}/dbus-1/s*.d/ are also still available for sysadmins
863     or third-party software to install "drop-in" configuration snippets
864   · ${sysconfdir}/dbus-1/s*-local.conf are still available for sysadmins'
865     overrides
866
867   ${datadir} is normally /usr/share, ${sysconfdir} is normally /etc,
868   and "s*" refers to either system or session as appropriate.
869
870   (fd.o #89280, Dimitri John Ledkov)
871
872 Fixes:
873
874 • Fix a memory leak when GetConnectionCredentials() succeeds
875   (fd.o #91008, Jacek Bukarewicz)
876
877 • Ensure that dbus-monitor does not reply to messages intended for others,
878   resulting in its own disconnection (fd.o #90952, Simon McVittie)
879
880 D-Bus 1.9.16 (2015-05-14)
881 ==
882
883 The “titanium barns” release.
884
885 Dependencies:
886
887 • Automake 1.13 is now required when compiling from git or modifying
888   the build system.
889
890 Security hardening:
891
892 • On Unix platforms, change the default configuration for the session bus
893   to only allow EXTERNAL authentication (secure kernel-mediated
894   credentials-passing), as was already done for the system bus.
895
896   This avoids falling back to DBUS_COOKIE_SHA1, which relies on strongly
897   unpredictable pseudo-random numbers.
898
899   If you are using D-Bus over the (unencrypted!) tcp: or nonce-tcp: transport,
900   in conjunction with DBUS_COOKIE_SHA1 and a shared home directory using
901   NFS or similar, you will need to reconfigure the session bus to accept
902   DBUS_COOKIE_SHA1 by commenting out the <auth> element. This configuration
903   is not recommended.
904
905   (fd.o #90414, Simon McVittie)
906
907 • When asked for random numbers for DBUS_COOKIE_SHA1, the nonce-tcp:
908   transport, UUIDs or any other reason, fail if we cannot obtain entropy
909   (from /dev/urandom or CryptGenRandom()) or an out-of-memory condition
910   occurs, instead of silently falling back to low-entropy pseudorandom
911   numbers from rand(). (fd.o #90414; Simon McVittie, Ralf Habacker)
912
913 Enhancements:
914
915 • Add dbus_message_iter_get_element_count()
916   (fd.o #30350; Christian Dywan, Simon McVittie)
917
918 • Introduce new internal DBusSocket and DBusPollable types so we can
919   stop treating the Windows SOCKET type as if it was int. DBusSocket
920   is specifically a socket, cross-platform. DBusPollable is whatever
921   _dbus_poll() can act on, i.e. a fd on Unix or a SOCKET on Windows.
922   (fd.o #89444; Ralf Habacker, Simon McVittie)
923
924 • All regression tests now output TAP <https://testanything.org/>
925   (fd.o #89846, Simon McVittie)
926
927 • Internal APIs consistently use signed values for timestamps
928   (fd.o #18494, Peter McCurdy)
929
930 • Improve diagnostics when UpdateActivationEnvironment calls are rejected
931   (fd.o #88812, Simon McVittie)
932
933 • Clean up a lot of compiler warnings
934   (fd.o #17289, fd.o #89284; Ralf Habacker, Simon McVittie)
935
936 Fixes:
937
938 • Add locking to DBusCounter's reference count and notify function
939   (fd.o #89297, Adrian Szyndela)
940
941 • Ensure that DBusTransport's reference count is protected by the
942   corresponding DBusConnection's lock (fd.o #90312, Adrian Szyndela)
943
944 • Correctly release DBusServer mutex before early-return if we run out
945   of memory while copying authentication mechanisms (fd.o #90021,
946   Ralf Habacker)
947
948 • Make dbus-test-tool and dbus-update-activation-environment portable
949   to Windows (fd.o #90089, Ralf Habacker)
950
951 • Correctly initialize all fields of DBusTypeReader (fd.o #90021;
952   Ralf Habacker, Simon McVittie)
953
954 • Fix some missing \n in verbose (debug log) messages (fd.o #90004,
955   Ralf Habacker)
956
957 • Clean up some memory and fd leaks in test code and tools
958   (fd.o #90021, Ralf Habacker)
959
960 • Fix a NULL dereference if the dbus-daemon cannot read a configuration
961   directory for a reason that is not ENOENT (fd.o #90021, Ralf Habacker)
962
963 • CMake generates a versioned shared library even if the revision is 0,
964   as it usually is on the development branch. (fd.o #89450, Ralf Habacker)
965
966 D-Bus 1.9.14 (2015-03-02)
967 ==
968
969 The “don't stand in the poison cloud” release.
970
971 Dependencies:
972
973 • dbus-daemon and dbus-daemon-launch-helper now require libdbus. They
974   were previously linked to a static version of libdbus.
975
976 • The tests no longer require dbus-glib in order to exercise the libdbus
977   shared library; they are always linked to libdbus now.
978
979 Build-time configuration:
980
981 • The new --enable-user-session option, off by default, can be enabled
982   by OS integrators intending to use systemd to provide a session bus
983   per user (in effect, treating all concurrent graphical and non-graphical
984   login sessions as one large session)
985
986 Enhancements:
987
988 • All executables are now linked dynamically to libdbus.
989   (fd.o #83115; Bertrand SIMONNET, Simon McVittie, Ralf Habacker)
990
991 • On platforms that support them (GNU libc and possibly others),
992   libdbus now has versioned symbols for its public API.
993   All public symbols (visible in the header files) are currently
994   versioned as LIBDBUS_1_3; private symbols starting with _dbus or
995   dbus_internal have a version that changes with each release, and
996   must not be used by applications. (also fd.o #83115)
997
998 • New listenable address mode "unix:runtime=yes" which listens on
999   a real filesystem (non-abstract) socket $XDG_RUNTIME_DIR/bus
1000   (fd.o #61303; Colin Walters, Alexander Larsson, Simon McVittie)
1001
1002 • Add optional systemd units for a per-user bus listening on
1003   $XDG_RUNTIME_DIR/bus (fd.o #61301; Simon McVittie, Colin Walters)
1004
1005 • On Unix platforms, both libdbus and "dbus-launch --autolaunch"
1006   default to connecting to $XDG_RUNTIME_DIR/bus if it is a socket
1007   (also fd.o #61301)
1008
1009 • New dbus-update-activation-environment tool uploads environment
1010   variables to "dbus-daemon --session" and optionally "systemd --user",
1011   primarily as a way to keep the per-user bus compatible with
1012   distributions' existing X11 login scripts (also fd.o #61301)
1013
1014 • <includedir/> elements in dbus-daemon configuration are now silently
1015   ignored if the directory does not exist. (fd.o #89280, Dimitri John Ledkov)
1016
1017 • Add microsecond-resolution timestamps to the default output of
1018   dbus-monitor and dbus-send (fd.o #88896; Ralf Habacker, Simon McVittie)
1019
1020 Fixes:
1021
1022 • Fix a race condition in the 'monitor' test introduced in 1.9.10
1023   (fd.o #89222, Simon McVittie)
1024
1025 D-Bus 1.9.12 (2015-02-19)
1026 ==
1027
1028 The “monster lasagna” release.
1029
1030 Dependencies:
1031
1032 • Ducktype and yelp-tools are now required to build complete documentation
1033   (they are optional for normal builds).
1034
1035 Enhancements:
1036
1037 • D-Bus Specification version 0.26
1038   · GetConnectionCredentials can return LinuxSecurityLabel or WindowsSID
1039   · document the BecomeMonitor method
1040
1041 • On Linux, add LinuxSecurityLabel to GetConnectionCredentials
1042   (fd.o #89041; Tyler Hicks, Simon McVittie)
1043
1044 • On Linux, add support for AppArmor mediation of message sending and
1045   receiving and name ownership (paralleling existing SELinux mediation
1046   support), and eavesdropping (a new check, currently AppArmor-specific)
1047   (fd.o #75113; John Johansen, Tyler Hicks, Simon McVittie)
1048
1049 • In dbus-send and dbus-monitor, pretty-print \0-terminated bytestrings
1050   that have printable ASCII contents; we previously only did this for
1051   unterminated bytestrings (fd.o #89109, Simon McVittie)
1052
1053 • Add a guide to designing good D-Bus APIs (fd.o #88994, Philip Withnall)
1054
1055 • On Windows, add WindowsSID to GetConnectionCredentials
1056   (fd.o #54445, Ralf Habacker)
1057
1058 • Improve clarity of dbus-monitor --profile output and add more columns
1059   (fd.o #89165, Ralf Habacker)
1060
1061 • Add a man page for dbus-test-tool, and build it under CMake as well
1062   as Autotools (fd.o#89086, Simon McVittie)
1063
1064 • If dbus-daemon was compiled with --enable-verbose, add a D-Bus API
1065   to control it at runtime, overriding the DBUS_VERBOSE environment variable
1066   (fd.o #88896, Ralf Habacker)
1067
1068 Fixes:
1069
1070 • Reduce the number of file descriptors used in the fd-passing test,
1071   avoiding failure under the default Linux fd limit, and automatically
1072   skip it if the rlimit is too small (fd.o #88998, Simon McVittie)
1073
1074 D-Bus 1.9.10 (2015-02-09)
1075 ==
1076
1077 The “sad cyborgs” release.
1078
1079 Security fixes merged from 1.8.16:
1080
1081 • Do not allow non-uid-0 processes to send forged ActivationFailure
1082   messages. On Linux systems with systemd activation, this would
1083   allow a local denial of service: unprivileged processes could
1084   flood the bus with these forged messages, winning the race with
1085   the actual service activation and causing an error reply
1086   to be sent back when service auto-activation was requested.
1087   This does not prevent the real service from being started,
1088   so the attack only works while the real service is not running.
1089   (CVE-2015-0245, fd.o #88811; Simon McVittie)
1090
1091 Enhancements:
1092
1093 • The new Monitoring interface in the dbus-daemon lets dbus-monitor and
1094   similar tools receive messages without altering the security properties
1095   of the system bus, by calling the new BecomeMonitor method on a
1096   private connection. This bypasses the normal <allow> and <deny> rules
1097   entirely, so to preserve normal message-privacy assumptions, only root
1098   is allowed to do this on the system bus. Restricted environments,
1099   such as Linux with LSMs, should lock down access to the Monitoring
1100   interface. (fd.o #46787, Simon McVittie)
1101
1102 • dbus-monitor uses BecomeMonitor to capture more traffic, if the
1103   dbus-daemon supports it and access permissions allow it.
1104   It still supports the previous approach ("eavesdropping" match rules)
1105   for compatibility with older bus daemons. (fd.o #46787, Simon)
1106
1107 • dbus-monitor can now log the message stream as binary data for later
1108   analysis, with either no extra framing beyond the normal D-Bus headers,
1109   or libpcap-compatible framing treating each D-Bus message
1110   as a captured packet. (fd.o #46787, Simon)
1111
1112 Other fixes:
1113
1114 • Fix some CMake build regressions (fd.o #88964, Ralf Habacker)
1115
1116 • On Unix, forcibly terminate regression tests after 60 seconds to
1117   prevent them from blocking continuous integration frameworks
1118   (fd.o #46787, Simon)
1119
1120 D-Bus 1.9.8 (2015-02-03)
1121 ==
1122
1123 The “all the types of precipitation” release.
1124
1125 Dependencies:
1126
1127 • full test coverage now requires GLib 2.36
1128 • full test coverage now requires PyGI (PyGObject 3,
1129   "import gi.repository.GObject") instead of the
1130   obsolete PyGObject 2 ("import gobject")
1131
1132 Enhancements:
1133
1134 • add GLib-style "installed tests" (fd.o #88810, Simon McVittie)
1135
1136 • better regression test coverage, including systemd activation
1137   (fd.o #57952, #88810; Simon McVittie)
1138
1139 Fixes:
1140
1141 • fatal errors correctly make the dbus-daemon exit even if <syslog/> is
1142   turned off (fd.o #88808, Simon McVittie)
1143
1144 • TCP sockets on Windows no longer fail to listen approximately 1 time
1145   in 256, caused by a logic error that should have always made it fail but
1146   was mitigated by incorrect endianness for the port number
1147   (fd.o #87999, Ralf Habacker)
1148
1149 • fix some Windows build failures (fd.o #88009, #88010; Ralf Habacker)
1150
1151 • on Windows, allow up to 8K connections to the dbus-daemon instead of the
1152   previous 64, completing a previous fix which only worked under
1153   Autotools (fd.o #71297, Ralf Habacker)
1154
1155 • on Windows, if the IP family is unspecified only use IPv4,
1156   to mitigate IPv6 not working correctly (fd.o #87999, Ralf Habacker)
1157
1158 • fix some unlikely memory leaks on OOM (fd.o #88087, Simon McVittie)
1159
1160 • lcov code coverage analysis works again (fd.o #88808, Simon McVittie)
1161
1162 • fix an unused function error with --disable-embedded-tests (fd.o #87837,
1163   Thiago Macieira)
1164
1165 D-Bus 1.9.6 (2015-01-05)
1166 ==
1167
1168 The “I do have a bread knife” release.
1169
1170 Security hardening:
1171
1172 • Do not allow calls to UpdateActivationEnvironment from uids other than
1173   the uid of the dbus-daemon. If a system service installs unsafe
1174   security policy rules that allow arbitrary method calls
1175   (such as CVE-2014-8148) then this prevents memory consumption and
1176   possible privilege escalation via UpdateActivationEnvironment.
1177
1178   We believe that in practice, privilege escalation here is avoided
1179   by dbus-daemon-launch-helper sanitizing its environment; but
1180   it seems better to be safe.
1181
1182 • Do not allow calls to UpdateActivationEnvironment or the Stats interface
1183   on object paths other than /org/freedesktop/DBus. Some system services
1184   install unsafe security policy rules that allow arbitrary method calls
1185   to any destination, method and interface with a specified object path;
1186   while less bad than allowing arbitrary method calls, these security
1187   policies are still harmful, since dbus-daemon normally offers the
1188   same API on all object paths and other system services might behave
1189   similarly.
1190
1191 Other fixes:
1192
1193 • Add missing initialization so GetExtendedTcpTable doesn't crash on
1194   Windows Vista SP0 (fd.o #77008, Илья А. Ткаченко)
1195
1196 D-Bus 1.9.4 (2014-11-24)
1197 ==
1198
1199 The “extra-sturdy caramel” release.
1200
1201 Fixes:
1202
1203 • Partially revert the CVE-2014-3639 patch by increasing the default
1204   authentication timeout on the system bus from 5 seconds back to 30
1205   seconds, since this has been reported to cause boot regressions for
1206   some users, mostly with parallel boot (systemd) on slower hardware.
1207
1208   On fast systems where local users are considered particularly hostile,
1209   administrators can return to the 5 second timeout (or any other value
1210   in milliseconds) by saving this as /etc/dbus-1/system-local.conf:
1211
1212   <busconfig>
1213     <limit name="auth_timeout">5000</limit>
1214   </busconfig>
1215
1216   (fd.o #86431, Simon McVittie)
1217
1218 • Add a message in syslog/the Journal when the auth_timeout is exceeded
1219   (fd.o #86431, Simon McVittie)
1220
1221 • Send back an AccessDenied error if the addressed recipient is not allowed
1222   to receive a message (and in builds with assertions enabled, don't
1223   assert under the same conditions). (fd.o #86194, Jacek Bukarewicz)
1224
1225 D-Bus 1.9.2 (2014-11-10)
1226 ==
1227
1228 The “structurally unsound flapjack” release.
1229
1230 Security fixes:
1231
1232 • Increase dbus-daemon's RLIMIT_NOFILE rlimit to 65536
1233   so that CVE-2014-3636 part A cannot exhaust the system bus'
1234   file descriptors, completing the incomplete fix in 1.8.8.
1235   (CVE-2014-7824, fd.o #85105; Simon McVittie, Alban Crequy)
1236
1237 Enhancements:
1238
1239 • D-Bus Specification version 0.25
1240   · new value 'const' for EmitsChangedSignal annotation
1241     (fd.o #72958, Lennart Poettering)
1242   · new ALLOW_INTERACTIVE_AUTHORIZATION flag, for PolicyKit and similar
1243     (fd.o #83449; Lennart Poettering, Simon McVittie)
1244   · annotate table of types with reserved/basic/container, and for
1245     basic types, fixed/string-like
1246   · clarify arbitrary limits by quoting them in mebibytes
1247
1248 • New API: add accessors for the ALLOW_INTERACTIVE_AUTHORIZATION flag
1249   (fd.o #83449, Simon McVittie)
1250
1251 • Add dbus-test-tool, a D-Bus swiss army knife with multiple subcommands,
1252   useful for debugging and performance testing:
1253   · dbus-test-tool spam: send repeated messages
1254   · dbus-test-tool echo: send an empty reply for all method calls
1255   · dbus-test-tool black-hole: do not reply to method calls
1256   (fd.o #34140; Alban Crequy, Simon McVittie, Will Thompson)
1257
1258 • Add support for process ID in credentials-passing on NetBSD
1259   (fd.o #69702, Patrick Welche)
1260
1261 • Add an example script to find potentially undesired match rules
1262   (fd.o #84598, Alban Crequy)
1263
1264 • Document the central assumption that makes our use of credentials-passing
1265   secure (fd.o #83499, Simon McVittie)
1266
1267 • Replace the dbus-glib section of the tutorial with a GDBus recommendation,
1268   and add some links to GDBus and QtDBus documentation (fd.o #25140,
1269   Simon McVittie)
1270
1271 Fixes:
1272
1273 • Use a less confusing NoReply message when disconnected with a reply pending
1274   (fd.o #76112, Simon McVittie)
1275
1276 • Make the .pc file relocatable by letting pkg-config do all variable
1277   expansion itself (fd.o #75858, Руслан Ижбулатов)
1278
1279 • Fix a build failure on platforms with kqueue, which regressed in 1.9.0
1280   (fd.o #85563, Patrick Welche)
1281
1282 • Consistently save errno after socket calls (fd.o #83625, Simon McVittie)
1283
1284 • In dbus-spawn, when the grandchild process exits due to a failed exec(),
1285   do not lose the exec() errno (fd.o #24821, Simon McVittie)
1286
1287 • Do not fail the tests if a parent process has leaked non-close-on-exec
1288   file descriptors to us (fd.o #73689, fd.o #83899; Simon McVittie)
1289
1290 • Do not fail the tests on Unix platforms with incomplete
1291   credentials-passing support, but do fail if we can't pass credentials
1292   on a platform where it is known to work: Linux, FreeBSD, OpenBSD, NetBSD
1293   (fd.o #69702, Simon McVittie)
1294
1295 • Detect accept4, dirfd, inotify_init1, pipe2, and Unix fd passing
1296   when building with cmake, and expand test coverage there
1297   (fd.o #73689; Ralf Habacker, Simon McVittie)
1298
1299 D-Bus 1.9.0 (2014-10-01)
1300 ==
1301
1302 The “tiered cheeses” release.
1303
1304 Requirements:
1305
1306 • Support for the systemd: (LISTEN_FDS) pseudo-transport on Linux now
1307   requires either the libsystemd or libsd-daemon shared library, dropping the
1308   embedded convenience copy of sd-daemon (fd.o #71818, Simon)
1309
1310 Build-time configuration changes:
1311
1312 • The Stats interface is now enabled by default, and locked-down to
1313   root-only on the system bus. Configure with --disable-stats
1314   to disable it altogether on memory- or disk-constrained systems,
1315   or see ${docdir}/examples/ to open it up to non-root users on the
1316   system bus or restrict access on the session bus.
1317   (fd.o #80759; Simon McVittie, Alban Crequy)
1318
1319 • The CMake build system now builds the same shared library name as Autotools
1320   on at least Linux and Windows:
1321   - on Linux (and perhaps other Unix platforms), it previously built
1322     libdbus-1.so, but now builds libdbus-1.so.3.* with development
1323     symlink libdbus-1.so and SONAME/symlink libdbus-1.so.3
1324   - on Windows, it previously built either libdbus-1.dll (release) or
1325     libdbus-1d.dll (debug), but now builds libdbus-1-3.dll, copied to
1326     libdbus-1.dll for compatibility with older applications.
1327   (fd.o #74117, Ralf Habacker)
1328
1329 Enhancements:
1330
1331 • D-Bus Specification version 0.24
1332   · document how to quote match rules (fd.o #24307, Simon McVittie)
1333   · explicitly say that most message types never expect a reply
1334     regardles of whether they have NO_REPLY_EXPECTED
1335     (fd.o #75749, Simon McVittie)
1336
1337 • on Unix platforms, disable Nagle's algorithm on TCP connections to improve
1338   initial latency (fd.o #75544, Matt Hoosier)
1339
1340 • use backtrace() if it is in -lexecinfo instead of libc, as on NetBSD
1341   (fd.o #69702, Patrick Welche)
1342
1343 • in dbus-monitor, print more information about file descriptors
1344   (fd.o #80603, Alban Crequy)
1345
1346 • do not install system bus configuration if built for Windows
1347   (fd.o #83583; Ralf Habacker, Simon McVittie)
1348
1349 • Add GetAllMatchRules to the Stats interface (fd.o #24307, Alban Crequy)
1350
1351 • Add a regression test for file descriptor passing (fd.o #83622,
1352   Simon McVittie)
1353
1354 Fixes:
1355
1356 • fix an incorrect error message if a Unix socket path is too long
1357   (fd.o #73887, Antoine Jacoutot)
1358
1359 • in an MSYS/Cygwin environment, pass Unix-style filenames to xmlto,
1360   fixing documentation generation (fd.o #75860, Руслан Ижбулатов)
1361
1362 • in Unix with X11, avoid giving dbus-launch a misleading argv[0]
1363   in ps(1) (fd.o #69716, Chengwei Yang)
1364
1365 • avoid calling poll() with timeout < -1, which is considered invalid
1366   on FreeBSD and NetBSD (fd.o #78480, Jaap Boender)
1367
1368 • be portable to BSD-derived platforms where O_CLOEXEC is unavailable in libc
1369   (like Mac OS X 10.6), or available in libc but unsupported by the kernel
1370   (fd.o #77032; rmvsxop, OBATA Akio, Patrick Welche)
1371
1372 • Fix include path for test/internal/*.c with cmake (Ralf Habacker)
1373
1374 • Documentation improvements
1375   (fd.o #80795, #84313; Thomas Haller, Sebastian Rasmussen)
1376
1377 • in dbus-monitor, do not leak file descriptors that we have monitored
1378   (fd.o #80603, Alban Crequy)
1379
1380 • Set the close-on-exec flag for the inotify file descriptor, even
1381   if built with CMake or older libc (fd.o #73689, Simon McVittie)
1382
1383 • Remove some LGPL code from the Windows dbus-daemon
1384   (fd.o #57272, Ralf Habacker)
1385
1386 D-Bus 1.8.8 (2014-09-16)
1387 ==
1388
1389 The "smashy smashy egg man" release.
1390
1391 Security fixes:
1392
1393 • Do not accept an extra fd in the padding of a cmsg message, which
1394   could lead to a 4-byte heap buffer overrun.
1395   (CVE-2014-3635, fd.o #83622; Simon McVittie)
1396
1397 • Reduce default for maximum Unix file descriptors passed per message
1398   from 1024 to 16, preventing a uid with the default maximum number of
1399   connections from exhausting the system bus' file descriptors under
1400   Linux's default rlimit. Distributors or system administrators with a
1401   more restrictive fd limit may wish to reduce these limits further.
1402
1403   Additionally, on Linux this prevents a second denial of service
1404   in which the dbus-daemon can be made to exceed the maximum number
1405   of fds per sendmsg() and disconnect the process that would have
1406   received them.
1407   (CVE-2014-3636, fd.o #82820; Alban Crequy)
1408
1409 • Disconnect connections that still have a fd pending unmarshalling after
1410   a new configurable limit, pending_fd_timeout (defaulting to 150 seconds),
1411   removing the possibility of creating an abusive connection that cannot be
1412   disconnected by setting up a circular reference to a connection's
1413   file descriptor.
1414   (CVE-2014-3637, fd.o #80559; Alban Crequy)
1415
1416 • Reduce default for maximum pending replies per connection from 8192 to 128,
1417   mitigating an algorithmic complexity denial-of-service attack
1418   (CVE-2014-3638, fd.o #81053; Alban Crequy)
1419
1420 • Reduce default for authentication timeout on the system bus from
1421   30 seconds to 5 seconds, avoiding denial of service by using up
1422   all unauthenticated connection slots; and when all unauthenticated
1423   connection slots are used up, make new connection attempts block
1424   instead of disconnecting them.
1425   (CVE-2014-3639, fd.o #80919; Alban Crequy)
1426
1427 Other fixes:
1428
1429 • Check for libsystemd from systemd >= 209, falling back to
1430   the older separate libraries if not found (Umut Tezduyar Lindskog,
1431   Simon McVittie)
1432
1433 • On Linux, use prctl() to disable core dumps from a test executable
1434   that deliberately raises SIGSEGV to test dbus-daemon's handling
1435   of that condition (fd.o #83772, Simon McVittie)
1436
1437 • Fix compilation with --enable-stats (fd.o #81043, Gentoo #507232;
1438   Alban Crequy)
1439
1440 • Improve documentation for running tests on Windows (fd.o #41252,
1441   Ralf Habacker)
1442
1443 D-Bus 1.8.6 (2014-06-02)
1444 ==
1445
1446 Security fixes:
1447
1448 • On Linux ≥ 2.6.37-rc4, if sendmsg() fails with ETOOMANYREFS, silently drop
1449   the message. This prevents an attack in which a malicious client can
1450   make dbus-daemon disconnect a system service, which is a local
1451   denial of service.
1452   (fd.o #80163, CVE-2014-3532; Alban Crequy)
1453
1454 • Track remaining Unix file descriptors correctly when more than one
1455   message in quick succession contains fds. This prevents another attack
1456   in which a malicious client can make dbus-daemon disconnect a system
1457   service.
1458   (fd.o #79694, fd.o #80469, CVE-2014-3533; Alejandro Martínez Suárez,
1459   Simon McVittie, Alban Crequy)
1460
1461 Other fixes:
1462
1463 • When dbus-launch --exit-with-session starts a dbus-daemon but then cannot
1464   attach to a session, kill the dbus-daemon as intended
1465   (fd.o #74698, Роман Донченко)
1466
1467 D-Bus 1.8.4 (2014-06-10)
1468 ==
1469
1470 Security fix:
1471
1472 • Alban Crequy at Collabora Ltd. discovered and fixed a denial-of-service
1473   flaw in dbus-daemon, part of the reference implementation of D-Bus.
1474   Additionally, in highly unusual environments the same flaw could lead to
1475   a side channel between processes that should not be able to communicate.
1476   (CVE-2014-3477, fd.o #78979)
1477
1478 D-Bus 1.8.2 (2014-04-30)
1479 ==
1480
1481 The “nobody wants red” release.
1482
1483 Enhancements:
1484
1485 • in the CMake build system, add some hints for Linux users cross-compiling
1486   Windows D-Bus binaries to be able to run tests under Wine
1487   (fd.o #41252, Ralf Habacker)
1488
1489 • add Documentation key to dbus.service (fd.o #77447, Cameron Norman)
1490
1491 Fixes:
1492
1493 • in "dbus-uuidgen --ensure", try to copy systemd's /etc/machine-id
1494   to /var/lib/dbus/machine-id instead of generating an entirely new ID
1495   (fd.o #77941, Simon McVittie)
1496
1497 • if dbus-launch receives an X error very quickly, do not kill
1498   unrelated processes (fd.o #74698, Роман Донченко)
1499
1500 • on Windows, allow up to 8K connections to the dbus-daemon, instead of the
1501   previous 64 (fd.o #71297; Cristian Onet, Ralf Habacker)
1502
1503 • cope with \r\n newlines in regression tests, since on Windows,
1504   dbus-daemon.exe uses text mode (fd.o #75863, Руслан Ижбулатов)
1505
1506 D-Bus 1.8.0 (2014-01-20)
1507 ==
1508
1509 The “Wolverine distrusts my printer” release.
1510
1511 This starts a new stable branch. The 1.6.x branch is now considered to be
1512 outdated, and will only receive fixes for serious bugs such as security
1513 flaws. The 1.4.x and 1.2.x branches no longer have upstream support and
1514 are unlikely to get any more releases, but if distributors still need to
1515 support them, please share security patches via upstream.
1516
1517 Summary of changes since 1.6.x:
1518
1519 • libdbus always behaves as if dbus_threads_init_default() had been called
1520   (thread-safety by default)
1521 • new dbus-run-session tool, replacing certain misuses of dbus-launch
1522 • dbus-monitor can talk to outdated versions of dbus-daemon again
1523 • new org.freedesktop.DBus.GetConnectionCredentials method
1524 • GetConnectionUnixProcessID also works correctly on Windows, returning
1525   the Windows process ID
1526 • GetConnectionWindowsSID returns the correct SID on Windows
1527 • expat is required, libxml2 can no longer be used as a substitute
1528 • the userDB cache is required, and cannot be disabled
1529 • a 64-bit integer type (either int, long, long long or _int64) is required
1530 • better systemd-journald integration on Linux
1531 • fixed long-standing fd and array leaks when failing to parse a message
1532 • fixed referenced-but-never-freed parent nodes (effectively memory leaks)
1533   when using certain object-path allocation patterns, notably in Avahi
1534 • better defaults for Windows support
1535 • better CMake support
1536 • better portability to mingw32, FreeBSD, NetBSD, QNX and Hurd
1537 • the source language for the man pages is now Docbook XML
1538
1539 Enhancements since 1.7.10:
1540
1541 • Enhance the CMake build system to check for GLib and compile/run
1542   a subset of the regression tests (fd.o #41252, #73495; Ralf Habacker)
1543
1544 Fixes since 1.7.10:
1545
1546 • don't rely on va_copy(), use DBUS_VA_COPY() wrapper (fd.o #72840,
1547   Ralf Habacker)
1548
1549 • fix compilation of systemd journal support on older systemd versions where
1550   sd-journal.h doesn't include syslog.h (fd.o #73455, Ralf Habacker)
1551
1552 • fix compilation on older MSVC versions by including stdlib.h
1553   (fd.o #73455, Ralf Habacker)
1554
1555 • Allow <allow_anonymous/> to appear in an included configuration file
1556   (fd.o #73475, Matt Hoosier)
1557
1558 Test behaviour changes since 1.7.10:
1559
1560 • If the tests crash with an assertion failure, they no longer default to
1561   blocking for a debugger to be attached. Set DBUS_BLOCK_ON_ABORT in the
1562   environment if you want the old behaviour.
1563
1564 • To improve debuggability, the dbus-daemon and dbus-daemon-eavesdrop tests
1565   can be run with an external dbus-daemon by setting
1566   DBUS_TEST_DAEMON_ADDRESS in the environment. Test-cases that require
1567   an unusually-configured dbus-daemon are skipped.
1568
1569 D-Bus 1.7.10 (2014-01-06)
1570 ==
1571
1572 The “weighted companion cube” release.
1573
1574 This is a release candidate for D-Bus 1.8.
1575
1576 D-Bus Specification 0.23:
1577
1578 • don't require messages with no INTERFACE to be dispatched
1579   (fd.o #68597, Simon McVittie)
1580
1581 • document "tcp:bind=..." and "nonce-tcp:bind=..." (fd.o #72301,
1582   Chengwei Yang)
1583
1584 • define "listenable" and "connectable" addresses, and discuss
1585   the difference (fd.o #61303, Simon McVittie)
1586
1587 Enhancements:
1588
1589 • support printing Unix file descriptors in dbus-send, dbus-monitor
1590   (fd.o #70592, Robert Ancell)
1591
1592 • don't install systemd units if --disable-systemd is given
1593   (fd.o #71818, Chengwei Yang)
1594
1595 Fixes:
1596
1597 • don't leak memory on out-of-memory while listing activatable or
1598   active services (fd.o #71526, Radoslaw Pajak)
1599
1600 • fix undefined behaviour in a regression test (fd.o #69924, DreamNik)
1601
1602 • escape Unix socket addresses correctly (fd.o #46013, Chengwei Yang)
1603
1604 • on SELinux systems, don't assume that SECCLASS_DBUS, DBUS__ACQUIRE_SVC
1605   and DBUS__SEND_MSG are numerically equal to their values in the
1606   reference policy (fd.o #88719, osmond sun)
1607
1608 • define PROCESS_QUERY_LIMITED_INFORMATION if missing from MinGW < 4 headers
1609   (fd.o #71366, Matt Fischer)
1610
1611 • define WIN32_LEAN_AND_MEAN to avoid conflicts between winsock.h and
1612   winsock2.h (fd.o #71405, Matt Fischer)
1613
1614 • do not return failure from _dbus_read_nonce() with no error set,
1615   preventing a potential crash (fd.o #72298, Chengwei Yang)
1616
1617 • on BSD systems, avoid some O(1)-per-process memory and fd leaks in kqueue,
1618   preventing test failures (fd.o #69332, fd.o #72213; Chengwei Yang)
1619
1620 • fix warning spam on Hurd by not trying to set SO_REUSEADDR on Unix sockets,
1621   which doesn't do anything anyway on at least Linux and FreeBSD
1622   (fd.o #69492, Simon McVittie)
1623
1624 • fix use of TCP sockets on FreeBSD and Hurd by tolerating EINVAL from
1625   sendmsg() with SCM_CREDS (retrying with plain send()), and looking
1626   for credentials more correctly (fd.o #69492, Simon McVittie)
1627
1628 • ensure that tests run with a temporary XDG_RUNTIME_DIR to avoid
1629   getting mixed up in XDG/systemd "user sessions" (fd.o #61301,
1630   Simon McVittie)
1631
1632 • refresh cached policy rules for existing connections when bus
1633   configuration changes (fd.o #39463, Chengwei Yang)
1634
1635 D-Bus 1.7.8 (2013-11-01)
1636 ==
1637
1638 The “extreme hills” release.
1639
1640 Dependencies:
1641
1642 • If systemd support is enabled, libsystemd-journal is now required.
1643
1644 Enhancements:
1645
1646 • When activating a non-systemd service under systemd, annotate its
1647   stdout/stderr with its bus name in the Journal. Known limitation:
1648   because the socket is opened before forking, the process will still be
1649   logged as if it had dbus-daemon's process ID and user ID.
1650   (fd.o #68559, Chengwei Yang)
1651
1652 • Document more configuration elements in dbus-daemon(1)
1653   (fd.o #69125, Chengwei Yang)
1654
1655 Fixes:
1656
1657 • Don't leak string arrays or fds if dbus_message_iter_get_args_valist()
1658   unpacks them and then encounters an error (fd.o #21259, Chengwei Yang)
1659
1660 • If compiled with libaudit, retain CAP_AUDIT_WRITE so we can write
1661   disallowed method calls to the audit log, fixing a regression in 1.7.6
1662   (fd.o #49062, Colin Walters)
1663
1664 • path_namespace='/' in match rules incorrectly matched nothing; it
1665   now matches everything. (fd.o #70799, Simon McVittie)
1666
1667 D-Bus 1.7.6 (2013-10-09)
1668 ==
1669
1670 The “CSI Shrewsbury” release.
1671
1672 Build-time configuration changes:
1673
1674 • Directory change notification via dnotify on Linux is no longer
1675   supported; it hadn't compiled successfully since 2010 in any case.
1676   If you don't have inotify (Linux) or kqueue (*BSD), you will need
1677   to send SIGHUP to the dbus-daemon when its configuration changes.
1678   (fd.o #33001, Chengwei Yang)
1679
1680 • Compiling with --disable-userdb-cache is no longer supported;
1681   it didn't work since at least 2008, and would lead to an extremely
1682   slow dbus-daemon even it worked. (fd.o #15589, #17133, #66947;
1683   Chengwei Yang)
1684
1685 • The DBUS_DISABLE_ASSERTS CMake option didn't actually disable most
1686   assertions. It has been renamed to DBUS_DISABLE_ASSERT to be consistent
1687   with the Autotools build system. (fd.o #66142, Chengwei Yang)
1688
1689 • --with-valgrind=auto enables Valgrind instrumentation if and only if
1690   valgrind headers are available. The default is still --with-valgrind=no.
1691   (fd.o #56925, Simon McVittie)
1692
1693 Dependencies:
1694
1695 • Platforms with no 64-bit integer type are no longer supported.
1696   (fd.o #65429, Simon McVittie)
1697
1698 • GNU make is now (documented to be) required. (fd.o #48277, Simon McVittie)
1699
1700 • Full test coverage no longer requires dbus-glib, although the tests do not
1701   exercise the shared library (only a static copy) if dbus-glib is missing.
1702   (fd.o #68852, Simon McVittie)
1703
1704 Enhancements:
1705
1706 • D-Bus Specification 0.22
1707   · Document GetAdtAuditSessionData() and
1708     GetConnectionSELinuxSecurityContext() (fd.o #54445, Simon)
1709   · Fix example .service file (fd.o #66481, Chengwei Yang)
1710   · Don't claim D-Bus is "low-latency" (lower than what?), just
1711     give factual statements about it supporting async use
1712     (fd.o #65141, Justin Lee)
1713   · Document the contents of .service files, and the fact that
1714     system services' filenames are constrained
1715     (fd.o #66608; Simon McVittie, Chengwei Yang)
1716
1717 • Be thread-safe by default on all platforms, even if
1718   dbus_threads_init_default() has not been called. For compatibility with
1719   older libdbus, library users should continue to call
1720   dbus_threads_init_default(): it is harmless to do so.
1721   (fd.o #54972, Simon McVittie)
1722
1723 • Add GetConnectionCredentials() method (fd.o #54445, Simon)
1724
1725 • New API: dbus_setenv(), a simple wrapper around setenv().
1726   Note that this is not thread-safe. (fd.o #39196, Simon)
1727
1728 • Add dbus-send --peer=ADDRESS (connect to a given peer-to-peer connection,
1729   like --address=ADDRESS in previous versions) and dbus-send --bus=ADDRESS
1730   (connect to a given bus, like dbus-monitor --address=ADDRESS).
1731   dbus-send --address still exists for backwards compatibility,
1732   but is no longer documented. (fd.o #48816, Andrey Mazo)
1733
1734 • Windows-specific:
1735   · "dbus-daemon --nofork" is allowed on Windows again. (fd.o #68852,
1736     Simon McVittie)
1737
1738 Fixes:
1739
1740 • Avoid an infinite busy-loop if a signal interrupts waitpid()
1741   (fd.o #68945, Simon McVittie)
1742
1743 • Clean up memory for parent nodes when objects are unexported
1744   (fd.o #60176, Thomas Fitzsimmons)
1745
1746 • Make dbus_connection_set_route_peer_messages(x, FALSE) behave as
1747   documented. Previously, it assumed its second parameter was TRUE.
1748   (fd.o #69165, Chengwei Yang)
1749
1750 • Escape addresses containing non-ASCII characters correctly
1751   (fd.o #53499, Chengwei Yang)
1752
1753 • Document <servicedir> search order correctly (fd.o #66994, Chengwei Yang)
1754
1755 • Don't crash on "dbus-send --session / x.y.z" which regressed in 1.7.4.
1756   (fd.o #65923, Chengwei Yang)
1757
1758 • If malloc() returns NULL in _dbus_string_init() or similar, don't free
1759   an invalid pointer if the string is later freed (fd.o #65959, Chengwei Yang)
1760
1761 • If malloc() returns NULL in dbus_set_error(), don't va_end() a va_list
1762   that was never va_start()ed (fd.o #66300, Chengwei Yang)
1763
1764 • fix build failure with --enable-stats (fd.o #66004, Chengwei Yang)
1765
1766 • fix a regression test on platforms with strict alignment (fd.o #67279,
1767   Colin Walters)
1768
1769 • Avoid calling function parameters "interface" since certain Windows headers
1770   have a namespace-polluting macro of that name (fd.o #66493, Ivan Romanov)
1771
1772 • Assorted Doxygen fixes (fd.o #65755, Chengwei Yang)
1773
1774 • Various thread-safety improvements to static variables (fd.o #68610,
1775   Simon McVittie)
1776
1777 • Make "make -j check" work (fd.o #68852, Simon McVittie)
1778
1779 • Fix a NULL pointer dereference on an unlikely error path
1780   (fd.o #69327, Sviatoslav Chagaev)
1781
1782 • Improve valgrind memory pool tracking (fd.o #69326,
1783   Sviatoslav Chagaev)
1784
1785 • Don't over-allocate memory in dbus-monitor (fd.o #69329,
1786   Sviatoslav Chagaev)
1787
1788 • dbus-monitor can monitor dbus-daemon < 1.5.6 again
1789   (fd.o #66107, Chengwei Yang)
1790
1791 • Unix-specific:
1792   · If accept4() fails with EINVAL, as it can on older Linux kernels
1793     with newer glibc, try accept() instead of going into a busy-loop.
1794     (fd.o #69026, Chengwei Yang)
1795   · If socket() or socketpair() fails with EINVAL or EPROTOTYPE,
1796     for instance on Hurd or older Linux with a new glibc, try without
1797     SOCK_CLOEXEC. (fd.o #69073; Pino Toscano, Chengwei Yang)
1798   · Fix a file descriptor leak on an error code path.
1799     (fd.o #69182, Sviatoslav Chagaev)
1800   · dbus-run-session: clear some unwanted environment variables
1801     (fd.o #39196, Simon)
1802   · dbus-run-session: compile on FreeBSD (fd.o #66197, Chengwei Yang)
1803   · Don't fail the autolaunch test if there is no DISPLAY (fd.o #40352, Simon)
1804   · Use dbus-launch from the builddir for testing, not the installed copy
1805     (fd.o #37849, Chengwei Yang)
1806   · Fix compilation if writev() is unavailable (fd.o #69409,
1807     Vasiliy Balyasnyy)
1808   · Remove broken support for LOCAL_CREDS credentials passing, and
1809     document where each credential-passing scheme is used (fd.o #60340,
1810     Simon McVittie)
1811   · Make autogen.sh work on *BSD by not assuming GNU coreutils functionality
1812     (fd.o #35881, #69787; Chengwei Yang)
1813   · dbus-monitor: be portable to NetBSD (fd.o #69842, Chengwei Yang)
1814   · dbus-launch: stop using non-portable asprintf (fd.o #37849, Simon)
1815   · Improve error reporting from the setuid activation helper (fd.o #66728,
1816     Chengwei Yang)
1817
1818 • Windows-specific:
1819   · Remove unavailable command-line options from 'dbus-daemon --help'
1820     (fd.o #42441, Ralf Habacker)
1821   · Add support for looking up local TCPv4 clients' credentials on
1822     Windows XP via the undocumented AllocateAndGetTcpExTableFromStack
1823     function (fd.o #66060, Ralf Habacker)
1824   · Fix insufficient dependency-tracking (fd.o #68505, Simon McVittie)
1825   · Don't include wspiapi.h, fixing a compiler warning (fd.o #68852,
1826     Simon McVittie)
1827
1828 • Internal changes:
1829   · add DBUS_ENABLE_ASSERT, DBUS_ENABLE_CHECKS for less confusing
1830     conditionals (fd.o #66142, Chengwei Yang)
1831   · improve verbose-mode output (fd.o #63047, Colin Walters)
1832   · consolidate Autotools and CMake build (fd.o #64875, Ralf Habacker)
1833   · fix various unused variables, unusual build configurations
1834     etc. (fd.o #65712, #65990, #66005, #66257, #69165, #69410, #70218;
1835     Chengwei Yang, Vasiliy Balyasnyy)
1836
1837 D-Bus 1.7.4 (2013-06-13)
1838 ==
1839
1840 The “but is your thread-safety thread-safe?” release.
1841
1842 Security fixes:
1843
1844 • CVE-2013-2168: Fix misuse of va_list that could be used as a denial
1845   of service for system services. Vulnerability reported by Alexandru Cornea.
1846   (Simon)
1847
1848 Dependencies:
1849
1850 • The Windows version of libdbus now contains a C++ source file, used
1851   to provide global initialization when the library is loaded.
1852   gcc (mingw*) users should ensure that g++ is also installed.
1853
1854 • The libxml2-based configuration reader (which hasn't worked for 2.5 years,
1855   and was never the recommended option) has been removed. Expat is now a
1856   hard dependency.
1857
1858 Enhancements:
1859
1860 • It should now be safe to call dbus_threads_init_default() from any thread,
1861   at any time. Authors of loadable modules and plugins that use libdbus
1862   should consider doing so during initialization.
1863   (fd.o #54972, Simon McVittie)
1864
1865 • Improve dbus-send documentation and command-line parsing (fd.o #65424,
1866   Chengwei Yang)
1867
1868 Unix-specific:
1869   · dbus-run-session: experimental new tool to start a temporary D-Bus
1870     session, e.g. for regression tests or a text console, replacing
1871     certain uses of dbus-launch which weren't really correct
1872     (fd.o #39196, Simon)
1873
1874 Other fixes:
1875
1876 • In dbus-daemon, don't crash if a .service file starts with key=value
1877   (fd.o #60853, Chengwei Yang)
1878
1879 • Unix-specific:
1880   · Fix a crash similar to CVE-2013-2168 the first time we try to use syslog
1881     on a platform not defining LOG_PERROR, such as Solaris or QNX.
1882     This regressed in 1.7.0. (Simon)
1883   · Fix an assertion failure if we try to activate systemd services before
1884     systemd connects to the bus (fd.o #50199, Chengwei Yang)
1885   · Avoid compiler warnings for ignoring the return from write()
1886     (Chengwei Yang)
1887
1888 • Windows-specific:
1889   · Under cmake, install runtime libraries (DLLs) into bin/ instead of lib/
1890     so that Windows finds them (fd.o #59733, Ralf Habacker)
1891
1892 D-Bus 1.7.2 (2013-04-25)
1893 ==
1894
1895 The “only partially opaque” release.
1896
1897 Configuration changes:
1898
1899 • On non-QNX Unix platforms, the default limit on fds per message in the
1900   session bus configuration has reduced from 4096 to 1024. The default
1901   limit used on the system bus was already 1024. On QNX, both limits are
1902   reduced further, to 128.
1903
1904 Enhancements:
1905
1906 • D-Bus Specification 0.21
1907   · Following Unicode Corrigendum #9, the noncharacters U+nFFFE, U+nFFFF,
1908     U+FDD0..U+FDEF are allowed in UTF-8 strings again. (fd.o #63072,
1909     Simon McVittie)
1910
1911 Fixes:
1912
1913 • Diagnose incorrect use of dbus_connection_get_data() with negative slot
1914   (i.e. before allocating the slot) rather than returning junk
1915   (fd.o #63127, Dan Williams)
1916
1917 • Fix a cmake build regression since 1.7.0 (fd.o #63682; Ralf Habacker,
1918   Simon McVittie)
1919
1920 • Unix-specific:
1921   · On Linux, link successfully with glibc 2.17 (fd.o #63166, Simon McVittie)
1922   · Under systemd, log to syslog only, not stderr, avoiding duplication
1923     (fd.o #61399, #39987; Colin Walters, Dagobert Michelsen)
1924   · Under systemd, remove unnecessary dependency on syslog.socket
1925     (fd.o #63531, Cristian Rodríguez)
1926   · Include alloca.h for alloca() if available, fixing compilation on
1927     Solaris 10 (fd.o #63071, Dagobert Michelsen)
1928   · Allow use of systemd-logind without the rest of systemd
1929     (fd.o #62585, Martin Pitt)
1930   · When built with CMake, link to librt and use the right path for
1931     meinproc's XSLT stylesheets (fd.o #61637, Ralf Habacker)
1932   · Reduce the default limit on number of fds per message to 128 under
1933     QNX, working around an arbitrary OS limit (fd.o #61176, Matt Fischer)
1934
1935 • Windows-specific:
1936   · Do not claim that all bus clients have the dbus-daemon's credentials;
1937     pick up local TCPv4 clients' credentials (process ID and security
1938     identifier, i.e. user) using GetExtendedTcpTable() (fd.o #61787,
1939     Ralf Habacker)
1940
1941 D-Bus 1.7.0 (2013-02-22)
1942 ==
1943
1944 The "Disingenuous Assertions" release.
1945
1946 This is a new development release, starting the 1.7.x branch. D-Bus 1.6
1947 remains the recommended version for long-term-supported distributions
1948 or the upcoming GNOME 3.8 release.
1949
1950 Build-time configuration changes:
1951
1952 • The --with-dbus-session-bus-default-address configure option is no longer
1953   supported. Use the new --with-dbus-session-bus-connect-address and
1954   --with-dbus-session-bus-listen-address options instead. On Windows, you
1955   usually want them to have the same argument; on Unix, the defaults are
1956   usually correct.
1957
1958 • Similarly, the DBUS_SESSION_BUS_DEFAULT_ADDRESS CMake variable is no longer
1959   supported; use the new DBUS_SESSION_BUS_LISTEN_ADDRESS and
1960   DBUS_SESSION_BUS_CONNECT_ADDRESS variables instead.
1961
1962 • cmake/cross-compile.sh has been removed. Instead, please use a
1963   cross-toolchain file (-DCMAKE_TOOLCHAIN_FILE) as documented at
1964   <http://www.vtk.org/Wiki/CMake_Cross_Compiling>; or use Autotools
1965   as documented in "info automake Cross-Compilation", and set
1966   PKG_CONFIG_PATH appropriately.
1967
1968 Requirements:
1969
1970 • Man pages now require xmlto (or either xmlto or meinproc, if using CMake).
1971 • man2html is no longer used.
1972
1973 Enhancements:
1974
1975 • D-Bus Specification 0.20
1976   · actually say that /org/freedesktop/DBus is the object that
1977     implements o.fd.DBus (fd.o #51865, Colin Walters)
1978   · various reorganisation for better clarity (fd.o #38252, Simon McVittie)
1979   · stop claiming that all basic types work just like INT32 (strings don't!)
1980
1981 • The "source code" for the man pages is now Docbook XML, eliminating
1982   the outdated duplicate copies used when building with CMake.
1983   (fd.o #59805; Ralf Habacker, Simon McVittie)
1984
1985 Fixes:
1986
1987 • In the activation helper, when compiled for tests, do not reset the system
1988   bus address, fixing the regression tests. (fd.o #52202, Simon)
1989
1990 • Fix building with Valgrind 3.8, at the cost of causing harmless warnings
1991   with Valgrind 3.6 on some compilers (fd.o #55932, Arun Raghavan)
1992
1993 • Merge <servicehelper> from system-local.conf if necessary (fd.o #51560,
1994   Krzysztof Konopko)
1995
1996 • Under CMake, prefer xmlto over meinproc (fd.o #59733, Ralf Habacker)
1997
1998 • Stop duplicating CMake's own logic to find libexpat
1999   (fd.o #59733, Ralf Habacker)
2000
2001 • Don't assume CMake host and build system are the same (fd.o #59733,
2002   Ralf Habacker)
2003
2004 • Avoid deprecation warnings for GLib 2.35 (fd.o #59971, Simon McVittie)
2005
2006 • Unix-specific:
2007   · Check for functions in libpthread correctly, fixing compilation on
2008     (at least) OpenBSD (fd.o #47239, Simon)
2009   · Don't leak temporary fds pointing to /dev/null (fd.o #56927,
2010     Michel HERMIER)
2011   · Update sd-daemon.[ch] from systemd (fd.o #60681)
2012   · Add partial support for QNX (fd.o #60339, fd.o #61176; Matt Fischer)
2013
2014 • Windows-specific:
2015   · The default session bus listening and connecting address is now
2016     "autolaunch:", which makes D-Bus on Windows interoperate with itself
2017     and GDBus "out of the box". Use the configure options and cmake variables
2018     described above if you require a different autolaunch scope.
2019     (fd.o #38201, Simon McVittie)
2020   · Avoid a CMake warning under Cygwin (fd.o #59401, Ralf Habacker)
2021
2022 • Create session.d, system.d directories under CMake (fd.o #41319,
2023   Ralf Habacker)
2024
2025 D-Bus 1.6.8 (2012-09-28)
2026 ==
2027
2028 The "Fix one thing, break another" release.
2029
2030 • Follow up to CVE-2012-3524: The additional hardening
2031   work to use __secure_getenv() as a followup to bug #52202
2032   broke certain configurations of gnome-keyring.  Given
2033   the difficulty of making this work without extensive
2034   changes to gnome-keyring, use of __secure_getenv() is
2035   deferred.
2036
2037 D-Bus 1.6.6 (2012-09-28)
2038 ==
2039
2040 The "Clear the environment in your setuid binaries, please" release.
2041
2042 • CVE-2012-3524: Don't access environment variables (fd.o #52202)
2043   Thanks to work and input from Colin Walters, Simon McVittie,
2044   Geoffrey Thomas, and others.
2045 • Unix-specific:
2046   · Fix compilation on Solaris (fd.o #53286, Jonathan Perkin)
2047   · Work around interdependent headers on OpenBSD by including sys/types.h
2048     before each use of sys/socket.h (fd.o #54418, Brad Smith)
2049
2050 D-Bus 1.6.4 (2012-07-18)
2051 ==
2052
2053 • Detect that users are "at the console" correctly when configured with
2054   a non-default path such as --enable-console-auth-dir=/run/console
2055   (fd.o #51521, Dave Reisner)
2056
2057 • Remove an incorrect assertion from DBusTransport (fd.o #51657,
2058   Simon McVittie)
2059
2060 • Make --enable-developer default to "no" (regression in 1.6.2;
2061   fd.o #51657, Simon McVittie)
2062
2063 • Windows-specific:
2064   · Launch dbus-daemon correctly if its path contains a space
2065     (fd.o #49450, Wolfgang Baron)
2066
2067 D-Bus 1.6.2 (2012-06-27)
2068 ==
2069
2070 The "Ice Cabbage" release.
2071
2072 • Change how we create /var/lib/dbus so it works under Automake >= 1.11.4
2073   (fd.o #51406, Simon McVittie)
2074
2075 • Don't return from dbus_pending_call_set_notify with a lock held on OOM
2076   (fd.o #51032, Simon McVittie)
2077
2078 • Disconnect "developer mode" (assertions, verbose mode etc.) from
2079   Automake maintainer mode. D-Bus developers should now configure with
2080   --enable-developer. Automake maintainer mode is now on by default;
2081   distributions can disable it with --disable-maintainer-mode.
2082   (fd.o #34671, Simon McVittie)
2083
2084 • Automatically define DBUS_STATIC_BUILD in static-only Autotools builds,
2085   fixing linking when targeting Windows (fd.o #33973; william, Simon McVittie)
2086
2087 • Unix-specific:
2088   · Check for libpthread under CMake on Unix (fd.o #47237, Simon McVittie)
2089
2090 D-Bus 1.6.0 (2012-06-05)
2091 ==
2092
2093 The “soul of this machine has improved” release.
2094
2095 This version starts a new stable branch of D-Bus: only bug fixes will
2096 be accepted into 1.6.x. Other changes will now go to the 1.7.x branch.
2097
2098 Summary of changes since 1.4.x:
2099
2100 • New requirements
2101   · PTHREAD_MUTEX_RECURSIVE on Unix
2102   · compiler support for 64-bit integers (int64_t or equivalent)
2103
2104 • D-Bus Specification v0.19
2105
2106 • New dbus-daemon features
2107   · <allow own_prefix="com.example.Service"/> rules allow the service to
2108     own names like com.example.Service.Instance3
2109   · optional systemd integration when checking at_console policies
2110   · --nopidfile option, mainly for use by systemd
2111   · path_namespace and arg0namespace may appear in match rules
2112   · eavesdropping is disabled unless the match rule contains eavesdrop=true
2113
2114 • New public API
2115   · functions to validate various string types (dbus_validate_path() etc.)
2116   · dbus_type_is_valid()
2117   · DBusBasicValue, a union of every basic type
2118
2119 • Bug fixes
2120   · removed an unsafe reimplementation of recursive mutexes
2121   · dbus-daemon no longer busy-loops if it has far too many file descriptors
2122   · dbus-daemon.exe --print-address works on Windows
2123   · all the other bug fixes from 1.4.20
2124
2125 • Other major implementation changes
2126   · on Linux, dbus-daemon uses epoll if supported, for better scalability
2127   · dbus_threads_init() ignores its argument and behaves like
2128     dbus_threads_init_default() instead
2129   · removed the per-connection link cache, improving dbus-daemon performance
2130
2131 • Developer features
2132   · optional Valgrind instrumentation (--with-valgrind)
2133   · optional Stats interface on the dbus-daemon (--enable-stats)
2134   · optionally abort whenever malloc() fails (--enable-embedded-tests
2135     and export DBUS_MALLOC_CANNOT_FAIL=1)
2136
2137 Changes since 1.5.12:
2138
2139 • Be more careful about monotonic time vs. real time, fixing DBUS_COOKIE_SHA1
2140   spec-compliance (fd.o #48580, David Zeuthen)
2141
2142 • Don't use install(1) within the source/build trees, fixing the build as
2143   non-root when using OpenBSD install(1) (fd.o #48217, Antoine Jacoutot)
2144
2145 • Add missing commas in some tcp and nonce-tcp addresses, and remove
2146   an unused duplicate copy of the nonce-tcp transport in Windows builds
2147   (fd.o #45896, Simon McVittie)
2148
2149 D-Bus 1.5.12 (2012-03-27)
2150 ==
2151
2152 The “Big Book of Science” release.
2153
2154 • Add public API to validate various string types:
2155   dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
2156   dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
2157   (fd.o #39549, Simon McVittie)
2158
2159 • Turn DBusBasicValue into public API so bindings don't need to invent their
2160   own "union of everything" type (fd.o #11191, Simon McVittie)
2161
2162 • Enumerate data files included in the build rather than using find(1)
2163   (fd.o #33840, Simon McVittie)
2164
2165 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
2166   in dbus-daemon (fd.o #46273, Alban Crequy)
2167
2168 • Windows-specific:
2169   · make dbus-daemon.exe --print-address (and --print-pid) work again
2170     on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
2171   · fix duplicate case value when compiling against mingw-w64
2172     (fd.o #47321, Andoni Morales Alastruey)
2173
2174 D-Bus 1.5.10 (2012-02-21)
2175 ==
2176
2177 The "fire in Delerium" release.
2178
2179 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
2180 and SUSv2) is now required.
2181
2182 • D-Bus Specification 0.19:
2183   · Formally define unique connection names and well-known bus names,
2184     and document best practices for interface, bus, member and error names,
2185     and object paths (fd.o #37095, Simon McVittie)
2186   · Document the search path for session and system services on Unix, and
2187     where they should be installed by build systems (fd.o #21620, fd.o #35306;
2188     Simon McVittie)
2189   · Document the systemd transport (fd.o #35232, Lennart Poettering)
2190
2191 • Make dbus_threads_init() use the same built-in threading implementation
2192   as dbus_threads_init_default(); the user-specified primitives that it
2193   takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
2194
2195 • Allow all configured auth mechanisms, not just one (fd.o #45106,
2196   Pavel Strashkin)
2197
2198 • Improve cmake build system (Ralf Habacker):
2199   · simplify XML parser dependencies (fd.o #41027)
2200   · generate build timestamp (fd.o #41029)
2201   · only create batch files on Windows
2202   · fix option and cache syntax
2203   · add help-options target
2204   · share dbus-arch-deps.h.in with autotools rather than having our
2205     own version (fd.o #41033)
2206
2207 • Build tests successfully with older GLib, as found in e.g. Debian 6
2208   (fd.o #41219, Simon McVittie)
2209
2210 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
2211
2212 • Build documentation correctly if man2html doesn't support filenames on
2213   its command-line (fd.o #43875, Jack Nagel)
2214
2215 • Improve test coverage. To get even more coverage, run the tests with
2216   DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
2217
2218 • Reduce the size of the shared library by moving functionality only used
2219   by dbus-daemon, tests etc. into their internal library and deleting
2220   unused code (fd.o #34976, #39759; Simon McVittie)
2221
2222 • Add dbus-daemon --nopidfile option, overriding the configuration, for
2223   setups where the default configuration must include <pidfile/> to avoid
2224   breaking traditional init, but the pid file is in fact unnecessary; use
2225   it under systemd to improve startup time a bit (fd.o #45520,
2226   Lennart Poettering)
2227
2228 • Optionally (if configured --with-valgrind) add instrumentation to debug
2229   libdbus and associated tools more meaningfully under Valgrind
2230   (fd.o #37286, Simon McVittie)
2231
2232 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
2233
2234 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
2235
2236 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
2237   abort on failure to malloc() (like GLib does), to turn runaway memory leaks
2238   into a debuggable core-dump if a resource limit is applied (fd.o #41048,
2239   Simon McVittie)
2240
2241 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
2242   Simon McVittie)
2243
2244 • Unix-specific:
2245   · Replace our broken reimplementation of recursive mutexes, which has
2246     been broken since 2006, with an ordinary pthreads recursive mutex
2247     (fd.o #43744; Sigmund Augdal, Simon McVittie)
2248   · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
2249     welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
2250     event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
2251   · When running under systemd, use it instead of ConsoleKit to check
2252     whether to apply at_console policies (fd.o #39609, Lennart Poettering)
2253   · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
2254   · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
2255   · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
2256     (fd.o #41218, Simon McVittie)
2257   · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
2258     helper doesn't obey environment variables to avoid privilege escalation
2259     attacks, so make the system bus follow the same rules
2260     (fd.o #21620, Simon McVittie)
2261
2262 • Windows-specific:
2263   · Find the dbus-daemon executable next to the shared library (fd.o #41558;
2264     Jesper Dam, Ralf Habacker)
2265   · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
2266     Simon McVittie)
2267
2268 D-Bus 1.5.8 (2011-09-21)
2269 ==
2270
2271 The "cross-metering" release.
2272
2273 In addition to dead code removal and refactoring, this release contains all
2274 of the bugfixes from 1.4.16.
2275
2276 • Clean up dead code, and make more warnings fatal in development builds
2277   (fd.o #39231, fd.o #41012; Simon McVittie)
2278
2279 • If full test coverage is requested via --enable-tests, strictly require
2280   Python, pygobject and dbus-python, which are required by some tests; if not,
2281   and Python is missing, skip those tests rather than failing
2282   (fd.o #37847, Simon McVittie)
2283
2284 • When using cmake, provide the same version-info API in the installed headers
2285   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
2286
2287 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
2288
2289 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
2290
2291 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
2292   Simon McVittie)
2293
2294 • Fix duplicates in authors list (Ralf Habacker)
2295
2296 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
2297   (fd.o #39879, Chris Mayo)
2298
2299 • Fix a small memory leak, and a failure to report errors, when updating
2300   a service file entry for activation (fd.o #39230, Simon McVittie)
2301
2302 • Unix-specific:
2303   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
2304     Brian Cameron, Simon McVittie)
2305   · On systems that use libcap-ng but not systemd, drop supplemental groups
2306     when switching to the daemon user (Red Hat #726953, Steve Grubb)
2307   · Make the cmake build work again on GNU platforms (fd.o #29228,
2308     Simon McVittie)
2309   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
2310     like Solaris (fd.o #40313, Dagobert Michelsen)
2311   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
2312     (fd.o #40235, Simon McVittie)
2313   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
2314     (fd.o #39987, Simon McVittie)
2315   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
2316     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
2317
2318 • Windows-specific:
2319   · Fix compilation on MSVC, which doesn't understand "inline" with its
2320     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
2321   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
2322   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
2323
2324 D-Bus 1.5.6 (2011-07-29)
2325 ==
2326
2327 The "weird, gravy-like aftertaste" release.
2328
2329 In addition to new features and refactoring, this release contains all of the
2330 bugfixes from 1.4.14.
2331
2332 Potentially incompatible (Bustle and similar debugging tools will need
2333 changes to work as intended):
2334
2335 • Do not allow match rules to "eavesdrop" (receive messages intended for a
2336   different recipient) by mistake: eavesdroppers must now opt-in to this
2337   behaviour by putting "eavesdrop='true'" in the match rule, which will
2338   not have any practical effect on buses where eavesdropping is not allowed
2339   (fd.o #37890, Cosimo Alfarano)
2340
2341 Other changes:
2342
2343 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
2344   Cosimo Alfarano, Simon McVittie)
2345   · add the "eavesdrop" keyword to match rules
2346   · define eavesdropping, unicast messages and broadcast messages
2347   · stop claiming that match rules are needed to match unicast messages to you
2348   · promote the type system to be a top-level section
2349
2350 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
2351   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
2352   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
2353
2354 • Consistently use atomic operations on everything that is ever manipulated
2355   via atomic ops, as was done for changes to DBusConnection's refcount in
2356   1.4.12 (fd.o #38005, Simon McVittie)
2357
2358 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
2359   Simon McVittie)
2360
2361 • Make "make check" in a clean tree work, by not running tests until
2362   test data has been set up (fd.o #34405, Simon McVittie)
2363
2364 • The dbus-daemon no longer busy-loops if it has a very large number of file
2365   descriptors (fd.o #23194, Simon McVittie)
2366
2367 • Refactor message flow through dispatching to avoid locking violations if
2368   the bus daemon's message limit is hit; remove the per-connection link cache,
2369   which was meant to improve performance, but now reduces it (fd.o #34393,
2370   Simon McVittie)
2371
2372 • Some cmake fixes (Ralf Habacker)
2373
2374 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
2375   Simon McVittie, Lennart Poettering)
2376
2377 • Stop storing two extra byte order indicators in each D-Bus message
2378   (fd.o #38287, Simon McVittie)
2379
2380 • Add an optional Stats interface which can be used to get statistics from
2381   a running dbus-daemon if enabled at configure time with --enable-stats
2382   (fd.o #34040, Simon McVittie)
2383
2384 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
2385
2386 • Documentation (fd.o #36156, Simon McVittie):
2387   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
2388   · install more documentation automatically, including man2html output
2389   · put dbus.devhelp in the right place (it must go in ${htmldir})
2390
2391 • Unix-specific:
2392   · look for system services in /lib/dbus-1/system-services in addition to all
2393     the other well-known locations; note that this should always be /lib,
2394     even on platforms where shared libraries on the root FS would go in /lib64,
2395     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
2396   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
2397
2398 • Windows-specific (Ralf Habacker):
2399   · fix use of a mutex for autolaunch server detection
2400   · don't crash on malloc failure in _dbus_printf_string_upper_bound
2401
2402 D-Bus 1.5.4 (2011-06-10)
2403 ==
2404
2405 Security (local denial of service):
2406
2407 • Byte-swap foreign-endian messages correctly, preventing a long-standing
2408   local DoS if foreign-endian messages are relayed through the dbus-daemon
2409   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
2410   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
2411
2412 New things:
2413
2414 • The constant to use for an infinite timeout now has a name,
2415   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
2416   which can be used for source compatibility with older versions of libdbus.
2417
2418 • If GLib and DBus-GLib are already installed, more tests will be built,
2419   providing better coverage. The new tests can also be installed via
2420       ./configure --enable-installed-tests
2421   for system integration testing, if required. (fd.o #34570, Simon McVittie)
2422
2423 Changes:
2424
2425 • Consistently use atomic operations for the DBusConnection's refcount,
2426   fixing potential threading problems (fd.o #38005, Simon McVittie)
2427
2428 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
2429   small (300KiB on x86-64) and it frequently doesn't work in unusual
2430   toolchains. To optimize for minimum installed size, you should benchmark
2431   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
2432   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
2433
2434 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
2435   (fd.o #35880, Timothy Redaelli)
2436
2437 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
2438   when not using a DESTDIR (fd.o #37870, Simon McVittie)
2439
2440 • Windows-specific changes:
2441   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
2442
2443 D-Bus 1.5.2 (2011-06-01)
2444 ==
2445
2446 The "Boar Hunter" release.
2447
2448 Notes for distributors:
2449
2450   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
2451   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
2452   toolchain supports it reliably, via something like:
2453
2454     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
2455
2456   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
2457
2458 Changes:
2459
2460   • D-Bus Specification v0.17
2461     · Reserve the extra characters used in signatures by GVariant
2462       (fd.o #34529, Simon McVittie)
2463     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
2464   • Don't force -fPIE: distributions and libtool know better than we do whether
2465     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
2466   • Allow --disable-gc-sections, in case your toolchain offers the
2467     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
2468     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
2469   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
2470     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
2471   • Ensure that maintainers upload documentation with the right permissions
2472     (fd.o #36130, Simon McVittie)
2473   • Don't force users of libdbus to be linked against -lpthread, -lrt
2474     (fd.o #32827, Simon McVittie)
2475   • Log system-bus activation information to syslog (fd.o #35705,
2476     Colin Walters)
2477   • Log messages dropped due to quotas to syslog (fd.o #35358,
2478     Simon McVittie)
2479   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
2480   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
2481     (fd.o #35228, Lennart Poettering)
2482   • In the regression tests, don't report fds as "leaked" if they were open
2483     on startup (fd.o #35173, Simon McVittie)
2484   • Make dbus-monitor bail out if asked to monitor more than one bus,
2485     rather than silently using the last one (fd.o #26548, Will Thompson)
2486   • Clarify documentation (fd.o #35182, Simon McVittie)
2487   • Clean up minor dead code and some incorrect error handling
2488     (fd.o #33128, fd.o #29881; Simon McVittie)
2489   • Check that compiler options are supported before using them (fd.o #19681,
2490     Simon McVittie)
2491   • Windows:
2492     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
2493
2494 D-Bus 1.5.0 (2011-04-11)
2495 ==
2496
2497 The "you never know when you need to tow something from your giant
2498 flying shark" release.
2499
2500   • D-Bus Specification v0.16
2501     · Add support for path_namespace and arg0namespace in match rules
2502       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
2503     · Make argNpath support object paths, not just object-path-like strings,
2504       and document it better (fd.o #31818, Will Thompson)
2505   • Let the bus daemon implement more than one interface (fd.o #33757,
2506     Simon McVittie)
2507   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
2508     Roberto Guido)
2509   • Require user intervention to compile with missing 64-bit support
2510     (fd.o #35114, Simon McVittie)
2511   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
2512   • Raise UnknownObject instead of UnknownMethod for calls to methods on
2513     paths that are not part of the object tree, and UnknownInterface for calls
2514     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
2515
2516 D-Bus 1.4.8 (2011-04-08)
2517 ==
2518
2519 The "It's like the beginning of a lobster" release.
2520
2521   • Rename configure.in to configure.ac, and update it to modern conventions
2522     (fd.o #32245; Javier Jardón, Simon McVittie)
2523   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
2524     Anders Kaseorg)
2525   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
2526     --disable-x11-autolaunch configure option to prevent it altogether
2527     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
2528   • Install the documentation, and an index for Devhelp (fd.o #13495,
2529     Debian #454142; Simon McVittie, Matthias Clasen)
2530   • If checks are not disabled, check validity of string-like types and
2531     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
2532   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
2533     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
2534   • Break up a huge conditional in config-parser so gcov can produce coverage
2535     data (fd.o #10887, Simon McVittie)
2536   • List which parts of the Desktop Entry specification are applicable to
2537     .service files (fd.o #19159, Sven Herzberg)
2538   • Don't suppress service activation if two services have the same Exec=
2539     (fd.o #35750, Colin Walters)
2540   • Windows:
2541     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
2542       (Andre Heinecke)
2543     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
2544       (fd.o #32805, Mark Brand)
2545
2546 D-Bus 1.4.6 (2010-02-17)
2547 ==
2548
2549 The "1, 2, miss a few, 99, 100" release.
2550
2551   • Remove unfinished changes intended to support GTest-based tests,
2552     which were mistakenly included in 1.4.4
2553
2554 D-Bus 1.4.4 (2010-02-17)
2555 ==
2556
2557   • Switch back to using even micro versions for stable releases; 1.4.1
2558     should have been called 1.4.2, so skip that version number
2559   • Don't leave bad file descriptors being watched when spawning processes,
2560     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
2561     also LP#656134, LP#680444, LP#713157)
2562   • Check for MSG_NOSIGNAL correctly
2563   • Fix failure to detect abstract socket support (fd.o #29895)
2564   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
2565     (fd.o #32262, NB#180486)
2566   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
2567     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
2568   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
2569   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
2570   • Improve gcc malloc annotations (fd.o #32710)
2571   • If the system bus is launched via systemd, protect it from the OOM killer
2572   • Documentation improvements (fd.o #11190)
2573   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
2574     fd.o #15922, LP#241619)
2575   • Cope with invalid files in session.d, system.d (fd.o #19186,
2576     Debian #230231)
2577   • Don't distribute generated files that embed our builddir (fd.o #30285,
2578     fd.o #34292)
2579   • Raise the system bus's fd limit to be sufficient for its configuration
2580     (fd.o #33474, LP#381063)
2581   • Fix syslog string processing
2582   • Ignore -Waddress
2583   • Remove broken gcov parsing code and --enable-gcov, and replace them
2584     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
2585   • Windows:
2586     · avoid live-lock in Windows CE due to unfair condition variables
2587   • OpenBSD:
2588     · support credentials-passing (fd.o #32542)
2589   • Solaris:
2590     · opt-in to thread safety (fd.o #33464)
2591
2592 D-Bus 1.4.1 (20 December 2010)
2593 ==
2594
2595  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
2596    crash the bus. The existing restriction to 64-levels of nesting previously
2597    only applied to the static type signature; now it also applies to dynamic
2598    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
2599    issue.
2600  • OS X portability fixes, including launchd support.
2601  • Windows autolaunch improvements.
2602  • Various bug fixes.
2603
2604 D-Bus 1.4.0 (6 Sep 2010)
2605 ==
2606  - systemd hookup
2607
2608 D-Bus 1.3.1 (23 June 2010)
2609 ==
2610  - New standardized PropertiesChanged signal in the properties interface
2611  - Various portability fixes, in particular to Windows platforms
2612  - Support forking bus services, for compatibility
2613
2614 D-Bus 1.3.0 (29 July 2009)
2615 ==
2616  - ability for dbus-send to send to any bus (--address)
2617  - file descriptor passing on Unix socket transports
2618  - use of GCC atomic intrinsics for better processor support
2619    (requires -march=i486 or above for x86 compilation)
2620  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
2621    and glibc (2.9 for pipe2 and 2.10 for accept4)
2622  - feature negotiation in the bus daemon