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