Merge branch 'dbus-1.4'
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.5.10 (UNRELEASED)
2 ==
3
4
5
6 D-Bus 1.5.8 (2011-09-21)
7 ==
8
9 The "cross-metering" release.
10
11 In addition to dead code removal and refactoring, this release contains all
12 of the bugfixes from 1.4.16.
13
14 • Clean up dead code, and make more warnings fatal in development builds
15   (fd.o #39231, fd.o #41012; Simon McVittie)
16
17 • If full test coverage is requested via --enable-tests, strictly require
18   Python, pygobject and dbus-python, which are required by some tests; if not,
19   and Python is missing, skip those tests rather than failing
20   (fd.o #37847, Simon McVittie)
21
22 • When using cmake, provide the same version-info API in the installed headers
23   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
24
25 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
26
27 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
28
29 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
30   Simon McVittie)
31
32 • Fix duplicates in authors list (Ralf Habacker)
33
34 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
35   (fd.o #39879, Chris Mayo)
36
37 • Fix a small memory leak, and a failure to report errors, when updating
38   a service file entry for activation (fd.o #39230, Simon McVittie)
39
40 • Unix-specific:
41   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
42     Brian Cameron, Simon McVittie)
43   · On systems that use libcap-ng but not systemd, drop supplemental groups
44     when switching to the daemon user (Red Hat #726953, Steve Grubb)
45   · Make the cmake build work again on GNU platforms (fd.o #29228,
46     Simon McVittie)
47   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
48     like Solaris (fd.o #40313, Dagobert Michelsen)
49   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
50     (fd.o #40235, Simon McVittie)
51   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
52     (fd.o #39987, Simon McVittie)
53   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
54     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
55
56 • Windows-specific:
57   · Fix compilation on MSVC, which doesn't understand "inline" with its
58     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
59   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
60   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
61
62 D-Bus 1.5.6 (2011-07-29)
63 ==
64
65 The "weird, gravy-like aftertaste" release.
66
67 In addition to new features and refactoring, this release contains all of the
68 bugfixes from 1.4.14.
69
70 Potentially incompatible (Bustle and similar debugging tools will need
71 changes to work as intended):
72
73 • Do not allow match rules to "eavesdrop" (receive messages intended for a
74   different recipient) by mistake: eavesdroppers must now opt-in to this
75   behaviour by putting "eavesdrop='true'" in the match rule, which will
76   not have any practical effect on buses where eavesdropping is not allowed
77   (fd.o #37890, Cosimo Alfarano)
78
79 Other changes:
80
81 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
82   Cosimo Alfarano, Simon McVittie)
83   · add the "eavesdrop" keyword to match rules
84   · define eavesdropping, unicast messages and broadcast messages
85   · stop claiming that match rules are needed to match unicast messages to you
86   · promote the type system to be a top-level section
87
88 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
89   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
90   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
91
92 • Consistently use atomic operations on everything that is ever manipulated
93   via atomic ops, as was done for changes to DBusConnection's refcount in
94   1.4.12 (fd.o #38005, Simon McVittie)
95
96 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
97   Simon McVittie)
98
99 • Make "make check" in a clean tree work, by not running tests until
100   test data has been set up (fd.o #34405, Simon McVittie)
101
102 • The dbus-daemon no longer busy-loops if it has a very large number of file
103   descriptors (fd.o #23194, Simon McVittie)
104
105 • Refactor message flow through dispatching to avoid locking violations if
106   the bus daemon's message limit is hit; remove the per-connection link cache,
107   which was meant to improve performance, but now reduces it (fd.o #34393,
108   Simon McVittie)
109
110 • Some cmake fixes (Ralf Habacker)
111
112 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
113   Simon McVittie, Lennart Poettering)
114
115 • Stop storing two extra byte order indicators in each D-Bus message
116   (fd.o #38287, Simon McVittie)
117
118 • Add an optional Stats interface which can be used to get statistics from
119   a running dbus-daemon if enabled at configure time with --enable-stats
120   (fd.o #34040, Simon McVittie)
121
122 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
123
124 • Documentation (fd.o #36156, Simon McVittie):
125   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
126   · install more documentation automatically, including man2html output
127   · put dbus.devhelp in the right place (it must go in ${htmldir})
128
129 • Unix-specific:
130   · look for system services in /lib/dbus-1/system-services in addition to all
131     the other well-known locations; note that this should always be /lib,
132     even on platforms where shared libraries on the root FS would go in /lib64,
133     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
134   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
135
136 • Windows-specific (Ralf Habacker):
137   · fix use of a mutex for autolaunch server detection
138   · don't crash on malloc failure in _dbus_printf_string_upper_bound
139
140 D-Bus 1.5.4 (2011-06-10)
141 ==
142
143 Security (local denial of service):
144
145 • Byte-swap foreign-endian messages correctly, preventing a long-standing
146   local DoS if foreign-endian messages are relayed through the dbus-daemon
147   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
148   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
149
150 New things:
151
152 • The constant to use for an infinite timeout now has a name,
153   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
154   which can be used for source compatibility with older versions of libdbus.
155
156 • If GLib and DBus-GLib are already installed, more tests will be built,
157   providing better coverage. The new tests can also be installed via
158       ./configure --enable-installed-tests
159   for system integration testing, if required. (fd.o #34570, Simon McVittie)
160
161 Changes:
162
163 • Consistently use atomic operations for the DBusConnection's refcount,
164   fixing potential threading problems (fd.o #38005, Simon McVittie)
165
166 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
167   small (300KiB on x86-64) and it frequently doesn't work in unusual
168   toolchains. To optimize for minimum installed size, you should benchmark
169   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
170   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
171
172 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
173   (fd.o #35880, Timothy Redaelli)
174
175 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
176   when not using a DESTDIR (fd.o #37870, Simon McVittie)
177
178 • Windows-specific changes:
179   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
180
181 D-Bus 1.5.2 (2011-06-01)
182 ==
183
184 The "Boar Hunter" release.
185
186 Notes for distributors:
187
188   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
189   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
190   toolchain supports it reliably, via something like:
191
192     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
193
194   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
195
196 Changes:
197
198   • D-Bus Specification v0.17
199     · Reserve the extra characters used in signatures by GVariant
200       (fd.o #34529, Simon McVittie)
201     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
202   • Don't force -fPIE: distributions and libtool know better than we do whether
203     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
204   • Allow --disable-gc-sections, in case your toolchain offers the
205     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
206     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
207   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
208     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
209   • Ensure that maintainers upload documentation with the right permissions
210     (fd.o #36130, Simon McVittie)
211   • Don't force users of libdbus to be linked against -lpthread, -lrt
212     (fd.o #32827, Simon McVittie)
213   • Log system-bus activation information to syslog (fd.o #35705,
214     Colin Walters)
215   • Log messages dropped due to quotas to syslog (fd.o #35358,
216     Simon McVittie)
217   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
218   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
219     (fd.o #35228, Lennart Poettering)
220   • In the regression tests, don't report fds as "leaked" if they were open
221     on startup (fd.o #35173, Simon McVittie)
222   • Make dbus-monitor bail out if asked to monitor more than one bus,
223     rather than silently using the last one (fd.o #26548, Will Thompson)
224   • Clarify documentation (fd.o #35182, Simon McVittie)
225   • Clean up minor dead code and some incorrect error handling
226     (fd.o #33128, fd.o #29881; Simon McVittie)
227   • Check that compiler options are supported before using them (fd.o #19681,
228     Simon McVittie)
229   • Windows:
230     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
231
232 D-Bus 1.5.0 (2011-04-11)
233 ==
234
235 The "you never know when you need to tow something from your giant
236 flying shark" release.
237
238   • D-Bus Specification v0.16
239     · Add support for path_namespace and arg0namespace in match rules
240       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
241     · Make argNpath support object paths, not just object-path-like strings,
242       and document it better (fd.o #31818, Will Thompson)
243   • Let the bus daemon implement more than one interface (fd.o #33757,
244     Simon McVittie)
245   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
246     Roberto Guido)
247   • Require user intervention to compile with missing 64-bit support
248     (fd.o #35114, Simon McVittie)
249   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
250   • Raise UnknownObject instead of UnknownMethod for calls to methods on
251     paths that are not part of the object tree, and UnknownInterface for calls
252     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
253
254 D-Bus 1.4.8 (2011-04-08)
255 ==
256
257 The "It's like the beginning of a lobster" release.
258
259   • Rename configure.in to configure.ac, and update it to modern conventions
260     (fd.o #32245; Javier Jardón, Simon McVittie)
261   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
262     Anders Kaseorg)
263   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
264     --disable-x11-autolaunch configure option to prevent it altogether
265     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
266   • Install the documentation, and an index for Devhelp (fd.o #13495,
267     Debian #454142; Simon McVittie, Matthias Clasen)
268   • If checks are not disabled, check validity of string-like types and
269     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
270   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
271     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
272   • Break up a huge conditional in config-parser so gcov can produce coverage
273     data (fd.o #10887, Simon McVittie)
274   • List which parts of the Desktop Entry specification are applicable to
275     .service files (fd.o #19159, Sven Herzberg)
276   • Don't suppress service activation if two services have the same Exec=
277     (fd.o #35750, Colin Walters)
278   • Windows:
279     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
280       (Andre Heinecke)
281     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
282       (fd.o #32805, Mark Brand)
283
284 D-Bus 1.4.6 (2010-02-17)
285 ==
286
287 The "1, 2, miss a few, 99, 100" release.
288
289   • Remove unfinished changes intended to support GTest-based tests,
290     which were mistakenly included in 1.4.4
291
292 D-Bus 1.4.4 (2010-02-17)
293 ==
294
295   • Switch back to using even micro versions for stable releases; 1.4.1
296     should have been called 1.4.2, so skip that version number
297   • Don't leave bad file descriptors being watched when spawning processes,
298     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
299     also LP#656134, LP#680444, LP#713157)
300   • Check for MSG_NOSIGNAL correctly
301   • Fix failure to detect abstract socket support (fd.o #29895)
302   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
303     (fd.o #32262, NB#180486)
304   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
305     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
306   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
307   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
308   • Improve gcc malloc annotations (fd.o #32710)
309   • If the system bus is launched via systemd, protect it from the OOM killer
310   • Documentation improvements (fd.o #11190)
311   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
312     fd.o #15922, LP#241619)
313   • Cope with invalid files in session.d, system.d (fd.o #19186,
314     Debian #230231)
315   • Don't distribute generated files that embed our builddir (fd.o #30285,
316     fd.o #34292)
317   • Raise the system bus's fd limit to be sufficient for its configuration
318     (fd.o #33474, LP#381063)
319   • Fix syslog string processing
320   • Ignore -Waddress
321   • Remove broken gcov parsing code and --enable-gcov, and replace them
322     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
323   • Windows:
324     · avoid live-lock in Windows CE due to unfair condition variables
325   • OpenBSD:
326     · support credentials-passing (fd.o #32542)
327   • Solaris:
328     · opt-in to thread safety (fd.o #33464)
329
330 D-Bus 1.4.1 (20 December 2010)
331 ==
332
333  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
334    crash the bus. The existing restriction to 64-levels of nesting previously
335    only applied to the static type signature; now it also applies to dynamic
336    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
337    issue.
338  • OS X portability fixes, including launchd support.
339  • Windows autolaunch improvements.
340  • Various bug fixes.
341
342 D-Bus 1.4.0 (6 Sep 2010)
343 ==
344  - systemd hookup
345
346 D-Bus 1.3.1 (23 June 2010)
347 ==
348  - New standardized PropertiesChanged signal in the properties interface
349  - Various portability fixes, in particular to Windows platforms
350  - Support forking bus services, for compatibility
351
352 D-Bus 1.3.0 (29 July 2009)
353 ==
354  - ability for dbus-send to send to any bus (--address)
355  - file descriptor passing on Unix socket transports
356  - use of GCC atomic intrinsics for better processor support
357    (requires -march=i486 or above for x86 compilation)
358  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
359    and glibc (2.9 for pipe2 and 2.10 for accept4)
360  - feature negotiation in the bus daemon