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