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