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