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