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