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