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