Revert "Factor out DBusAuthorization from DBusTransport"
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.7.6 (UNRELEASED)
2 ==
3
4 Build-time configuration changes:
5
6 • Directory change notification via dnotify on Linux is no longer
7   supported; it hadn't compiled successfully since 2010 in any case.
8   If you don't have inotify (Linux) or kqueue (*BSD), you will need
9   to send SIGHUP to the dbus-daemon when its configuration changes.
10   (fd.o #33001, Chengwei Yang)
11
12 • The DBUS_DISABLE_ASSERTS CMake option didn't actually disable most
13   assertions. It has been renamed to DBUS_DISABLE_ASSERT to be consistent
14   with the Autotools build system. (fd.o #66142, Chengwei Yang)
15
16 Enhancements:
17
18 • D-Bus Specification 0.22
19   · Document GetAdtAuditSessionData() and
20     GetConnectionSELinuxSecurityContext() (fd.o #54445, Simon)
21   · Fix example .service file (fd.o #66481, Chengwei Yang)
22
23 • Be thread-safe by default on all platforms, even if
24   dbus_threads_init_default() has not been called. For compatibility with
25   older libdbus, library users should continue to call
26   dbus_threads_init_default(): it is harmless to do so.
27   (fd.o #54972, Simon McVittie)
28
29 • Add GetConnectionCredentials() method (fd.o #54445, Simon)
30
31 Fixes:
32
33 • Escape addresses containing non-ASCII characters correctly
34   (fd.o #53499, Chengwei Yang)
35
36 • Don't crash on "dbus-send --session / x.y.z" which regressed in 1.7.4.
37   (fd.o #65923, Chengwei Yang)
38
39 • If malloc() returns NULL in _dbus_string_init() or similar, don't free
40   an invalid pointer if the string is later freed (fd.o #65959, Chengwei Yang)
41
42 • If malloc() returns NULL in dbus_set_error(), don't va_end() a va_list
43   that was never va_start()ed (fd.o #66300, Chengwei Yang)
44
45 • fix build failure with --enable-stats (fd.o #66004, Chengwei Yang)
46
47 • fix a regression test on platforms with strict alignment (fd.o #67279,
48   Colin Walters)
49
50 • Avoid calling function parameters "interface" since certain Windows headers
51   have a namespace-polluting macro of that name (fd.o #66493, Ivan Romanov)
52
53 • Assorted Doxygen fixes (fd.o #65755, Chengwei Yang)
54
55 • Unix-specific:
56   · dbus-run-session: compile on FreeBSD (fd.o #66197, Chengwei Yang)
57
58 • Windows-specific:
59   · Remove unavailable command-line options from 'dbus-daemon --help'
60     (fd.o #42441, Ralf Habacker)
61   · Add support for looking up local TCPv4 clients' credentials on
62     Windows XP via the undocumented AllocateAndGetTcpExTableFromStack
63     function (fd.o #66060, Ralf Habacker)
64
65 • Internal changes:
66   · add DBUS_ENABLE_ASSERT, DBUS_ENABLE_CHECKS for less confusing
67     conditionals (fd.o #66142, Chengwei Yang)
68   · improve verbose-mode output (fd.o #63047, Colin Walters)
69   · consolidate Autotools and CMake build (fd.o #64875, Ralf Habacker)
70   · fix various unused variables, unusual build configurations
71     etc. (fd.o #65712, #65990, #66005, #66257; Chengwei Yang)
72
73 D-Bus 1.7.4 (2013-06-13)
74 ==
75
76 The “but is your thread-safety thread-safe?” release.
77
78 Security fixes:
79
80 • CVE-2013-2168: Fix misuse of va_list that could be used as a denial
81   of service for system services. Vulnerability reported by Alexandru Cornea.
82   (Simon)
83
84 Dependencies:
85
86 • The Windows version of libdbus now contains a C++ source file, used
87   to provide global initialization when the library is loaded.
88   gcc (mingw*) users should ensure that g++ is also installed.
89
90 • The libxml2-based configuration reader (which hasn't worked for 2.5 years,
91   and was never the recommended option) has been removed. Expat is now a
92   hard dependency.
93
94 Enhancements:
95
96 • It should now be safe to call dbus_threads_init_default() from any thread,
97   at any time. Authors of loadable modules and plugins that use libdbus
98   should consider doing so during initialization.
99   (fd.o #54972, Simon McVittie)
100
101 • Improve dbus-send documentation and command-line parsing (fd.o #65424,
102   Chengwei Yang)
103
104 Other fixes:
105
106 • In dbus-daemon, don't crash if a .service file starts with key=value
107   (fd.o #60853, Chengwei Yang)
108
109 • Unix-specific:
110   · Fix a crash similar to CVE-2013-2168 the first time we try to use syslog
111     on a platform not defining LOG_PERROR, such as Solaris or QNX.
112     This regressed in 1.7.0. (Simon)
113   · Fix an assertion failure if we try to activate systemd services before
114     systemd connects to the bus (fd.o #50199, Chengwei Yang)
115   · Avoid compiler warnings for ignoring the return from write()
116     (Chengwei Yang)
117
118 • Windows-specific:
119   · Under cmake, install runtime libraries (DLLs) into bin/ instead of lib/
120     so that Windows finds them (fd.o #59733, Ralf Habacker)
121
122 D-Bus 1.7.2 (2013-04-25)
123 ==
124
125 The “only partially opaque” release.
126
127 Configuration changes:
128
129 • On non-QNX Unix platforms, the default limit on fds per message in the
130   session bus configuration has reduced from 4096 to 1024. The default
131   limit used on the system bus was already 1024. On QNX, both limits are
132   reduced further, to 128.
133
134 Enhancements:
135
136 • D-Bus Specification 0.21
137   · Following Unicode Corrigendum #9, the noncharacters U+nFFFE, U+nFFFF,
138     U+FDD0..U+FDEF are allowed in UTF-8 strings again. (fd.o #63072,
139     Simon McVittie)
140
141 Fixes:
142
143 • Diagnose incorrect use of dbus_connection_get_data() with negative slot
144   (i.e. before allocating the slot) rather than returning junk
145   (fd.o #63127, Dan Williams)
146
147 • Fix a cmake build regression since 1.7.0 (fd.o #63682; Ralf Habacker,
148   Simon McVittie)
149
150 • Unix-specific:
151   · On Linux, link successfully with glibc 2.17 (fd.o #63166, Simon McVittie)
152   · Under systemd, log to syslog only, not stderr, avoiding duplication
153     (fd.o #61399, #39987; Colin Walters, Dagobert Michelsen)
154   · Under systemd, remove unnecessary dependency on syslog.socket
155     (fd.o #63531, Cristian Rodríguez)
156   · Include alloca.h for alloca() if available, fixing compilation on
157     Solaris 10 (fd.o #63071, Dagobert Michelsen)
158   · Allow use of systemd-logind without the rest of systemd
159     (fd.o #62585, Martin Pitt)
160   · When built with CMake, link to librt and use the right path for
161     meinproc's XSLT stylesheets (fd.o #61637, Ralf Habacker)
162   · Reduce the default limit on number of fds per message to 128 under
163     QNX, working around an arbitrary OS limit (fd.o #61176, Matt Fischer)
164
165 • Windows-specific:
166   · Do not claim that all bus clients have the dbus-daemon's credentials;
167     pick up local TCPv4 clients' credentials (process ID and security
168     identifier, i.e. user) using GetExtendedTcpTable() (fd.o #61787,
169     Ralf Habacker)
170
171 D-Bus 1.7.0 (2013-02-22)
172 ==
173
174 The "Disingenuous Assertions" release.
175
176 This is a new development release, starting the 1.7.x branch. D-Bus 1.6
177 remains the recommended version for long-term-supported distributions
178 or the upcoming GNOME 3.8 release.
179
180 Build-time configuration changes:
181
182 • The --with-dbus-session-bus-default-address configure option is no longer
183   supported. Use the new --with-dbus-session-bus-connect-address and
184   --with-dbus-session-bus-listen-address options instead. On Windows, you
185   usually want them to have the same argument; on Unix, the defaults are
186   usually correct.
187
188 • Similarly, the DBUS_SESSION_BUS_DEFAULT_ADDRESS CMake variable is no longer
189   supported; use the new DBUS_SESSION_BUS_LISTEN_ADDRESS and
190   DBUS_SESSION_BUS_CONNECT_ADDRESS variables instead.
191
192 • cmake/cross-compile.sh has been removed. Instead, please use a
193   cross-toolchain file (-DCMAKE_TOOLCHAIN_FILE) as documented at
194   <http://www.vtk.org/Wiki/CMake_Cross_Compiling>; or use Autotools
195   as documented in "info automake Cross-Compilation", and set
196   PKG_CONFIG_PATH appropriately.
197
198 Requirements:
199
200 • Man pages now require xmlto (or either xmlto or meinproc, if using CMake).
201 • man2html is no longer used.
202
203 Enhancements:
204
205 • D-Bus Specification 0.20
206   · actually say that /org/freedesktop/DBus is the object that
207     implements o.fd.DBus (fd.o #51865, Colin Walters)
208   · various reorganisation for better clarity (fd.o #38252, Simon McVittie)
209   · stop claiming that all basic types work just like INT32 (strings don't!)
210
211 • The "source code" for the man pages is now Docbook XML, eliminating
212   the outdated duplicate copies used when building with CMake.
213   (fd.o #59805; Ralf Habacker, Simon McVittie)
214
215 Fixes:
216
217 • In the activation helper, when compiled for tests, do not reset the system
218   bus address, fixing the regression tests. (fd.o #52202, Simon)
219
220 • Fix building with Valgrind 3.8, at the cost of causing harmless warnings
221   with Valgrind 3.6 on some compilers (fd.o #55932, Arun Raghavan)
222
223 • Merge <servicehelper> from system-local.conf if necessary (fd.o #51560,
224   Krzysztof Konopko)
225
226 • Under CMake, prefer xmlto over meinproc (fd.o #59733, Ralf Habacker)
227
228 • Stop duplicating CMake's own logic to find libexpat
229   (fd.o #59733, Ralf Habacker)
230
231 • Don't assume CMake host and build system are the same (fd.o #59733,
232   Ralf Habacker)
233
234 • Avoid deprecation warnings for GLib 2.35 (fd.o #59971, Simon McVittie)
235
236 • Unix-specific:
237   · Check for functions in libpthread correctly, fixing compilation on
238     (at least) OpenBSD (fd.o #47239, Simon)
239   · Don't leak temporary fds pointing to /dev/null (fd.o #56927,
240     Michel HERMIER)
241   · Update sd-daemon.[ch] from systemd (fd.o #60681)
242   · Add partial support for QNX (fd.o #60339, fd.o #61176; Matt Fischer)
243
244 • Windows-specific:
245   · The default session bus listening and connecting address is now
246     "autolaunch:", which makes D-Bus on Windows interoperate with itself
247     and GDBus "out of the box". Use the configure options and cmake variables
248     described above if you require a different autolaunch scope.
249     (fd.o #38201, Simon McVittie)
250   · Avoid a CMake warning under Cygwin (fd.o #59401, Ralf Habacker)
251
252 • Create session.d, system.d directories under CMake (fd.o #41319,
253   Ralf Habacker)
254
255 D-Bus 1.6.8 (2012-09-28)
256 ==
257
258 The "Fix one thing, break another" release.
259
260 • Follow up to CVE-2012-3524: The additional hardening
261   work to use __secure_getenv() as a followup to bug #52202
262   broke certain configurations of gnome-keyring.  Given
263   the difficulty of making this work without extensive
264   changes to gnome-keyring, use of __secure_getenv() is
265   deferred.
266
267 D-Bus 1.6.6 (2012-09-28)
268 ==
269
270 The "Clear the environment in your setuid binaries, please" release.
271
272 • CVE-2012-3524: Don't access environment variables (fd.o #52202)
273   Thanks to work and input from Colin Walters, Simon McVittie,
274   Geoffrey Thomas, and others.
275 • Unix-specific:
276   · Fix compilation on Solaris (fd.o #53286, Jonathan Perkin)
277   · Work around interdependent headers on OpenBSD by including sys/types.h
278     before each use of sys/socket.h (fd.o #54418, Brad Smith)
279
280 D-Bus 1.6.4 (2012-07-18)
281 ==
282
283 • Detect that users are "at the console" correctly when configured with
284   a non-default path such as --enable-console-auth-dir=/run/console
285   (fd.o #51521, Dave Reisner)
286
287 • Remove an incorrect assertion from DBusTransport (fd.o #51657,
288   Simon McVittie)
289
290 • Make --enable-developer default to "no" (regression in 1.6.2;
291   fd.o #51657, Simon McVittie)
292
293 • Windows-specific:
294   · Launch dbus-daemon correctly if its path contains a space
295     (fd.o #49450, Wolfgang Baron)
296
297 D-Bus 1.6.2 (2012-06-27)
298 ==
299
300 The "Ice Cabbage" release.
301
302 • Change how we create /var/lib/dbus so it works under Automake >= 1.11.4
303   (fd.o #51406, Simon McVittie)
304
305 • Don't return from dbus_pending_call_set_notify with a lock held on OOM
306   (fd.o #51032, Simon McVittie)
307
308 • Disconnect "developer mode" (assertions, verbose mode etc.) from
309   Automake maintainer mode. D-Bus developers should now configure with
310   --enable-developer. Automake maintainer mode is now on by default;
311   distributions can disable it with --disable-maintainer-mode.
312   (fd.o #34671, Simon McVittie)
313
314 • Automatically define DBUS_STATIC_BUILD in static-only Autotools builds,
315   fixing linking when targeting Windows (fd.o #33973; william, Simon McVittie)
316
317 • Unix-specific:
318   · Check for libpthread under CMake on Unix (fd.o #47237, Simon McVittie)
319
320 D-Bus 1.6.0 (2012-06-05)
321 ==
322
323 The “soul of this machine has improved” release.
324
325 This version starts a new stable branch of D-Bus: only bug fixes will
326 be accepted into 1.6.x. Other changes will now go to the 1.7.x branch.
327
328 Summary of changes since 1.4.x:
329
330 • New requirements
331   · PTHREAD_MUTEX_RECURSIVE on Unix
332   · compiler support for 64-bit integers (int64_t or equivalent)
333
334 • D-Bus Specification v0.19
335
336 • New dbus-daemon features
337   · <allow own_prefix="com.example.Service"/> rules allow the service to
338     own names like com.example.Service.Instance3
339   · optional systemd integration when checking at_console policies
340   · --nopidfile option, mainly for use by systemd
341   · path_namespace and arg0namespace may appear in match rules
342   · eavesdropping is disabled unless the match rule contains eavesdrop=true
343
344 • New public API
345   · functions to validate various string types (dbus_validate_path() etc.)
346   · dbus_type_is_valid()
347   · DBusBasicValue, a union of every basic type
348
349 • Bug fixes
350   · removed an unsafe reimplementation of recursive mutexes
351   · dbus-daemon no longer busy-loops if it has far too many file descriptors
352   · dbus-daemon.exe --print-address works on Windows
353   · all the other bug fixes from 1.4.20
354
355 • Other major implementation changes
356   · on Linux, dbus-daemon uses epoll if supported, for better scalability
357   · dbus_threads_init() ignores its argument and behaves like
358     dbus_threads_init_default() instead
359   · removed the per-connection link cache, improving dbus-daemon performance
360
361 • Developer features
362   · optional Valgrind instrumentation (--with-valgrind)
363   · optional Stats interface on the dbus-daemon (--enable-stats)
364   · optionally abort whenever malloc() fails (--enable-embedded-tests
365     and export DBUS_MALLOC_CANNOT_FAIL=1)
366
367 Changes since 1.5.12:
368
369 • Be more careful about monotonic time vs. real time, fixing DBUS_COOKIE_SHA1
370   spec-compliance (fd.o #48580, David Zeuthen)
371
372 • Don't use install(1) within the source/build trees, fixing the build as
373   non-root when using OpenBSD install(1) (fd.o #48217, Antoine Jacoutot)
374
375 • Add missing commas in some tcp and nonce-tcp addresses, and remove
376   an unused duplicate copy of the nonce-tcp transport in Windows builds
377   (fd.o #45896, Simon McVittie)
378
379 D-Bus 1.5.12 (2012-03-27)
380 ==
381
382 The “Big Book of Science” release.
383
384 • Add public API to validate various string types:
385   dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
386   dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
387   (fd.o #39549, Simon McVittie)
388
389 • Turn DBusBasicValue into public API so bindings don't need to invent their
390   own "union of everything" type (fd.o #11191, Simon McVittie)
391
392 • Enumerate data files included in the build rather than using find(1)
393   (fd.o #33840, Simon McVittie)
394
395 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
396   in dbus-daemon (fd.o #46273, Alban Crequy)
397
398 • Windows-specific:
399   · make dbus-daemon.exe --print-address (and --print-pid) work again
400     on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
401   · fix duplicate case value when compiling against mingw-w64
402     (fd.o #47321, Andoni Morales Alastruey)
403
404 D-Bus 1.5.10 (2012-02-21)
405 ==
406
407 The "fire in Delerium" release.
408
409 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
410 and SUSv2) is now required.
411
412 • D-Bus Specification 0.19:
413   · Formally define unique connection names and well-known bus names,
414     and document best practices for interface, bus, member and error names,
415     and object paths (fd.o #37095, Simon McVittie)
416   · Document the search path for session and system services on Unix, and
417     where they should be installed by build systems (fd.o #21620, fd.o #35306;
418     Simon McVittie)
419   · Document the systemd transport (fd.o #35232, Lennart Poettering)
420
421 • Make dbus_threads_init() use the same built-in threading implementation
422   as dbus_threads_init_default(); the user-specified primitives that it
423   takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
424
425 • Allow all configured auth mechanisms, not just one (fd.o #45106,
426   Pavel Strashkin)
427
428 • Improve cmake build system (Ralf Habacker):
429   · simplify XML parser dependencies (fd.o #41027)
430   · generate build timestamp (fd.o #41029)
431   · only create batch files on Windows
432   · fix option and cache syntax
433   · add help-options target
434   · share dbus-arch-deps.h.in with autotools rather than having our
435     own version (fd.o #41033)
436
437 • Build tests successfully with older GLib, as found in e.g. Debian 6
438   (fd.o #41219, Simon McVittie)
439
440 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
441
442 • Build documentation correctly if man2html doesn't support filenames on
443   its command-line (fd.o #43875, Jack Nagel)
444
445 • Improve test coverage. To get even more coverage, run the tests with
446   DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
447
448 • Reduce the size of the shared library by moving functionality only used
449   by dbus-daemon, tests etc. into their internal library and deleting
450   unused code (fd.o #34976, #39759; Simon McVittie)
451
452 • Add dbus-daemon --nopidfile option, overriding the configuration, for
453   setups where the default configuration must include <pidfile/> to avoid
454   breaking traditional init, but the pid file is in fact unnecessary; use
455   it under systemd to improve startup time a bit (fd.o #45520,
456   Lennart Poettering)
457
458 • Optionally (if configured --with-valgrind) add instrumentation to debug
459   libdbus and associated tools more meaningfully under Valgrind
460   (fd.o #37286, Simon McVittie)
461
462 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
463
464 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
465
466 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
467   abort on failure to malloc() (like GLib does), to turn runaway memory leaks
468   into a debuggable core-dump if a resource limit is applied (fd.o #41048,
469   Simon McVittie)
470
471 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
472   Simon McVittie)
473
474 • Unix-specific:
475   · Replace our broken reimplementation of recursive mutexes, which has
476     been broken since 2006, with an ordinary pthreads recursive mutex
477     (fd.o #43744; Sigmund Augdal, Simon McVittie)
478   · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
479     welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
480     event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
481   · When running under systemd, use it instead of ConsoleKit to check
482     whether to apply at_console policies (fd.o #39609, Lennart Poettering)
483   · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
484   · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
485   · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
486     (fd.o #41218, Simon McVittie)
487   · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
488     helper doesn't obey environment variables to avoid privilege escalation
489     attacks, so make the system bus follow the same rules
490     (fd.o #21620, Simon McVittie)
491
492 • Windows-specific:
493   · Find the dbus-daemon executable next to the shared library (fd.o #41558;
494     Jesper Dam, Ralf Habacker)
495   · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
496     Simon McVittie)
497
498 D-Bus 1.5.8 (2011-09-21)
499 ==
500
501 The "cross-metering" release.
502
503 In addition to dead code removal and refactoring, this release contains all
504 of the bugfixes from 1.4.16.
505
506 • Clean up dead code, and make more warnings fatal in development builds
507   (fd.o #39231, fd.o #41012; Simon McVittie)
508
509 • If full test coverage is requested via --enable-tests, strictly require
510   Python, pygobject and dbus-python, which are required by some tests; if not,
511   and Python is missing, skip those tests rather than failing
512   (fd.o #37847, Simon McVittie)
513
514 • When using cmake, provide the same version-info API in the installed headers
515   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
516
517 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
518
519 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
520
521 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
522   Simon McVittie)
523
524 • Fix duplicates in authors list (Ralf Habacker)
525
526 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
527   (fd.o #39879, Chris Mayo)
528
529 • Fix a small memory leak, and a failure to report errors, when updating
530   a service file entry for activation (fd.o #39230, Simon McVittie)
531
532 • Unix-specific:
533   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
534     Brian Cameron, Simon McVittie)
535   · On systems that use libcap-ng but not systemd, drop supplemental groups
536     when switching to the daemon user (Red Hat #726953, Steve Grubb)
537   · Make the cmake build work again on GNU platforms (fd.o #29228,
538     Simon McVittie)
539   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
540     like Solaris (fd.o #40313, Dagobert Michelsen)
541   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
542     (fd.o #40235, Simon McVittie)
543   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
544     (fd.o #39987, Simon McVittie)
545   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
546     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
547
548 • Windows-specific:
549   · Fix compilation on MSVC, which doesn't understand "inline" with its
550     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
551   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
552   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
553
554 D-Bus 1.5.6 (2011-07-29)
555 ==
556
557 The "weird, gravy-like aftertaste" release.
558
559 In addition to new features and refactoring, this release contains all of the
560 bugfixes from 1.4.14.
561
562 Potentially incompatible (Bustle and similar debugging tools will need
563 changes to work as intended):
564
565 • Do not allow match rules to "eavesdrop" (receive messages intended for a
566   different recipient) by mistake: eavesdroppers must now opt-in to this
567   behaviour by putting "eavesdrop='true'" in the match rule, which will
568   not have any practical effect on buses where eavesdropping is not allowed
569   (fd.o #37890, Cosimo Alfarano)
570
571 Other changes:
572
573 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
574   Cosimo Alfarano, Simon McVittie)
575   · add the "eavesdrop" keyword to match rules
576   · define eavesdropping, unicast messages and broadcast messages
577   · stop claiming that match rules are needed to match unicast messages to you
578   · promote the type system to be a top-level section
579
580 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
581   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
582   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
583
584 • Consistently use atomic operations on everything that is ever manipulated
585   via atomic ops, as was done for changes to DBusConnection's refcount in
586   1.4.12 (fd.o #38005, Simon McVittie)
587
588 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
589   Simon McVittie)
590
591 • Make "make check" in a clean tree work, by not running tests until
592   test data has been set up (fd.o #34405, Simon McVittie)
593
594 • The dbus-daemon no longer busy-loops if it has a very large number of file
595   descriptors (fd.o #23194, Simon McVittie)
596
597 • Refactor message flow through dispatching to avoid locking violations if
598   the bus daemon's message limit is hit; remove the per-connection link cache,
599   which was meant to improve performance, but now reduces it (fd.o #34393,
600   Simon McVittie)
601
602 • Some cmake fixes (Ralf Habacker)
603
604 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
605   Simon McVittie, Lennart Poettering)
606
607 • Stop storing two extra byte order indicators in each D-Bus message
608   (fd.o #38287, Simon McVittie)
609
610 • Add an optional Stats interface which can be used to get statistics from
611   a running dbus-daemon if enabled at configure time with --enable-stats
612   (fd.o #34040, Simon McVittie)
613
614 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
615
616 • Documentation (fd.o #36156, Simon McVittie):
617   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
618   · install more documentation automatically, including man2html output
619   · put dbus.devhelp in the right place (it must go in ${htmldir})
620
621 • Unix-specific:
622   · look for system services in /lib/dbus-1/system-services in addition to all
623     the other well-known locations; note that this should always be /lib,
624     even on platforms where shared libraries on the root FS would go in /lib64,
625     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
626   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
627
628 • Windows-specific (Ralf Habacker):
629   · fix use of a mutex for autolaunch server detection
630   · don't crash on malloc failure in _dbus_printf_string_upper_bound
631
632 D-Bus 1.5.4 (2011-06-10)
633 ==
634
635 Security (local denial of service):
636
637 • Byte-swap foreign-endian messages correctly, preventing a long-standing
638   local DoS if foreign-endian messages are relayed through the dbus-daemon
639   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
640   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
641
642 New things:
643
644 • The constant to use for an infinite timeout now has a name,
645   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
646   which can be used for source compatibility with older versions of libdbus.
647
648 • If GLib and DBus-GLib are already installed, more tests will be built,
649   providing better coverage. The new tests can also be installed via
650       ./configure --enable-installed-tests
651   for system integration testing, if required. (fd.o #34570, Simon McVittie)
652
653 Changes:
654
655 • Consistently use atomic operations for the DBusConnection's refcount,
656   fixing potential threading problems (fd.o #38005, Simon McVittie)
657
658 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
659   small (300KiB on x86-64) and it frequently doesn't work in unusual
660   toolchains. To optimize for minimum installed size, you should benchmark
661   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
662   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
663
664 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
665   (fd.o #35880, Timothy Redaelli)
666
667 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
668   when not using a DESTDIR (fd.o #37870, Simon McVittie)
669
670 • Windows-specific changes:
671   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
672
673 D-Bus 1.5.2 (2011-06-01)
674 ==
675
676 The "Boar Hunter" release.
677
678 Notes for distributors:
679
680   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
681   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
682   toolchain supports it reliably, via something like:
683
684     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
685
686   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
687
688 Changes:
689
690   • D-Bus Specification v0.17
691     · Reserve the extra characters used in signatures by GVariant
692       (fd.o #34529, Simon McVittie)
693     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
694   • Don't force -fPIE: distributions and libtool know better than we do whether
695     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
696   • Allow --disable-gc-sections, in case your toolchain offers the
697     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
698     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
699   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
700     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
701   • Ensure that maintainers upload documentation with the right permissions
702     (fd.o #36130, Simon McVittie)
703   • Don't force users of libdbus to be linked against -lpthread, -lrt
704     (fd.o #32827, Simon McVittie)
705   • Log system-bus activation information to syslog (fd.o #35705,
706     Colin Walters)
707   • Log messages dropped due to quotas to syslog (fd.o #35358,
708     Simon McVittie)
709   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
710   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
711     (fd.o #35228, Lennart Poettering)
712   • In the regression tests, don't report fds as "leaked" if they were open
713     on startup (fd.o #35173, Simon McVittie)
714   • Make dbus-monitor bail out if asked to monitor more than one bus,
715     rather than silently using the last one (fd.o #26548, Will Thompson)
716   • Clarify documentation (fd.o #35182, Simon McVittie)
717   • Clean up minor dead code and some incorrect error handling
718     (fd.o #33128, fd.o #29881; Simon McVittie)
719   • Check that compiler options are supported before using them (fd.o #19681,
720     Simon McVittie)
721   • Windows:
722     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
723
724 D-Bus 1.5.0 (2011-04-11)
725 ==
726
727 The "you never know when you need to tow something from your giant
728 flying shark" release.
729
730   • D-Bus Specification v0.16
731     · Add support for path_namespace and arg0namespace in match rules
732       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
733     · Make argNpath support object paths, not just object-path-like strings,
734       and document it better (fd.o #31818, Will Thompson)
735   • Let the bus daemon implement more than one interface (fd.o #33757,
736     Simon McVittie)
737   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
738     Roberto Guido)
739   • Require user intervention to compile with missing 64-bit support
740     (fd.o #35114, Simon McVittie)
741   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
742   • Raise UnknownObject instead of UnknownMethod for calls to methods on
743     paths that are not part of the object tree, and UnknownInterface for calls
744     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
745
746 D-Bus 1.4.8 (2011-04-08)
747 ==
748
749 The "It's like the beginning of a lobster" release.
750
751   • Rename configure.in to configure.ac, and update it to modern conventions
752     (fd.o #32245; Javier Jardón, Simon McVittie)
753   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
754     Anders Kaseorg)
755   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
756     --disable-x11-autolaunch configure option to prevent it altogether
757     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
758   • Install the documentation, and an index for Devhelp (fd.o #13495,
759     Debian #454142; Simon McVittie, Matthias Clasen)
760   • If checks are not disabled, check validity of string-like types and
761     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
762   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
763     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
764   • Break up a huge conditional in config-parser so gcov can produce coverage
765     data (fd.o #10887, Simon McVittie)
766   • List which parts of the Desktop Entry specification are applicable to
767     .service files (fd.o #19159, Sven Herzberg)
768   • Don't suppress service activation if two services have the same Exec=
769     (fd.o #35750, Colin Walters)
770   • Windows:
771     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
772       (Andre Heinecke)
773     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
774       (fd.o #32805, Mark Brand)
775
776 D-Bus 1.4.6 (2010-02-17)
777 ==
778
779 The "1, 2, miss a few, 99, 100" release.
780
781   • Remove unfinished changes intended to support GTest-based tests,
782     which were mistakenly included in 1.4.4
783
784 D-Bus 1.4.4 (2010-02-17)
785 ==
786
787   • Switch back to using even micro versions for stable releases; 1.4.1
788     should have been called 1.4.2, so skip that version number
789   • Don't leave bad file descriptors being watched when spawning processes,
790     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
791     also LP#656134, LP#680444, LP#713157)
792   • Check for MSG_NOSIGNAL correctly
793   • Fix failure to detect abstract socket support (fd.o #29895)
794   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
795     (fd.o #32262, NB#180486)
796   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
797     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
798   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
799   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
800   • Improve gcc malloc annotations (fd.o #32710)
801   • If the system bus is launched via systemd, protect it from the OOM killer
802   • Documentation improvements (fd.o #11190)
803   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
804     fd.o #15922, LP#241619)
805   • Cope with invalid files in session.d, system.d (fd.o #19186,
806     Debian #230231)
807   • Don't distribute generated files that embed our builddir (fd.o #30285,
808     fd.o #34292)
809   • Raise the system bus's fd limit to be sufficient for its configuration
810     (fd.o #33474, LP#381063)
811   • Fix syslog string processing
812   • Ignore -Waddress
813   • Remove broken gcov parsing code and --enable-gcov, and replace them
814     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
815   • Windows:
816     · avoid live-lock in Windows CE due to unfair condition variables
817   • OpenBSD:
818     · support credentials-passing (fd.o #32542)
819   • Solaris:
820     · opt-in to thread safety (fd.o #33464)
821
822 D-Bus 1.4.1 (20 December 2010)
823 ==
824
825  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
826    crash the bus. The existing restriction to 64-levels of nesting previously
827    only applied to the static type signature; now it also applies to dynamic
828    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
829    issue.
830  • OS X portability fixes, including launchd support.
831  • Windows autolaunch improvements.
832  • Various bug fixes.
833
834 D-Bus 1.4.0 (6 Sep 2010)
835 ==
836  - systemd hookup
837
838 D-Bus 1.3.1 (23 June 2010)
839 ==
840  - New standardized PropertiesChanged signal in the properties interface
841  - Various portability fixes, in particular to Windows platforms
842  - Support forking bus services, for compatibility
843
844 D-Bus 1.3.0 (29 July 2009)
845 ==
846  - ability for dbus-send to send to any bus (--address)
847  - file descriptor passing on Unix socket transports
848  - use of GCC atomic intrinsics for better processor support
849    (requires -march=i486 or above for x86 compilation)
850  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
851    and glibc (2.9 for pipe2 and 2.10 for accept4)
852  - feature negotiation in the bus daemon