1.5.13
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.5.14 (UNRELEASED)
2 ==
3
4 ...
5
6 D-Bus 1.5.12 (2012-03-27)
7 ==
8
9 The “Big Book of Science” release.
10
11 • Add public API to validate various string types:
12   dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
13   dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
14   (fd.o #39549, Simon McVittie)
15
16 • Turn DBusBasicValue into public API so bindings don't need to invent their
17   own "union of everything" type (fd.o #11191, Simon McVittie)
18
19 • Enumerate data files included in the build rather than using find(1)
20   (fd.o #33840, Simon McVittie)
21
22 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
23   in dbus-daemon (fd.o #46273, Alban Crequy)
24
25 • Windows-specific:
26   · make dbus-daemon.exe --print-address (and --print-pid) work again
27     on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
28   · fix duplicate case value when compiling against mingw-w64
29     (fd.o #47321, Andoni Morales Alastruey)
30
31 D-Bus 1.5.10 (2012-02-21)
32 ==
33
34 The "fire in Delerium" release.
35
36 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
37 and SUSv2) is now required.
38
39 • D-Bus Specification 0.19:
40   · Formally define unique connection names and well-known bus names,
41     and document best practices for interface, bus, member and error names,
42     and object paths (fd.o #37095, Simon McVittie)
43   · Document the search path for session and system services on Unix, and
44     where they should be installed by build systems (fd.o #21620, fd.o #35306;
45     Simon McVittie)
46   · Document the systemd transport (fd.o #35232, Lennart Poettering)
47
48 • Make dbus_threads_init() use the same built-in threading implementation
49   as dbus_threads_init_default(); the user-specified primitives that it
50   takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
51
52 • Allow all configured auth mechanisms, not just one (fd.o #45106,
53   Pavel Strashkin)
54
55 • Improve cmake build system (Ralf Habacker):
56   · simplify XML parser dependencies (fd.o #41027)
57   · generate build timestamp (fd.o #41029)
58   · only create batch files on Windows
59   · fix option and cache syntax
60   · add help-options target
61   · share dbus-arch-deps.h.in with autotools rather than having our
62     own version (fd.o #41033)
63
64 • Build tests successfully with older GLib, as found in e.g. Debian 6
65   (fd.o #41219, Simon McVittie)
66
67 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
68
69 • Build documentation correctly if man2html doesn't support filenames on
70   its command-line (fd.o #43875, Jack Nagel)
71
72 • Improve test coverage. To get even more coverage, run the tests with
73   DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
74
75 • Reduce the size of the shared library by moving functionality only used
76   by dbus-daemon, tests etc. into their internal library and deleting
77   unused code (fd.o #34976, #39759; Simon McVittie)
78
79 • Add dbus-daemon --nopidfile option, overriding the configuration, for
80   setups where the default configuration must include <pidfile/> to avoid
81   breaking traditional init, but the pid file is in fact unnecessary; use
82   it under systemd to improve startup time a bit (fd.o #45520,
83   Lennart Poettering)
84
85 • Optionally (if configured --with-valgrind) add instrumentation to debug
86   libdbus and associated tools more meaningfully under Valgrind
87   (fd.o #37286, Simon McVittie)
88
89 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
90
91 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
92
93 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
94   abort on failure to malloc() (like GLib does), to turn runaway memory leaks
95   into a debuggable core-dump if a resource limit is applied (fd.o #41048,
96   Simon McVittie)
97
98 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
99   Simon McVittie)
100
101 • Unix-specific:
102   · Replace our broken reimplementation of recursive mutexes, which has
103     been broken since 2006, with an ordinary pthreads recursive mutex
104     (fd.o #43744; Sigmund Augdal, Simon McVittie)
105   · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
106     welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
107     event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
108   · When running under systemd, use it instead of ConsoleKit to check
109     whether to apply at_console policies (fd.o #39609, Lennart Poettering)
110   · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
111   · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
112   · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
113     (fd.o #41218, Simon McVittie)
114   · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
115     helper doesn't obey environment variables to avoid privilege escalation
116     attacks, so make the system bus follow the same rules
117     (fd.o #21620, Simon McVittie)
118
119 • Windows-specific:
120   · Find the dbus-daemon executable next to the shared library (fd.o #41558;
121     Jesper Dam, Ralf Habacker)
122   · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
123     Simon McVittie)
124
125 D-Bus 1.5.8 (2011-09-21)
126 ==
127
128 The "cross-metering" release.
129
130 In addition to dead code removal and refactoring, this release contains all
131 of the bugfixes from 1.4.16.
132
133 • Clean up dead code, and make more warnings fatal in development builds
134   (fd.o #39231, fd.o #41012; Simon McVittie)
135
136 • If full test coverage is requested via --enable-tests, strictly require
137   Python, pygobject and dbus-python, which are required by some tests; if not,
138   and Python is missing, skip those tests rather than failing
139   (fd.o #37847, Simon McVittie)
140
141 • When using cmake, provide the same version-info API in the installed headers
142   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
143
144 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
145
146 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
147
148 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
149   Simon McVittie)
150
151 • Fix duplicates in authors list (Ralf Habacker)
152
153 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
154   (fd.o #39879, Chris Mayo)
155
156 • Fix a small memory leak, and a failure to report errors, when updating
157   a service file entry for activation (fd.o #39230, Simon McVittie)
158
159 • Unix-specific:
160   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
161     Brian Cameron, Simon McVittie)
162   · On systems that use libcap-ng but not systemd, drop supplemental groups
163     when switching to the daemon user (Red Hat #726953, Steve Grubb)
164   · Make the cmake build work again on GNU platforms (fd.o #29228,
165     Simon McVittie)
166   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
167     like Solaris (fd.o #40313, Dagobert Michelsen)
168   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
169     (fd.o #40235, Simon McVittie)
170   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
171     (fd.o #39987, Simon McVittie)
172   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
173     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
174
175 • Windows-specific:
176   · Fix compilation on MSVC, which doesn't understand "inline" with its
177     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
178   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
179   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
180
181 D-Bus 1.5.6 (2011-07-29)
182 ==
183
184 The "weird, gravy-like aftertaste" release.
185
186 In addition to new features and refactoring, this release contains all of the
187 bugfixes from 1.4.14.
188
189 Potentially incompatible (Bustle and similar debugging tools will need
190 changes to work as intended):
191
192 • Do not allow match rules to "eavesdrop" (receive messages intended for a
193   different recipient) by mistake: eavesdroppers must now opt-in to this
194   behaviour by putting "eavesdrop='true'" in the match rule, which will
195   not have any practical effect on buses where eavesdropping is not allowed
196   (fd.o #37890, Cosimo Alfarano)
197
198 Other changes:
199
200 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
201   Cosimo Alfarano, Simon McVittie)
202   · add the "eavesdrop" keyword to match rules
203   · define eavesdropping, unicast messages and broadcast messages
204   · stop claiming that match rules are needed to match unicast messages to you
205   · promote the type system to be a top-level section
206
207 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
208   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
209   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
210
211 • Consistently use atomic operations on everything that is ever manipulated
212   via atomic ops, as was done for changes to DBusConnection's refcount in
213   1.4.12 (fd.o #38005, Simon McVittie)
214
215 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
216   Simon McVittie)
217
218 • Make "make check" in a clean tree work, by not running tests until
219   test data has been set up (fd.o #34405, Simon McVittie)
220
221 • The dbus-daemon no longer busy-loops if it has a very large number of file
222   descriptors (fd.o #23194, Simon McVittie)
223
224 • Refactor message flow through dispatching to avoid locking violations if
225   the bus daemon's message limit is hit; remove the per-connection link cache,
226   which was meant to improve performance, but now reduces it (fd.o #34393,
227   Simon McVittie)
228
229 • Some cmake fixes (Ralf Habacker)
230
231 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
232   Simon McVittie, Lennart Poettering)
233
234 • Stop storing two extra byte order indicators in each D-Bus message
235   (fd.o #38287, Simon McVittie)
236
237 • Add an optional Stats interface which can be used to get statistics from
238   a running dbus-daemon if enabled at configure time with --enable-stats
239   (fd.o #34040, Simon McVittie)
240
241 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
242
243 • Documentation (fd.o #36156, Simon McVittie):
244   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
245   · install more documentation automatically, including man2html output
246   · put dbus.devhelp in the right place (it must go in ${htmldir})
247
248 • Unix-specific:
249   · look for system services in /lib/dbus-1/system-services in addition to all
250     the other well-known locations; note that this should always be /lib,
251     even on platforms where shared libraries on the root FS would go in /lib64,
252     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
253   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
254
255 • Windows-specific (Ralf Habacker):
256   · fix use of a mutex for autolaunch server detection
257   · don't crash on malloc failure in _dbus_printf_string_upper_bound
258
259 D-Bus 1.5.4 (2011-06-10)
260 ==
261
262 Security (local denial of service):
263
264 • Byte-swap foreign-endian messages correctly, preventing a long-standing
265   local DoS if foreign-endian messages are relayed through the dbus-daemon
266   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
267   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
268
269 New things:
270
271 • The constant to use for an infinite timeout now has a name,
272   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
273   which can be used for source compatibility with older versions of libdbus.
274
275 • If GLib and DBus-GLib are already installed, more tests will be built,
276   providing better coverage. The new tests can also be installed via
277       ./configure --enable-installed-tests
278   for system integration testing, if required. (fd.o #34570, Simon McVittie)
279
280 Changes:
281
282 • Consistently use atomic operations for the DBusConnection's refcount,
283   fixing potential threading problems (fd.o #38005, Simon McVittie)
284
285 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
286   small (300KiB on x86-64) and it frequently doesn't work in unusual
287   toolchains. To optimize for minimum installed size, you should benchmark
288   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
289   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
290
291 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
292   (fd.o #35880, Timothy Redaelli)
293
294 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
295   when not using a DESTDIR (fd.o #37870, Simon McVittie)
296
297 • Windows-specific changes:
298   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
299
300 D-Bus 1.5.2 (2011-06-01)
301 ==
302
303 The "Boar Hunter" release.
304
305 Notes for distributors:
306
307   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
308   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
309   toolchain supports it reliably, via something like:
310
311     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
312
313   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
314
315 Changes:
316
317   • D-Bus Specification v0.17
318     · Reserve the extra characters used in signatures by GVariant
319       (fd.o #34529, Simon McVittie)
320     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
321   • Don't force -fPIE: distributions and libtool know better than we do whether
322     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
323   • Allow --disable-gc-sections, in case your toolchain offers the
324     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
325     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
326   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
327     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
328   • Ensure that maintainers upload documentation with the right permissions
329     (fd.o #36130, Simon McVittie)
330   • Don't force users of libdbus to be linked against -lpthread, -lrt
331     (fd.o #32827, Simon McVittie)
332   • Log system-bus activation information to syslog (fd.o #35705,
333     Colin Walters)
334   • Log messages dropped due to quotas to syslog (fd.o #35358,
335     Simon McVittie)
336   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
337   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
338     (fd.o #35228, Lennart Poettering)
339   • In the regression tests, don't report fds as "leaked" if they were open
340     on startup (fd.o #35173, Simon McVittie)
341   • Make dbus-monitor bail out if asked to monitor more than one bus,
342     rather than silently using the last one (fd.o #26548, Will Thompson)
343   • Clarify documentation (fd.o #35182, Simon McVittie)
344   • Clean up minor dead code and some incorrect error handling
345     (fd.o #33128, fd.o #29881; Simon McVittie)
346   • Check that compiler options are supported before using them (fd.o #19681,
347     Simon McVittie)
348   • Windows:
349     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
350
351 D-Bus 1.5.0 (2011-04-11)
352 ==
353
354 The "you never know when you need to tow something from your giant
355 flying shark" release.
356
357   • D-Bus Specification v0.16
358     · Add support for path_namespace and arg0namespace in match rules
359       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
360     · Make argNpath support object paths, not just object-path-like strings,
361       and document it better (fd.o #31818, Will Thompson)
362   • Let the bus daemon implement more than one interface (fd.o #33757,
363     Simon McVittie)
364   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
365     Roberto Guido)
366   • Require user intervention to compile with missing 64-bit support
367     (fd.o #35114, Simon McVittie)
368   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
369   • Raise UnknownObject instead of UnknownMethod for calls to methods on
370     paths that are not part of the object tree, and UnknownInterface for calls
371     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
372
373 D-Bus 1.4.8 (2011-04-08)
374 ==
375
376 The "It's like the beginning of a lobster" release.
377
378   • Rename configure.in to configure.ac, and update it to modern conventions
379     (fd.o #32245; Javier Jardón, Simon McVittie)
380   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
381     Anders Kaseorg)
382   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
383     --disable-x11-autolaunch configure option to prevent it altogether
384     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
385   • Install the documentation, and an index for Devhelp (fd.o #13495,
386     Debian #454142; Simon McVittie, Matthias Clasen)
387   • If checks are not disabled, check validity of string-like types and
388     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
389   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
390     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
391   • Break up a huge conditional in config-parser so gcov can produce coverage
392     data (fd.o #10887, Simon McVittie)
393   • List which parts of the Desktop Entry specification are applicable to
394     .service files (fd.o #19159, Sven Herzberg)
395   • Don't suppress service activation if two services have the same Exec=
396     (fd.o #35750, Colin Walters)
397   • Windows:
398     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
399       (Andre Heinecke)
400     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
401       (fd.o #32805, Mark Brand)
402
403 D-Bus 1.4.6 (2010-02-17)
404 ==
405
406 The "1, 2, miss a few, 99, 100" release.
407
408   • Remove unfinished changes intended to support GTest-based tests,
409     which were mistakenly included in 1.4.4
410
411 D-Bus 1.4.4 (2010-02-17)
412 ==
413
414   • Switch back to using even micro versions for stable releases; 1.4.1
415     should have been called 1.4.2, so skip that version number
416   • Don't leave bad file descriptors being watched when spawning processes,
417     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
418     also LP#656134, LP#680444, LP#713157)
419   • Check for MSG_NOSIGNAL correctly
420   • Fix failure to detect abstract socket support (fd.o #29895)
421   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
422     (fd.o #32262, NB#180486)
423   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
424     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
425   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
426   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
427   • Improve gcc malloc annotations (fd.o #32710)
428   • If the system bus is launched via systemd, protect it from the OOM killer
429   • Documentation improvements (fd.o #11190)
430   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
431     fd.o #15922, LP#241619)
432   • Cope with invalid files in session.d, system.d (fd.o #19186,
433     Debian #230231)
434   • Don't distribute generated files that embed our builddir (fd.o #30285,
435     fd.o #34292)
436   • Raise the system bus's fd limit to be sufficient for its configuration
437     (fd.o #33474, LP#381063)
438   • Fix syslog string processing
439   • Ignore -Waddress
440   • Remove broken gcov parsing code and --enable-gcov, and replace them
441     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
442   • Windows:
443     · avoid live-lock in Windows CE due to unfair condition variables
444   • OpenBSD:
445     · support credentials-passing (fd.o #32542)
446   • Solaris:
447     · opt-in to thread safety (fd.o #33464)
448
449 D-Bus 1.4.1 (20 December 2010)
450 ==
451
452  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
453    crash the bus. The existing restriction to 64-levels of nesting previously
454    only applied to the static type signature; now it also applies to dynamic
455    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
456    issue.
457  • OS X portability fixes, including launchd support.
458  • Windows autolaunch improvements.
459  • Various bug fixes.
460
461 D-Bus 1.4.0 (6 Sep 2010)
462 ==
463  - systemd hookup
464
465 D-Bus 1.3.1 (23 June 2010)
466 ==
467  - New standardized PropertiesChanged signal in the properties interface
468  - Various portability fixes, in particular to Windows platforms
469  - Support forking bus services, for compatibility
470
471 D-Bus 1.3.0 (29 July 2009)
472 ==
473  - ability for dbus-send to send to any bus (--address)
474  - file descriptor passing on Unix socket transports
475  - use of GCC atomic intrinsics for better processor support
476    (requires -march=i486 or above for x86 compilation)
477  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
478    and glibc (2.9 for pipe2 and 2.10 for accept4)
479  - feature negotiation in the bus daemon