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