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