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