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