NEWS
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.9.14 (UNRELEASED)
2 ==
3
4 Dependencies:
5
6 • dbus-daemon and dbus-daemon-launch-helper now require libdbus. They
7   were previously linked to a static version of libdbus.
8
9 • The tests no longer require dbus-glib in order to exercise the libdbus
10   shared library; they are always linked to libdbus now.
11
12 Build-time configuration:
13
14 • The new --enable-user-session option, off by default, can be enabled
15   by OS integrators intending to use systemd to provide a session bus
16   per user (in effect, treating all concurrent graphical and non-graphical
17   login sessions as one large session)
18
19 Enhancements:
20
21 • All executables are now linked dynamically to libdbus.
22   (fd.o #83115; Bertrand SIMONNET, Simon McVittie, Ralf Habacker)
23
24 • On platforms that support them (GNU libc and possibly others),
25   libdbus now has versioned symbols for its public API.
26   All public symbols (visible in the header files) are currently
27   versioned as LIBDBUS_1_3; private symbols starting with _dbus or
28   dbus_internal have a version that changes with each release, and
29   must not be used by applications. (also fd.o #83115)
30
31 • New listenable address mode "unix:runtime=yes" which listens on
32   a real filesystem (non-abstract) socket $XDG_RUNTIME_DIR/bus
33   (fd.o #61303; Colin Walters, Alexander Larsson, Simon McVittie)
34
35 • Add optional systemd units for a per-user bus listening on
36   $XDG_RUNTIME_DIR/bus (fd.o #61301; Simon McVittie, Colin Walters)
37
38 • On Unix platforms, both libdbus and "dbus-launch --autolaunch"
39   default to connecting to $XDG_RUNTIME_DIR/bus if it is a socket
40   (also fd.o #61301)
41
42 • New dbus-update-activation-environment tool uploads environment
43   variables to "dbus-daemon --session" and optionally "systemd --user",
44   primarily as a way to keep the per-user bus compatible with
45   distributions' existing X11 login scripts (also fd.o #61301)
46
47 • Add microsecond-resolution timestamps to the default output of
48   dbus-monitor and dbus-send (fd.o #88896; Ralf Habacker, Simon McVittie)
49
50 Fixes:
51
52 • Fix a race condition in the 'monitor' test introduced in 1.9.10
53   (fd.o #89222, Simon McVittie)
54
55 D-Bus 1.9.12 (2015-02-19)
56 ==
57
58 The “monster lasagna” release.
59
60 Dependencies:
61
62 • Ducktype and yelp-tools are now required to build complete documentation
63   (they are optional for normal builds).
64
65 Enhancements:
66
67 • D-Bus Specification version 0.26
68   · GetConnectionCredentials can return LinuxSecurityLabel or WindowsSID
69   · document the BecomeMonitor method
70
71 • On Linux, add LinuxSecurityLabel to GetConnectionCredentials
72   (fd.o #89041; Tyler Hicks, Simon McVittie)
73
74 • On Linux, add support for AppArmor mediation of message sending and
75   receiving and name ownership (paralleling existing SELinux mediation
76   support), and eavesdropping (a new check, currently AppArmor-specific)
77   (fd.o #75113; John Johansen, Tyler Hicks, Simon McVittie)
78
79 • In dbus-send and dbus-monitor, pretty-print \0-terminated bytestrings
80   that have printable ASCII contents; we previously only did this for
81   unterminated bytestrings (fd.o #89109, Simon McVittie)
82
83 • Add a guide to designing good D-Bus APIs (fd.o #88994, Philip Withnall)
84
85 • On Windows, add WindowsSID to GetConnectionCredentials
86   (fd.o #54445, Ralf Habacker)
87
88 • Improve clarity of dbus-monitor --profile output and add more columns
89   (fd.o #89165, Ralf Habacker)
90
91 • Add a man page for dbus-test-tool, and build it under CMake as well
92   as Autotools (fd.o#89086, Simon McVittie)
93
94 • If dbus-daemon was compiled with --enable-verbose, add a D-Bus API
95   to control it at runtime, overriding the DBUS_VERBOSE environment variable
96   (fd.o #88896, Ralf Habacker)
97
98 Fixes:
99
100 • Reduce the number of file descriptors used in the fd-passing test,
101   avoiding failure under the default Linux fd limit, and automatically
102   skip it if the rlimit is too small (fd.o #88998, Simon McVittie)
103
104 D-Bus 1.9.10 (2015-02-09)
105 ==
106
107 The “sad cyborgs” release.
108
109 Security fixes merged from 1.8.16:
110
111 • Do not allow non-uid-0 processes to send forged ActivationFailure
112   messages. On Linux systems with systemd activation, this would
113   allow a local denial of service: unprivileged processes could
114   flood the bus with these forged messages, winning the race with
115   the actual service activation and causing an error reply
116   to be sent back when service auto-activation was requested.
117   This does not prevent the real service from being started,
118   so the attack only works while the real service is not running.
119   (CVE-2015-0245, fd.o #88811; Simon McVittie)
120
121 Enhancements:
122
123 • The new Monitoring interface in the dbus-daemon lets dbus-monitor and
124   similar tools receive messages without altering the security properties
125   of the system bus, by calling the new BecomeMonitor method on a
126   private connection. This bypasses the normal <allow> and <deny> rules
127   entirely, so to preserve normal message-privacy assumptions, only root
128   is allowed to do this on the system bus. Restricted environments,
129   such as Linux with LSMs, should lock down access to the Monitoring
130   interface. (fd.o #46787, Simon McVittie)
131
132 • dbus-monitor uses BecomeMonitor to capture more traffic, if the
133   dbus-daemon supports it and access permissions allow it.
134   It still supports the previous approach ("eavesdropping" match rules)
135   for compatibility with older bus daemons. (fd.o #46787, Simon)
136
137 • dbus-monitor can now log the message stream as binary data for later
138   analysis, with either no extra framing beyond the normal D-Bus headers,
139   or libpcap-compatible framing treating each D-Bus message
140   as a captured packet. (fd.o #46787, Simon)
141
142 Other fixes:
143
144 • Fix some CMake build regressions (fd.o #88964, Ralf Habacker)
145
146 • On Unix, forcibly terminate regression tests after 60 seconds to
147   prevent them from blocking continuous integration frameworks
148   (fd.o #46787, Simon)
149
150 D-Bus 1.9.8 (2015-02-03)
151 ==
152
153 The “all the types of precipitation” release.
154
155 Dependencies:
156
157 • full test coverage now requires GLib 2.36
158 • full test coverage now requires PyGI (PyGObject 3,
159   "import gi.repository.GObject") instead of the
160   obsolete PyGObject 2 ("import gobject")
161
162 Enhancements:
163
164 • add GLib-style "installed tests" (fd.o #88810, Simon McVittie)
165
166 • better regression test coverage, including systemd activation
167   (fd.o #57952, #88810; Simon McVittie)
168
169 Fixes:
170
171 • fatal errors correctly make the dbus-daemon exit even if <syslog/> is
172   turned off (fd.o #88808, Simon McVittie)
173
174 • TCP sockets on Windows no longer fail to listen approximately 1 time
175   in 256, caused by a logic error that should have always made it fail but
176   was mitigated by incorrect endianness for the port number
177   (fd.o #87999, Ralf Habacker)
178
179 • fix some Windows build failures (fd.o #88009, #88010; Ralf Habacker)
180
181 • on Windows, allow up to 8K connections to the dbus-daemon instead of the
182   previous 64, completing a previous fix which only worked under
183   Autotools (fd.o #71297, Ralf Habacker)
184
185 • on Windows, if the IP family is unspecified only use IPv4,
186   to mitigate IPv6 not working correctly (fd.o #87999, Ralf Habacker)
187
188 • fix some unlikely memory leaks on OOM (fd.o #88087, Simon McVittie)
189
190 • lcov code coverage analysis works again (fd.o #88808, Simon McVittie)
191
192 • fix an unused function error with --disable-embedded-tests (fd.o #87837,
193   Thiago Macieira)
194
195 D-Bus 1.9.6 (2015-01-05)
196 ==
197
198 The “I do have a bread knife” release.
199
200 Security hardening:
201
202 • Do not allow calls to UpdateActivationEnvironment from uids other than
203   the uid of the dbus-daemon. If a system service installs unsafe
204   security policy rules that allow arbitrary method calls
205   (such as CVE-2014-8148) then this prevents memory consumption and
206   possible privilege escalation via UpdateActivationEnvironment.
207
208   We believe that in practice, privilege escalation here is avoided
209   by dbus-daemon-launch-helper sanitizing its environment; but
210   it seems better to be safe.
211
212 • Do not allow calls to UpdateActivationEnvironment or the Stats interface
213   on object paths other than /org/freedesktop/DBus. Some system services
214   install unsafe security policy rules that allow arbitrary method calls
215   to any destination, method and interface with a specified object path;
216   while less bad than allowing arbitrary method calls, these security
217   policies are still harmful, since dbus-daemon normally offers the
218   same API on all object paths and other system services might behave
219   similarly.
220
221 Other fixes:
222
223 • Add missing initialization so GetExtendedTcpTable doesn't crash on
224   Windows Vista SP0 (fd.o #77008, Илья А. Ткаченко)
225
226 D-Bus 1.9.4 (2014-11-24)
227 ==
228
229 The “extra-sturdy caramel” release.
230
231 Fixes:
232
233 • Partially revert the CVE-2014-3639 patch by increasing the default
234   authentication timeout on the system bus from 5 seconds back to 30
235   seconds, since this has been reported to cause boot regressions for
236   some users, mostly with parallel boot (systemd) on slower hardware.
237
238   On fast systems where local users are considered particularly hostile,
239   administrators can return to the 5 second timeout (or any other value
240   in milliseconds) by saving this as /etc/dbus-1/system-local.conf:
241
242   <busconfig>
243     <limit name="auth_timeout">5000</limit>
244   </busconfig>
245
246   (fd.o #86431, Simon McVittie)
247
248 • Add a message in syslog/the Journal when the auth_timeout is exceeded
249   (fd.o #86431, Simon McVittie)
250
251 • Send back an AccessDenied error if the addressed recipient is not allowed
252   to receive a message (and in builds with assertions enabled, don't
253   assert under the same conditions). (fd.o #86194, Jacek Bukarewicz)
254
255 D-Bus 1.9.2 (2014-11-10)
256 ==
257
258 The “structurally unsound flapjack” release.
259
260 Security fixes:
261
262 • Increase dbus-daemon's RLIMIT_NOFILE rlimit to 65536
263   so that CVE-2014-3636 part A cannot exhaust the system bus'
264   file descriptors, completing the incomplete fix in 1.8.8.
265   (CVE-2014-7824, fd.o #85105; Simon McVittie, Alban Crequy)
266
267 Enhancements:
268
269 • D-Bus Specification version 0.25
270   · new value 'const' for EmitsChangedSignal annotation
271     (fd.o #72958, Lennart Poettering)
272   · new ALLOW_INTERACTIVE_AUTHORIZATION flag, for PolicyKit and similar
273     (fd.o #83449; Lennart Poettering, Simon McVittie)
274   · annotate table of types with reserved/basic/container, and for
275     basic types, fixed/string-like
276   · clarify arbitrary limits by quoting them in mebibytes
277
278 • New API: add accessors for the ALLOW_INTERACTIVE_AUTHORIZATION flag
279   (fd.o #83449, Simon McVittie)
280
281 • Add dbus-test-tool, a D-Bus swiss army knife with multiple subcommands,
282   useful for debugging and performance testing:
283   · dbus-test-tool spam: send repeated messages
284   · dbus-test-tool echo: send an empty reply for all method calls
285   · dbus-test-tool black-hole: do not reply to method calls
286   (fd.o #34140; Alban Crequy, Simon McVittie, Will Thompson)
287
288 • Add support for process ID in credentials-passing on NetBSD
289   (fd.o #69702, Patrick Welche)
290
291 • Add an example script to find potentially undesired match rules
292   (fd.o #84598, Alban Crequy)
293
294 • Document the central assumption that makes our use of credentials-passing
295   secure (fd.o #83499, Simon McVittie)
296
297 • Replace the dbus-glib section of the tutorial with a GDBus recommendation,
298   and add some links to GDBus and QtDBus documentation (fd.o #25140,
299   Simon McVittie)
300
301 Fixes:
302
303 • Use a less confusing NoReply message when disconnected with a reply pending
304   (fd.o #76112, Simon McVittie)
305
306 • Make the .pc file relocatable by letting pkg-config do all variable
307   expansion itself (fd.o #75858, Руслан Ижбулатов)
308
309 • Fix a build failure on platforms with kqueue, which regressed in 1.9.0
310   (fd.o #85563, Patrick Welche)
311
312 • Consistently save errno after socket calls (fd.o #83625, Simon McVittie)
313
314 • In dbus-spawn, when the grandchild process exits due to a failed exec(),
315   do not lose the exec() errno (fd.o #24821, Simon McVittie)
316
317 • Do not fail the tests if a parent process has leaked non-close-on-exec
318   file descriptors to us (fd.o #73689, fd.o #83899; Simon McVittie)
319
320 • Do not fail the tests on Unix platforms with incomplete
321   credentials-passing support, but do fail if we can't pass credentials
322   on a platform where it is known to work: Linux, FreeBSD, OpenBSD, NetBSD
323   (fd.o #69702, Simon McVittie)
324
325 • Detect accept4, dirfd, inotify_init1, pipe2, and Unix fd passing
326   when building with cmake, and expand test coverage there
327   (fd.o #73689; Ralf Habacker, Simon McVittie)
328
329 D-Bus 1.9.0 (2014-10-01)
330 ==
331
332 The “tiered cheeses” release.
333
334 Requirements:
335
336 • Support for the systemd: (LISTEN_FDS) pseudo-transport on Linux now
337   requires either the libsystemd or libsd-daemon shared library, dropping the
338   embedded convenience copy of sd-daemon (fd.o #71818, Simon)
339
340 Build-time configuration changes:
341
342 • The Stats interface is now enabled by default, and locked-down to
343   root-only on the system bus. Configure with --disable-stats
344   to disable it altogether on memory- or disk-constrained systems,
345   or see ${docdir}/examples/ to open it up to non-root users on the
346   system bus or restrict access on the session bus.
347   (fd.o #80759; Simon McVittie, Alban Crequy)
348
349 • The CMake build system now builds the same shared library name as Autotools
350   on at least Linux and Windows:
351   - on Linux (and perhaps other Unix platforms), it previously built
352     libdbus-1.so, but now builds libdbus-1.so.3.* with development
353     symlink libdbus-1.so and SONAME/symlink libdbus-1.so.3
354   - on Windows, it previously built either libdbus-1.dll (release) or
355     libdbus-1d.dll (debug), but now builds libdbus-1-3.dll, copied to
356     libdbus-1.dll for compatibility with older applications.
357   (fd.o #74117, Ralf Habacker)
358
359 Enhancements:
360
361 • D-Bus Specification version 0.24
362   · document how to quote match rules (fd.o #24307, Simon McVittie)
363   · explicitly say that most message types never expect a reply
364     regardles of whether they have NO_REPLY_EXPECTED
365     (fd.o #75749, Simon McVittie)
366
367 • on Unix platforms, disable Nagle's algorithm on TCP connections to improve
368   initial latency (fd.o #75544, Matt Hoosier)
369
370 • use backtrace() if it is in -lexecinfo instead of libc, as on NetBSD
371   (fd.o #69702, Patrick Welche)
372
373 • in dbus-monitor, print more information about file descriptors
374   (fd.o #80603, Alban Crequy)
375
376 • do not install system bus configuration if built for Windows
377   (fd.o #83583; Ralf Habacker, Simon McVittie)
378
379 • Add GetAllMatchRules to the Stats interface (fd.o #24307, Alban Crequy)
380
381 • Add a regression test for file descriptor passing (fd.o #83622,
382   Simon McVittie)
383
384 Fixes:
385
386 • fix an incorrect error message if a Unix socket path is too long
387   (fd.o #73887, Antoine Jacoutot)
388
389 • in an MSYS/Cygwin environment, pass Unix-style filenames to xmlto,
390   fixing documentation generation (fd.o #75860, Руслан Ижбулатов)
391
392 • in Unix with X11, avoid giving dbus-launch a misleading argv[0]
393   in ps(1) (fd.o #69716, Chengwei Yang)
394
395 • avoid calling poll() with timeout < -1, which is considered invalid
396   on FreeBSD and NetBSD (fd.o #78480, Jaap Boender)
397
398 • be portable to BSD-derived platforms where O_CLOEXEC is unavailable in libc
399   (like Mac OS X 10.6), or available in libc but unsupported by the kernel
400   (fd.o #77032; rmvsxop, OBATA Akio, Patrick Welche)
401
402 • Fix include path for test/internal/*.c with cmake (Ralf Habacker)
403
404 • Documentation improvements
405   (fd.o #80795, #84313; Thomas Haller, Sebastian Rasmussen)
406
407 • in dbus-monitor, do not leak file descriptors that we have monitored
408   (fd.o #80603, Alban Crequy)
409
410 • Set the close-on-exec flag for the inotify file descriptor, even
411   if built with CMake or older libc (fd.o #73689, Simon McVittie)
412
413 • Remove some LGPL code from the Windows dbus-daemon
414   (fd.o #57272, Ralf Habacker)
415
416 D-Bus 1.8.8 (2014-09-16)
417 ==
418
419 The "smashy smashy egg man" release.
420
421 Security fixes:
422
423 • Do not accept an extra fd in the padding of a cmsg message, which
424   could lead to a 4-byte heap buffer overrun.
425   (CVE-2014-3635, fd.o #83622; Simon McVittie)
426
427 • Reduce default for maximum Unix file descriptors passed per message
428   from 1024 to 16, preventing a uid with the default maximum number of
429   connections from exhausting the system bus' file descriptors under
430   Linux's default rlimit. Distributors or system administrators with a
431   more restrictive fd limit may wish to reduce these limits further.
432
433   Additionally, on Linux this prevents a second denial of service
434   in which the dbus-daemon can be made to exceed the maximum number
435   of fds per sendmsg() and disconnect the process that would have
436   received them.
437   (CVE-2014-3636, fd.o #82820; Alban Crequy)
438
439 • Disconnect connections that still have a fd pending unmarshalling after
440   a new configurable limit, pending_fd_timeout (defaulting to 150 seconds),
441   removing the possibility of creating an abusive connection that cannot be
442   disconnected by setting up a circular reference to a connection's
443   file descriptor.
444   (CVE-2014-3637, fd.o #80559; Alban Crequy)
445
446 • Reduce default for maximum pending replies per connection from 8192 to 128,
447   mitigating an algorithmic complexity denial-of-service attack
448   (CVE-2014-3638, fd.o #81053; Alban Crequy)
449
450 • Reduce default for authentication timeout on the system bus from
451   30 seconds to 5 seconds, avoiding denial of service by using up
452   all unauthenticated connection slots; and when all unauthenticated
453   connection slots are used up, make new connection attempts block
454   instead of disconnecting them.
455   (CVE-2014-3639, fd.o #80919; Alban Crequy)
456
457 Other fixes:
458
459 • Check for libsystemd from systemd >= 209, falling back to
460   the older separate libraries if not found (Umut Tezduyar Lindskog,
461   Simon McVittie)
462
463 • On Linux, use prctl() to disable core dumps from a test executable
464   that deliberately raises SIGSEGV to test dbus-daemon's handling
465   of that condition (fd.o #83772, Simon McVittie)
466
467 • Fix compilation with --enable-stats (fd.o #81043, Gentoo #507232;
468   Alban Crequy)
469
470 • Improve documentation for running tests on Windows (fd.o #41252,
471   Ralf Habacker)
472
473 D-Bus 1.8.6 (2014-06-02)
474 ==
475
476 Security fixes:
477
478 • On Linux ≥ 2.6.37-rc4, if sendmsg() fails with ETOOMANYREFS, silently drop
479   the message. This prevents an attack in which a malicious client can
480   make dbus-daemon disconnect a system service, which is a local
481   denial of service.
482   (fd.o #80163, CVE-2014-3532; Alban Crequy)
483
484 • Track remaining Unix file descriptors correctly when more than one
485   message in quick succession contains fds. This prevents another attack
486   in which a malicious client can make dbus-daemon disconnect a system
487   service.
488   (fd.o #79694, fd.o #80469, CVE-2014-3533; Alejandro Martínez Suárez,
489   Simon McVittie, Alban Crequy)
490
491 Other fixes:
492
493 • When dbus-launch --exit-with-session starts a dbus-daemon but then cannot
494   attach to a session, kill the dbus-daemon as intended
495   (fd.o #74698, Роман Донченко)
496
497 D-Bus 1.8.4 (2014-06-10)
498 ==
499
500 Security fix:
501
502 • Alban Crequy at Collabora Ltd. discovered and fixed a denial-of-service
503   flaw in dbus-daemon, part of the reference implementation of D-Bus.
504   Additionally, in highly unusual environments the same flaw could lead to
505   a side channel between processes that should not be able to communicate.
506   (CVE-2014-3477, fd.o #78979)
507
508 D-Bus 1.8.2 (2014-04-30)
509 ==
510
511 The “nobody wants red” release.
512
513 Enhancements:
514
515 • in the CMake build system, add some hints for Linux users cross-compiling
516   Windows D-Bus binaries to be able to run tests under Wine
517   (fd.o #41252, Ralf Habacker)
518
519 • add Documentation key to dbus.service (fd.o #77447, Cameron Norman)
520
521 Fixes:
522
523 • in "dbus-uuidgen --ensure", try to copy systemd's /etc/machine-id
524   to /var/lib/dbus/machine-id instead of generating an entirely new ID
525   (fd.o #77941, Simon McVittie)
526
527 • if dbus-launch receives an X error very quickly, do not kill
528   unrelated processes (fd.o #74698, Роман Донченко)
529
530 • on Windows, allow up to 8K connections to the dbus-daemon, instead of the
531   previous 64 (fd.o #71297; Cristian Onet, Ralf Habacker)
532
533 • cope with \r\n newlines in regression tests, since on Windows,
534   dbus-daemon.exe uses text mode (fd.o #75863, Руслан Ижбулатов)
535
536 D-Bus 1.8.0 (2014-01-20)
537 ==
538
539 The “Wolverine distrusts my printer” release.
540
541 This starts a new stable branch. The 1.6.x branch is now considered to be
542 outdated, and will only receive fixes for serious bugs such as security
543 flaws. The 1.4.x and 1.2.x branches no longer have upstream support and
544 are unlikely to get any more releases, but if distributors still need to
545 support them, please share security patches via upstream.
546
547 Summary of changes since 1.6.x:
548
549 • libdbus always behaves as if dbus_threads_init_default() had been called
550   (thread-safety by default)
551 • new dbus-run-session tool, replacing certain misuses of dbus-launch
552 • dbus-monitor can talk to outdated versions of dbus-daemon again
553 • new org.freedesktop.DBus.GetConnectionCredentials method
554 • GetConnectionUnixProcessID also works correctly on Windows, returning
555   the Windows process ID
556 • GetConnectionWindowsSID returns the correct SID on Windows
557 • expat is required, libxml2 can no longer be used as a substitute
558 • the userDB cache is required, and cannot be disabled
559 • a 64-bit integer type (either int, long, long long or _int64) is required
560 • better systemd-journald integration on Linux
561 • fixed long-standing fd and array leaks when failing to parse a message
562 • fixed referenced-but-never-freed parent nodes (effectively memory leaks)
563   when using certain object-path allocation patterns, notably in Avahi
564 • better defaults for Windows support
565 • better CMake support
566 • better portability to mingw32, FreeBSD, NetBSD, QNX and Hurd
567 • the source language for the man pages is now Docbook XML
568
569 Enhancements since 1.7.10:
570
571 • Enhance the CMake build system to check for GLib and compile/run
572   a subset of the regression tests (fd.o #41252, #73495; Ralf Habacker)
573
574 Fixes since 1.7.10:
575
576 • don't rely on va_copy(), use DBUS_VA_COPY() wrapper (fd.o #72840,
577   Ralf Habacker)
578
579 • fix compilation of systemd journal support on older systemd versions where
580   sd-journal.h doesn't include syslog.h (fd.o #73455, Ralf Habacker)
581
582 • fix compilation on older MSVC versions by including stdlib.h
583   (fd.o #73455, Ralf Habacker)
584
585 • Allow <allow_anonymous/> to appear in an included configuration file
586   (fd.o #73475, Matt Hoosier)
587
588 Test behaviour changes since 1.7.10:
589
590 • If the tests crash with an assertion failure, they no longer default to
591   blocking for a debugger to be attached. Set DBUS_BLOCK_ON_ABORT in the
592   environment if you want the old behaviour.
593
594 • To improve debuggability, the dbus-daemon and dbus-daemon-eavesdrop tests
595   can be run with an external dbus-daemon by setting
596   DBUS_TEST_DAEMON_ADDRESS in the environment. Test-cases that require
597   an unusually-configured dbus-daemon are skipped.
598
599 D-Bus 1.7.10 (2014-01-06)
600 ==
601
602 The “weighted companion cube” release.
603
604 This is a release candidate for D-Bus 1.8.
605
606 D-Bus Specification 0.23:
607
608 • don't require messages with no INTERFACE to be dispatched
609   (fd.o #68597, Simon McVittie)
610
611 • document "tcp:bind=..." and "nonce-tcp:bind=..." (fd.o #72301,
612   Chengwei Yang)
613
614 • define "listenable" and "connectable" addresses, and discuss
615   the difference (fd.o #61303, Simon McVittie)
616
617 Enhancements:
618
619 • support printing Unix file descriptors in dbus-send, dbus-monitor
620   (fd.o #70592, Robert Ancell)
621
622 • don't install systemd units if --disable-systemd is given
623   (fd.o #71818, Chengwei Yang)
624
625 Fixes:
626
627 • don't leak memory on out-of-memory while listing activatable or
628   active services (fd.o #71526, Radoslaw Pajak)
629
630 • fix undefined behaviour in a regression test (fd.o #69924, DreamNik)
631
632 • escape Unix socket addresses correctly (fd.o #46013, Chengwei Yang)
633
634 • on SELinux systems, don't assume that SECCLASS_DBUS, DBUS__ACQUIRE_SVC
635   and DBUS__SEND_MSG are numerically equal to their values in the
636   reference policy (fd.o #88719, osmond sun)
637
638 • define PROCESS_QUERY_LIMITED_INFORMATION if missing from MinGW < 4 headers
639   (fd.o #71366, Matt Fischer)
640
641 • define WIN32_LEAN_AND_MEAN to avoid conflicts between winsock.h and
642   winsock2.h (fd.o #71405, Matt Fischer)
643
644 • do not return failure from _dbus_read_nonce() with no error set,
645   preventing a potential crash (fd.o #72298, Chengwei Yang)
646
647 • on BSD systems, avoid some O(1)-per-process memory and fd leaks in kqueue,
648   preventing test failures (fd.o #69332, fd.o #72213; Chengwei Yang)
649
650 • fix warning spam on Hurd by not trying to set SO_REUSEADDR on Unix sockets,
651   which doesn't do anything anyway on at least Linux and FreeBSD
652   (fd.o #69492, Simon McVittie)
653
654 • fix use of TCP sockets on FreeBSD and Hurd by tolerating EINVAL from
655   sendmsg() with SCM_CREDS (retrying with plain send()), and looking
656   for credentials more correctly (fd.o #69492, Simon McVittie)
657
658 • ensure that tests run with a temporary XDG_RUNTIME_DIR to avoid
659   getting mixed up in XDG/systemd "user sessions" (fd.o #61301,
660   Simon McVittie)
661
662 • refresh cached policy rules for existing connections when bus
663   configuration changes (fd.o #39463, Chengwei Yang)
664
665 D-Bus 1.7.8 (2013-11-01)
666 ==
667
668 The “extreme hills” release.
669
670 Dependencies:
671
672 • If systemd support is enabled, libsystemd-journal is now required.
673
674 Enhancements:
675
676 • When activating a non-systemd service under systemd, annotate its
677   stdout/stderr with its bus name in the Journal. Known limitation:
678   because the socket is opened before forking, the process will still be
679   logged as if it had dbus-daemon's process ID and user ID.
680   (fd.o #68559, Chengwei Yang)
681
682 • Document more configuration elements in dbus-daemon(1)
683   (fd.o #69125, Chengwei Yang)
684
685 Fixes:
686
687 • Don't leak string arrays or fds if dbus_message_iter_get_args_valist()
688   unpacks them and then encounters an error (fd.o #21259, Chengwei Yang)
689
690 • If compiled with libaudit, retain CAP_AUDIT_WRITE so we can write
691   disallowed method calls to the audit log, fixing a regression in 1.7.6
692   (fd.o #49062, Colin Walters)
693
694 • path_namespace='/' in match rules incorrectly matched nothing; it
695   now matches everything. (fd.o #70799, Simon McVittie)
696
697 D-Bus 1.7.6 (2013-10-09)
698 ==
699
700 The “CSI Shrewsbury” release.
701
702 Build-time configuration changes:
703
704 • Directory change notification via dnotify on Linux is no longer
705   supported; it hadn't compiled successfully since 2010 in any case.
706   If you don't have inotify (Linux) or kqueue (*BSD), you will need
707   to send SIGHUP to the dbus-daemon when its configuration changes.
708   (fd.o #33001, Chengwei Yang)
709
710 • Compiling with --disable-userdb-cache is no longer supported;
711   it didn't work since at least 2008, and would lead to an extremely
712   slow dbus-daemon even it worked. (fd.o #15589, #17133, #66947;
713   Chengwei Yang)
714
715 • The DBUS_DISABLE_ASSERTS CMake option didn't actually disable most
716   assertions. It has been renamed to DBUS_DISABLE_ASSERT to be consistent
717   with the Autotools build system. (fd.o #66142, Chengwei Yang)
718
719 • --with-valgrind=auto enables Valgrind instrumentation if and only if
720   valgrind headers are available. The default is still --with-valgrind=no.
721   (fd.o #56925, Simon McVittie)
722
723 Dependencies:
724
725 • Platforms with no 64-bit integer type are no longer supported.
726   (fd.o #65429, Simon McVittie)
727
728 • GNU make is now (documented to be) required. (fd.o #48277, Simon McVittie)
729
730 • Full test coverage no longer requires dbus-glib, although the tests do not
731   exercise the shared library (only a static copy) if dbus-glib is missing.
732   (fd.o #68852, Simon McVittie)
733
734 Enhancements:
735
736 • D-Bus Specification 0.22
737   · Document GetAdtAuditSessionData() and
738     GetConnectionSELinuxSecurityContext() (fd.o #54445, Simon)
739   · Fix example .service file (fd.o #66481, Chengwei Yang)
740   · Don't claim D-Bus is "low-latency" (lower than what?), just
741     give factual statements about it supporting async use
742     (fd.o #65141, Justin Lee)
743   · Document the contents of .service files, and the fact that
744     system services' filenames are constrained
745     (fd.o #66608; Simon McVittie, Chengwei Yang)
746
747 • Be thread-safe by default on all platforms, even if
748   dbus_threads_init_default() has not been called. For compatibility with
749   older libdbus, library users should continue to call
750   dbus_threads_init_default(): it is harmless to do so.
751   (fd.o #54972, Simon McVittie)
752
753 • Add GetConnectionCredentials() method (fd.o #54445, Simon)
754
755 • New API: dbus_setenv(), a simple wrapper around setenv().
756   Note that this is not thread-safe. (fd.o #39196, Simon)
757
758 • Add dbus-send --peer=ADDRESS (connect to a given peer-to-peer connection,
759   like --address=ADDRESS in previous versions) and dbus-send --bus=ADDRESS
760   (connect to a given bus, like dbus-monitor --address=ADDRESS).
761   dbus-send --address still exists for backwards compatibility,
762   but is no longer documented. (fd.o #48816, Andrey Mazo)
763
764 • Windows-specific:
765   · "dbus-daemon --nofork" is allowed on Windows again. (fd.o #68852,
766     Simon McVittie)
767
768 Fixes:
769
770 • Avoid an infinite busy-loop if a signal interrupts waitpid()
771   (fd.o #68945, Simon McVittie)
772
773 • Clean up memory for parent nodes when objects are unexported
774   (fd.o #60176, Thomas Fitzsimmons)
775
776 • Make dbus_connection_set_route_peer_messages(x, FALSE) behave as
777   documented. Previously, it assumed its second parameter was TRUE.
778   (fd.o #69165, Chengwei Yang)
779
780 • Escape addresses containing non-ASCII characters correctly
781   (fd.o #53499, Chengwei Yang)
782
783 • Document <servicedir> search order correctly (fd.o #66994, Chengwei Yang)
784
785 • Don't crash on "dbus-send --session / x.y.z" which regressed in 1.7.4.
786   (fd.o #65923, Chengwei Yang)
787
788 • If malloc() returns NULL in _dbus_string_init() or similar, don't free
789   an invalid pointer if the string is later freed (fd.o #65959, Chengwei Yang)
790
791 • If malloc() returns NULL in dbus_set_error(), don't va_end() a va_list
792   that was never va_start()ed (fd.o #66300, Chengwei Yang)
793
794 • fix build failure with --enable-stats (fd.o #66004, Chengwei Yang)
795
796 • fix a regression test on platforms with strict alignment (fd.o #67279,
797   Colin Walters)
798
799 • Avoid calling function parameters "interface" since certain Windows headers
800   have a namespace-polluting macro of that name (fd.o #66493, Ivan Romanov)
801
802 • Assorted Doxygen fixes (fd.o #65755, Chengwei Yang)
803
804 • Various thread-safety improvements to static variables (fd.o #68610,
805   Simon McVittie)
806
807 • Make "make -j check" work (fd.o #68852, Simon McVittie)
808
809 • Fix a NULL pointer dereference on an unlikely error path
810   (fd.o #69327, Sviatoslav Chagaev)
811
812 • Improve valgrind memory pool tracking (fd.o #69326,
813   Sviatoslav Chagaev)
814
815 • Don't over-allocate memory in dbus-monitor (fd.o #69329,
816   Sviatoslav Chagaev)
817
818 • dbus-monitor can monitor dbus-daemon < 1.5.6 again
819   (fd.o #66107, Chengwei Yang)
820
821 • Unix-specific:
822   · If accept4() fails with EINVAL, as it can on older Linux kernels
823     with newer glibc, try accept() instead of going into a busy-loop.
824     (fd.o #69026, Chengwei Yang)
825   · If socket() or socketpair() fails with EINVAL or EPROTOTYPE,
826     for instance on Hurd or older Linux with a new glibc, try without
827     SOCK_CLOEXEC. (fd.o #69073; Pino Toscano, Chengwei Yang)
828   · Fix a file descriptor leak on an error code path.
829     (fd.o #69182, Sviatoslav Chagaev)
830   · dbus-run-session: clear some unwanted environment variables
831     (fd.o #39196, Simon)
832   · dbus-run-session: compile on FreeBSD (fd.o #66197, Chengwei Yang)
833   · Don't fail the autolaunch test if there is no DISPLAY (fd.o #40352, Simon)
834   · Use dbus-launch from the builddir for testing, not the installed copy
835     (fd.o #37849, Chengwei Yang)
836   · Fix compilation if writev() is unavailable (fd.o #69409,
837     Vasiliy Balyasnyy)
838   · Remove broken support for LOCAL_CREDS credentials passing, and
839     document where each credential-passing scheme is used (fd.o #60340,
840     Simon McVittie)
841   · Make autogen.sh work on *BSD by not assuming GNU coreutils functionality
842     (fd.o #35881, #69787; Chengwei Yang)
843   · dbus-monitor: be portable to NetBSD (fd.o #69842, Chengwei Yang)
844   · dbus-launch: stop using non-portable asprintf (fd.o #37849, Simon)
845   · Improve error reporting from the setuid activation helper (fd.o #66728,
846     Chengwei Yang)
847
848 • Windows-specific:
849   · Remove unavailable command-line options from 'dbus-daemon --help'
850     (fd.o #42441, Ralf Habacker)
851   · Add support for looking up local TCPv4 clients' credentials on
852     Windows XP via the undocumented AllocateAndGetTcpExTableFromStack
853     function (fd.o #66060, Ralf Habacker)
854   · Fix insufficient dependency-tracking (fd.o #68505, Simon McVittie)
855   · Don't include wspiapi.h, fixing a compiler warning (fd.o #68852,
856     Simon McVittie)
857
858 • Internal changes:
859   · add DBUS_ENABLE_ASSERT, DBUS_ENABLE_CHECKS for less confusing
860     conditionals (fd.o #66142, Chengwei Yang)
861   · improve verbose-mode output (fd.o #63047, Colin Walters)
862   · consolidate Autotools and CMake build (fd.o #64875, Ralf Habacker)
863   · fix various unused variables, unusual build configurations
864     etc. (fd.o #65712, #65990, #66005, #66257, #69165, #69410, #70218;
865     Chengwei Yang, Vasiliy Balyasnyy)
866
867 D-Bus 1.7.4 (2013-06-13)
868 ==
869
870 The “but is your thread-safety thread-safe?” release.
871
872 Security fixes:
873
874 • CVE-2013-2168: Fix misuse of va_list that could be used as a denial
875   of service for system services. Vulnerability reported by Alexandru Cornea.
876   (Simon)
877
878 Dependencies:
879
880 • The Windows version of libdbus now contains a C++ source file, used
881   to provide global initialization when the library is loaded.
882   gcc (mingw*) users should ensure that g++ is also installed.
883
884 • The libxml2-based configuration reader (which hasn't worked for 2.5 years,
885   and was never the recommended option) has been removed. Expat is now a
886   hard dependency.
887
888 Enhancements:
889
890 • It should now be safe to call dbus_threads_init_default() from any thread,
891   at any time. Authors of loadable modules and plugins that use libdbus
892   should consider doing so during initialization.
893   (fd.o #54972, Simon McVittie)
894
895 • Improve dbus-send documentation and command-line parsing (fd.o #65424,
896   Chengwei Yang)
897
898 Unix-specific:
899   · dbus-run-session: experimental new tool to start a temporary D-Bus
900     session, e.g. for regression tests or a text console, replacing
901     certain uses of dbus-launch which weren't really correct
902     (fd.o #39196, Simon)
903
904 Other fixes:
905
906 • In dbus-daemon, don't crash if a .service file starts with key=value
907   (fd.o #60853, Chengwei Yang)
908
909 • Unix-specific:
910   · Fix a crash similar to CVE-2013-2168 the first time we try to use syslog
911     on a platform not defining LOG_PERROR, such as Solaris or QNX.
912     This regressed in 1.7.0. (Simon)
913   · Fix an assertion failure if we try to activate systemd services before
914     systemd connects to the bus (fd.o #50199, Chengwei Yang)
915   · Avoid compiler warnings for ignoring the return from write()
916     (Chengwei Yang)
917
918 • Windows-specific:
919   · Under cmake, install runtime libraries (DLLs) into bin/ instead of lib/
920     so that Windows finds them (fd.o #59733, Ralf Habacker)
921
922 D-Bus 1.7.2 (2013-04-25)
923 ==
924
925 The “only partially opaque” release.
926
927 Configuration changes:
928
929 • On non-QNX Unix platforms, the default limit on fds per message in the
930   session bus configuration has reduced from 4096 to 1024. The default
931   limit used on the system bus was already 1024. On QNX, both limits are
932   reduced further, to 128.
933
934 Enhancements:
935
936 • D-Bus Specification 0.21
937   · Following Unicode Corrigendum #9, the noncharacters U+nFFFE, U+nFFFF,
938     U+FDD0..U+FDEF are allowed in UTF-8 strings again. (fd.o #63072,
939     Simon McVittie)
940
941 Fixes:
942
943 • Diagnose incorrect use of dbus_connection_get_data() with negative slot
944   (i.e. before allocating the slot) rather than returning junk
945   (fd.o #63127, Dan Williams)
946
947 • Fix a cmake build regression since 1.7.0 (fd.o #63682; Ralf Habacker,
948   Simon McVittie)
949
950 • Unix-specific:
951   · On Linux, link successfully with glibc 2.17 (fd.o #63166, Simon McVittie)
952   · Under systemd, log to syslog only, not stderr, avoiding duplication
953     (fd.o #61399, #39987; Colin Walters, Dagobert Michelsen)
954   · Under systemd, remove unnecessary dependency on syslog.socket
955     (fd.o #63531, Cristian Rodríguez)
956   · Include alloca.h for alloca() if available, fixing compilation on
957     Solaris 10 (fd.o #63071, Dagobert Michelsen)
958   · Allow use of systemd-logind without the rest of systemd
959     (fd.o #62585, Martin Pitt)
960   · When built with CMake, link to librt and use the right path for
961     meinproc's XSLT stylesheets (fd.o #61637, Ralf Habacker)
962   · Reduce the default limit on number of fds per message to 128 under
963     QNX, working around an arbitrary OS limit (fd.o #61176, Matt Fischer)
964
965 • Windows-specific:
966   · Do not claim that all bus clients have the dbus-daemon's credentials;
967     pick up local TCPv4 clients' credentials (process ID and security
968     identifier, i.e. user) using GetExtendedTcpTable() (fd.o #61787,
969     Ralf Habacker)
970
971 D-Bus 1.7.0 (2013-02-22)
972 ==
973
974 The "Disingenuous Assertions" release.
975
976 This is a new development release, starting the 1.7.x branch. D-Bus 1.6
977 remains the recommended version for long-term-supported distributions
978 or the upcoming GNOME 3.8 release.
979
980 Build-time configuration changes:
981
982 • The --with-dbus-session-bus-default-address configure option is no longer
983   supported. Use the new --with-dbus-session-bus-connect-address and
984   --with-dbus-session-bus-listen-address options instead. On Windows, you
985   usually want them to have the same argument; on Unix, the defaults are
986   usually correct.
987
988 • Similarly, the DBUS_SESSION_BUS_DEFAULT_ADDRESS CMake variable is no longer
989   supported; use the new DBUS_SESSION_BUS_LISTEN_ADDRESS and
990   DBUS_SESSION_BUS_CONNECT_ADDRESS variables instead.
991
992 • cmake/cross-compile.sh has been removed. Instead, please use a
993   cross-toolchain file (-DCMAKE_TOOLCHAIN_FILE) as documented at
994   <http://www.vtk.org/Wiki/CMake_Cross_Compiling>; or use Autotools
995   as documented in "info automake Cross-Compilation", and set
996   PKG_CONFIG_PATH appropriately.
997
998 Requirements:
999
1000 • Man pages now require xmlto (or either xmlto or meinproc, if using CMake).
1001 • man2html is no longer used.
1002
1003 Enhancements:
1004
1005 • D-Bus Specification 0.20
1006   · actually say that /org/freedesktop/DBus is the object that
1007     implements o.fd.DBus (fd.o #51865, Colin Walters)
1008   · various reorganisation for better clarity (fd.o #38252, Simon McVittie)
1009   · stop claiming that all basic types work just like INT32 (strings don't!)
1010
1011 • The "source code" for the man pages is now Docbook XML, eliminating
1012   the outdated duplicate copies used when building with CMake.
1013   (fd.o #59805; Ralf Habacker, Simon McVittie)
1014
1015 Fixes:
1016
1017 • In the activation helper, when compiled for tests, do not reset the system
1018   bus address, fixing the regression tests. (fd.o #52202, Simon)
1019
1020 • Fix building with Valgrind 3.8, at the cost of causing harmless warnings
1021   with Valgrind 3.6 on some compilers (fd.o #55932, Arun Raghavan)
1022
1023 • Merge <servicehelper> from system-local.conf if necessary (fd.o #51560,
1024   Krzysztof Konopko)
1025
1026 • Under CMake, prefer xmlto over meinproc (fd.o #59733, Ralf Habacker)
1027
1028 • Stop duplicating CMake's own logic to find libexpat
1029   (fd.o #59733, Ralf Habacker)
1030
1031 • Don't assume CMake host and build system are the same (fd.o #59733,
1032   Ralf Habacker)
1033
1034 • Avoid deprecation warnings for GLib 2.35 (fd.o #59971, Simon McVittie)
1035
1036 • Unix-specific:
1037   · Check for functions in libpthread correctly, fixing compilation on
1038     (at least) OpenBSD (fd.o #47239, Simon)
1039   · Don't leak temporary fds pointing to /dev/null (fd.o #56927,
1040     Michel HERMIER)
1041   · Update sd-daemon.[ch] from systemd (fd.o #60681)
1042   · Add partial support for QNX (fd.o #60339, fd.o #61176; Matt Fischer)
1043
1044 • Windows-specific:
1045   · The default session bus listening and connecting address is now
1046     "autolaunch:", which makes D-Bus on Windows interoperate with itself
1047     and GDBus "out of the box". Use the configure options and cmake variables
1048     described above if you require a different autolaunch scope.
1049     (fd.o #38201, Simon McVittie)
1050   · Avoid a CMake warning under Cygwin (fd.o #59401, Ralf Habacker)
1051
1052 • Create session.d, system.d directories under CMake (fd.o #41319,
1053   Ralf Habacker)
1054
1055 D-Bus 1.6.8 (2012-09-28)
1056 ==
1057
1058 The "Fix one thing, break another" release.
1059
1060 • Follow up to CVE-2012-3524: The additional hardening
1061   work to use __secure_getenv() as a followup to bug #52202
1062   broke certain configurations of gnome-keyring.  Given
1063   the difficulty of making this work without extensive
1064   changes to gnome-keyring, use of __secure_getenv() is
1065   deferred.
1066
1067 D-Bus 1.6.6 (2012-09-28)
1068 ==
1069
1070 The "Clear the environment in your setuid binaries, please" release.
1071
1072 • CVE-2012-3524: Don't access environment variables (fd.o #52202)
1073   Thanks to work and input from Colin Walters, Simon McVittie,
1074   Geoffrey Thomas, and others.
1075 • Unix-specific:
1076   · Fix compilation on Solaris (fd.o #53286, Jonathan Perkin)
1077   · Work around interdependent headers on OpenBSD by including sys/types.h
1078     before each use of sys/socket.h (fd.o #54418, Brad Smith)
1079
1080 D-Bus 1.6.4 (2012-07-18)
1081 ==
1082
1083 • Detect that users are "at the console" correctly when configured with
1084   a non-default path such as --enable-console-auth-dir=/run/console
1085   (fd.o #51521, Dave Reisner)
1086
1087 • Remove an incorrect assertion from DBusTransport (fd.o #51657,
1088   Simon McVittie)
1089
1090 • Make --enable-developer default to "no" (regression in 1.6.2;
1091   fd.o #51657, Simon McVittie)
1092
1093 • Windows-specific:
1094   · Launch dbus-daemon correctly if its path contains a space
1095     (fd.o #49450, Wolfgang Baron)
1096
1097 D-Bus 1.6.2 (2012-06-27)
1098 ==
1099
1100 The "Ice Cabbage" release.
1101
1102 • Change how we create /var/lib/dbus so it works under Automake >= 1.11.4
1103   (fd.o #51406, Simon McVittie)
1104
1105 • Don't return from dbus_pending_call_set_notify with a lock held on OOM
1106   (fd.o #51032, Simon McVittie)
1107
1108 • Disconnect "developer mode" (assertions, verbose mode etc.) from
1109   Automake maintainer mode. D-Bus developers should now configure with
1110   --enable-developer. Automake maintainer mode is now on by default;
1111   distributions can disable it with --disable-maintainer-mode.
1112   (fd.o #34671, Simon McVittie)
1113
1114 • Automatically define DBUS_STATIC_BUILD in static-only Autotools builds,
1115   fixing linking when targeting Windows (fd.o #33973; william, Simon McVittie)
1116
1117 • Unix-specific:
1118   · Check for libpthread under CMake on Unix (fd.o #47237, Simon McVittie)
1119
1120 D-Bus 1.6.0 (2012-06-05)
1121 ==
1122
1123 The “soul of this machine has improved” release.
1124
1125 This version starts a new stable branch of D-Bus: only bug fixes will
1126 be accepted into 1.6.x. Other changes will now go to the 1.7.x branch.
1127
1128 Summary of changes since 1.4.x:
1129
1130 • New requirements
1131   · PTHREAD_MUTEX_RECURSIVE on Unix
1132   · compiler support for 64-bit integers (int64_t or equivalent)
1133
1134 • D-Bus Specification v0.19
1135
1136 • New dbus-daemon features
1137   · <allow own_prefix="com.example.Service"/> rules allow the service to
1138     own names like com.example.Service.Instance3
1139   · optional systemd integration when checking at_console policies
1140   · --nopidfile option, mainly for use by systemd
1141   · path_namespace and arg0namespace may appear in match rules
1142   · eavesdropping is disabled unless the match rule contains eavesdrop=true
1143
1144 • New public API
1145   · functions to validate various string types (dbus_validate_path() etc.)
1146   · dbus_type_is_valid()
1147   · DBusBasicValue, a union of every basic type
1148
1149 • Bug fixes
1150   · removed an unsafe reimplementation of recursive mutexes
1151   · dbus-daemon no longer busy-loops if it has far too many file descriptors
1152   · dbus-daemon.exe --print-address works on Windows
1153   · all the other bug fixes from 1.4.20
1154
1155 • Other major implementation changes
1156   · on Linux, dbus-daemon uses epoll if supported, for better scalability
1157   · dbus_threads_init() ignores its argument and behaves like
1158     dbus_threads_init_default() instead
1159   · removed the per-connection link cache, improving dbus-daemon performance
1160
1161 • Developer features
1162   · optional Valgrind instrumentation (--with-valgrind)
1163   · optional Stats interface on the dbus-daemon (--enable-stats)
1164   · optionally abort whenever malloc() fails (--enable-embedded-tests
1165     and export DBUS_MALLOC_CANNOT_FAIL=1)
1166
1167 Changes since 1.5.12:
1168
1169 • Be more careful about monotonic time vs. real time, fixing DBUS_COOKIE_SHA1
1170   spec-compliance (fd.o #48580, David Zeuthen)
1171
1172 • Don't use install(1) within the source/build trees, fixing the build as
1173   non-root when using OpenBSD install(1) (fd.o #48217, Antoine Jacoutot)
1174
1175 • Add missing commas in some tcp and nonce-tcp addresses, and remove
1176   an unused duplicate copy of the nonce-tcp transport in Windows builds
1177   (fd.o #45896, Simon McVittie)
1178
1179 D-Bus 1.5.12 (2012-03-27)
1180 ==
1181
1182 The “Big Book of Science” release.
1183
1184 • Add public API to validate various string types:
1185   dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
1186   dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
1187   (fd.o #39549, Simon McVittie)
1188
1189 • Turn DBusBasicValue into public API so bindings don't need to invent their
1190   own "union of everything" type (fd.o #11191, Simon McVittie)
1191
1192 • Enumerate data files included in the build rather than using find(1)
1193   (fd.o #33840, Simon McVittie)
1194
1195 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
1196   in dbus-daemon (fd.o #46273, Alban Crequy)
1197
1198 • Windows-specific:
1199   · make dbus-daemon.exe --print-address (and --print-pid) work again
1200     on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
1201   · fix duplicate case value when compiling against mingw-w64
1202     (fd.o #47321, Andoni Morales Alastruey)
1203
1204 D-Bus 1.5.10 (2012-02-21)
1205 ==
1206
1207 The "fire in Delerium" release.
1208
1209 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
1210 and SUSv2) is now required.
1211
1212 • D-Bus Specification 0.19:
1213   · Formally define unique connection names and well-known bus names,
1214     and document best practices for interface, bus, member and error names,
1215     and object paths (fd.o #37095, Simon McVittie)
1216   · Document the search path for session and system services on Unix, and
1217     where they should be installed by build systems (fd.o #21620, fd.o #35306;
1218     Simon McVittie)
1219   · Document the systemd transport (fd.o #35232, Lennart Poettering)
1220
1221 • Make dbus_threads_init() use the same built-in threading implementation
1222   as dbus_threads_init_default(); the user-specified primitives that it
1223   takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
1224
1225 • Allow all configured auth mechanisms, not just one (fd.o #45106,
1226   Pavel Strashkin)
1227
1228 • Improve cmake build system (Ralf Habacker):
1229   · simplify XML parser dependencies (fd.o #41027)
1230   · generate build timestamp (fd.o #41029)
1231   · only create batch files on Windows
1232   · fix option and cache syntax
1233   · add help-options target
1234   · share dbus-arch-deps.h.in with autotools rather than having our
1235     own version (fd.o #41033)
1236
1237 • Build tests successfully with older GLib, as found in e.g. Debian 6
1238   (fd.o #41219, Simon McVittie)
1239
1240 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
1241
1242 • Build documentation correctly if man2html doesn't support filenames on
1243   its command-line (fd.o #43875, Jack Nagel)
1244
1245 • Improve test coverage. To get even more coverage, run the tests with
1246   DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
1247
1248 • Reduce the size of the shared library by moving functionality only used
1249   by dbus-daemon, tests etc. into their internal library and deleting
1250   unused code (fd.o #34976, #39759; Simon McVittie)
1251
1252 • Add dbus-daemon --nopidfile option, overriding the configuration, for
1253   setups where the default configuration must include <pidfile/> to avoid
1254   breaking traditional init, but the pid file is in fact unnecessary; use
1255   it under systemd to improve startup time a bit (fd.o #45520,
1256   Lennart Poettering)
1257
1258 • Optionally (if configured --with-valgrind) add instrumentation to debug
1259   libdbus and associated tools more meaningfully under Valgrind
1260   (fd.o #37286, Simon McVittie)
1261
1262 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
1263
1264 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
1265
1266 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
1267   abort on failure to malloc() (like GLib does), to turn runaway memory leaks
1268   into a debuggable core-dump if a resource limit is applied (fd.o #41048,
1269   Simon McVittie)
1270
1271 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
1272   Simon McVittie)
1273
1274 • Unix-specific:
1275   · Replace our broken reimplementation of recursive mutexes, which has
1276     been broken since 2006, with an ordinary pthreads recursive mutex
1277     (fd.o #43744; Sigmund Augdal, Simon McVittie)
1278   · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
1279     welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
1280     event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
1281   · When running under systemd, use it instead of ConsoleKit to check
1282     whether to apply at_console policies (fd.o #39609, Lennart Poettering)
1283   · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
1284   · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
1285   · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
1286     (fd.o #41218, Simon McVittie)
1287   · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
1288     helper doesn't obey environment variables to avoid privilege escalation
1289     attacks, so make the system bus follow the same rules
1290     (fd.o #21620, Simon McVittie)
1291
1292 • Windows-specific:
1293   · Find the dbus-daemon executable next to the shared library (fd.o #41558;
1294     Jesper Dam, Ralf Habacker)
1295   · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
1296     Simon McVittie)
1297
1298 D-Bus 1.5.8 (2011-09-21)
1299 ==
1300
1301 The "cross-metering" release.
1302
1303 In addition to dead code removal and refactoring, this release contains all
1304 of the bugfixes from 1.4.16.
1305
1306 • Clean up dead code, and make more warnings fatal in development builds
1307   (fd.o #39231, fd.o #41012; Simon McVittie)
1308
1309 • If full test coverage is requested via --enable-tests, strictly require
1310   Python, pygobject and dbus-python, which are required by some tests; if not,
1311   and Python is missing, skip those tests rather than failing
1312   (fd.o #37847, Simon McVittie)
1313
1314 • When using cmake, provide the same version-info API in the installed headers
1315   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
1316
1317 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
1318
1319 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
1320
1321 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
1322   Simon McVittie)
1323
1324 • Fix duplicates in authors list (Ralf Habacker)
1325
1326 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
1327   (fd.o #39879, Chris Mayo)
1328
1329 • Fix a small memory leak, and a failure to report errors, when updating
1330   a service file entry for activation (fd.o #39230, Simon McVittie)
1331
1332 • Unix-specific:
1333   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
1334     Brian Cameron, Simon McVittie)
1335   · On systems that use libcap-ng but not systemd, drop supplemental groups
1336     when switching to the daemon user (Red Hat #726953, Steve Grubb)
1337   · Make the cmake build work again on GNU platforms (fd.o #29228,
1338     Simon McVittie)
1339   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
1340     like Solaris (fd.o #40313, Dagobert Michelsen)
1341   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
1342     (fd.o #40235, Simon McVittie)
1343   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
1344     (fd.o #39987, Simon McVittie)
1345   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
1346     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
1347
1348 • Windows-specific:
1349   · Fix compilation on MSVC, which doesn't understand "inline" with its
1350     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
1351   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
1352   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
1353
1354 D-Bus 1.5.6 (2011-07-29)
1355 ==
1356
1357 The "weird, gravy-like aftertaste" release.
1358
1359 In addition to new features and refactoring, this release contains all of the
1360 bugfixes from 1.4.14.
1361
1362 Potentially incompatible (Bustle and similar debugging tools will need
1363 changes to work as intended):
1364
1365 • Do not allow match rules to "eavesdrop" (receive messages intended for a
1366   different recipient) by mistake: eavesdroppers must now opt-in to this
1367   behaviour by putting "eavesdrop='true'" in the match rule, which will
1368   not have any practical effect on buses where eavesdropping is not allowed
1369   (fd.o #37890, Cosimo Alfarano)
1370
1371 Other changes:
1372
1373 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
1374   Cosimo Alfarano, Simon McVittie)
1375   · add the "eavesdrop" keyword to match rules
1376   · define eavesdropping, unicast messages and broadcast messages
1377   · stop claiming that match rules are needed to match unicast messages to you
1378   · promote the type system to be a top-level section
1379
1380 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
1381   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
1382   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
1383
1384 • Consistently use atomic operations on everything that is ever manipulated
1385   via atomic ops, as was done for changes to DBusConnection's refcount in
1386   1.4.12 (fd.o #38005, Simon McVittie)
1387
1388 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
1389   Simon McVittie)
1390
1391 • Make "make check" in a clean tree work, by not running tests until
1392   test data has been set up (fd.o #34405, Simon McVittie)
1393
1394 • The dbus-daemon no longer busy-loops if it has a very large number of file
1395   descriptors (fd.o #23194, Simon McVittie)
1396
1397 • Refactor message flow through dispatching to avoid locking violations if
1398   the bus daemon's message limit is hit; remove the per-connection link cache,
1399   which was meant to improve performance, but now reduces it (fd.o #34393,
1400   Simon McVittie)
1401
1402 • Some cmake fixes (Ralf Habacker)
1403
1404 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
1405   Simon McVittie, Lennart Poettering)
1406
1407 • Stop storing two extra byte order indicators in each D-Bus message
1408   (fd.o #38287, Simon McVittie)
1409
1410 • Add an optional Stats interface which can be used to get statistics from
1411   a running dbus-daemon if enabled at configure time with --enable-stats
1412   (fd.o #34040, Simon McVittie)
1413
1414 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
1415
1416 • Documentation (fd.o #36156, Simon McVittie):
1417   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
1418   · install more documentation automatically, including man2html output
1419   · put dbus.devhelp in the right place (it must go in ${htmldir})
1420
1421 • Unix-specific:
1422   · look for system services in /lib/dbus-1/system-services in addition to all
1423     the other well-known locations; note that this should always be /lib,
1424     even on platforms where shared libraries on the root FS would go in /lib64,
1425     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
1426   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
1427
1428 • Windows-specific (Ralf Habacker):
1429   · fix use of a mutex for autolaunch server detection
1430   · don't crash on malloc failure in _dbus_printf_string_upper_bound
1431
1432 D-Bus 1.5.4 (2011-06-10)
1433 ==
1434
1435 Security (local denial of service):
1436
1437 • Byte-swap foreign-endian messages correctly, preventing a long-standing
1438   local DoS if foreign-endian messages are relayed through the dbus-daemon
1439   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
1440   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
1441
1442 New things:
1443
1444 • The constant to use for an infinite timeout now has a name,
1445   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
1446   which can be used for source compatibility with older versions of libdbus.
1447
1448 • If GLib and DBus-GLib are already installed, more tests will be built,
1449   providing better coverage. The new tests can also be installed via
1450       ./configure --enable-installed-tests
1451   for system integration testing, if required. (fd.o #34570, Simon McVittie)
1452
1453 Changes:
1454
1455 • Consistently use atomic operations for the DBusConnection's refcount,
1456   fixing potential threading problems (fd.o #38005, Simon McVittie)
1457
1458 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
1459   small (300KiB on x86-64) and it frequently doesn't work in unusual
1460   toolchains. To optimize for minimum installed size, you should benchmark
1461   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
1462   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
1463
1464 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
1465   (fd.o #35880, Timothy Redaelli)
1466
1467 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
1468   when not using a DESTDIR (fd.o #37870, Simon McVittie)
1469
1470 • Windows-specific changes:
1471   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
1472
1473 D-Bus 1.5.2 (2011-06-01)
1474 ==
1475
1476 The "Boar Hunter" release.
1477
1478 Notes for distributors:
1479
1480   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
1481   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
1482   toolchain supports it reliably, via something like:
1483
1484     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
1485
1486   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
1487
1488 Changes:
1489
1490   • D-Bus Specification v0.17
1491     · Reserve the extra characters used in signatures by GVariant
1492       (fd.o #34529, Simon McVittie)
1493     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
1494   • Don't force -fPIE: distributions and libtool know better than we do whether
1495     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
1496   • Allow --disable-gc-sections, in case your toolchain offers the
1497     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
1498     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
1499   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
1500     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
1501   • Ensure that maintainers upload documentation with the right permissions
1502     (fd.o #36130, Simon McVittie)
1503   • Don't force users of libdbus to be linked against -lpthread, -lrt
1504     (fd.o #32827, Simon McVittie)
1505   • Log system-bus activation information to syslog (fd.o #35705,
1506     Colin Walters)
1507   • Log messages dropped due to quotas to syslog (fd.o #35358,
1508     Simon McVittie)
1509   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
1510   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
1511     (fd.o #35228, Lennart Poettering)
1512   • In the regression tests, don't report fds as "leaked" if they were open
1513     on startup (fd.o #35173, Simon McVittie)
1514   • Make dbus-monitor bail out if asked to monitor more than one bus,
1515     rather than silently using the last one (fd.o #26548, Will Thompson)
1516   • Clarify documentation (fd.o #35182, Simon McVittie)
1517   • Clean up minor dead code and some incorrect error handling
1518     (fd.o #33128, fd.o #29881; Simon McVittie)
1519   • Check that compiler options are supported before using them (fd.o #19681,
1520     Simon McVittie)
1521   • Windows:
1522     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
1523
1524 D-Bus 1.5.0 (2011-04-11)
1525 ==
1526
1527 The "you never know when you need to tow something from your giant
1528 flying shark" release.
1529
1530   • D-Bus Specification v0.16
1531     · Add support for path_namespace and arg0namespace in match rules
1532       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
1533     · Make argNpath support object paths, not just object-path-like strings,
1534       and document it better (fd.o #31818, Will Thompson)
1535   • Let the bus daemon implement more than one interface (fd.o #33757,
1536     Simon McVittie)
1537   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
1538     Roberto Guido)
1539   • Require user intervention to compile with missing 64-bit support
1540     (fd.o #35114, Simon McVittie)
1541   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
1542   • Raise UnknownObject instead of UnknownMethod for calls to methods on
1543     paths that are not part of the object tree, and UnknownInterface for calls
1544     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
1545
1546 D-Bus 1.4.8 (2011-04-08)
1547 ==
1548
1549 The "It's like the beginning of a lobster" release.
1550
1551   • Rename configure.in to configure.ac, and update it to modern conventions
1552     (fd.o #32245; Javier Jardón, Simon McVittie)
1553   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
1554     Anders Kaseorg)
1555   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
1556     --disable-x11-autolaunch configure option to prevent it altogether
1557     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
1558   • Install the documentation, and an index for Devhelp (fd.o #13495,
1559     Debian #454142; Simon McVittie, Matthias Clasen)
1560   • If checks are not disabled, check validity of string-like types and
1561     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
1562   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
1563     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
1564   • Break up a huge conditional in config-parser so gcov can produce coverage
1565     data (fd.o #10887, Simon McVittie)
1566   • List which parts of the Desktop Entry specification are applicable to
1567     .service files (fd.o #19159, Sven Herzberg)
1568   • Don't suppress service activation if two services have the same Exec=
1569     (fd.o #35750, Colin Walters)
1570   • Windows:
1571     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
1572       (Andre Heinecke)
1573     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
1574       (fd.o #32805, Mark Brand)
1575
1576 D-Bus 1.4.6 (2010-02-17)
1577 ==
1578
1579 The "1, 2, miss a few, 99, 100" release.
1580
1581   • Remove unfinished changes intended to support GTest-based tests,
1582     which were mistakenly included in 1.4.4
1583
1584 D-Bus 1.4.4 (2010-02-17)
1585 ==
1586
1587   • Switch back to using even micro versions for stable releases; 1.4.1
1588     should have been called 1.4.2, so skip that version number
1589   • Don't leave bad file descriptors being watched when spawning processes,
1590     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
1591     also LP#656134, LP#680444, LP#713157)
1592   • Check for MSG_NOSIGNAL correctly
1593   • Fix failure to detect abstract socket support (fd.o #29895)
1594   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
1595     (fd.o #32262, NB#180486)
1596   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
1597     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
1598   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
1599   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
1600   • Improve gcc malloc annotations (fd.o #32710)
1601   • If the system bus is launched via systemd, protect it from the OOM killer
1602   • Documentation improvements (fd.o #11190)
1603   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
1604     fd.o #15922, LP#241619)
1605   • Cope with invalid files in session.d, system.d (fd.o #19186,
1606     Debian #230231)
1607   • Don't distribute generated files that embed our builddir (fd.o #30285,
1608     fd.o #34292)
1609   • Raise the system bus's fd limit to be sufficient for its configuration
1610     (fd.o #33474, LP#381063)
1611   • Fix syslog string processing
1612   • Ignore -Waddress
1613   • Remove broken gcov parsing code and --enable-gcov, and replace them
1614     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
1615   • Windows:
1616     · avoid live-lock in Windows CE due to unfair condition variables
1617   • OpenBSD:
1618     · support credentials-passing (fd.o #32542)
1619   • Solaris:
1620     · opt-in to thread safety (fd.o #33464)
1621
1622 D-Bus 1.4.1 (20 December 2010)
1623 ==
1624
1625  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
1626    crash the bus. The existing restriction to 64-levels of nesting previously
1627    only applied to the static type signature; now it also applies to dynamic
1628    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
1629    issue.
1630  • OS X portability fixes, including launchd support.
1631  • Windows autolaunch improvements.
1632  • Various bug fixes.
1633
1634 D-Bus 1.4.0 (6 Sep 2010)
1635 ==
1636  - systemd hookup
1637
1638 D-Bus 1.3.1 (23 June 2010)
1639 ==
1640  - New standardized PropertiesChanged signal in the properties interface
1641  - Various portability fixes, in particular to Windows platforms
1642  - Support forking bus services, for compatibility
1643
1644 D-Bus 1.3.0 (29 July 2009)
1645 ==
1646  - ability for dbus-send to send to any bus (--address)
1647  - file descriptor passing on Unix socket transports
1648  - use of GCC atomic intrinsics for better processor support
1649    (requires -march=i486 or above for x86 compilation)
1650  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
1651    and glibc (2.9 for pipe2 and 2.10 for accept4)
1652  - feature negotiation in the bus daemon