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