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