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