Merge branch 'dbus-1.10'
[platform/upstream/dbus.git] / NEWS
1 D-Bus 1.11.18 (UNRELEASED)
2 ==
3
4 Fixes:
5
6 • When parsing dbus-daemon configuration, tell Expat not to use
7   cryptographic-quality entropy as a salt for its hash tables: we trust
8   the configuration files, so we are not concerned about algorithmic
9   complexity attacks via hash table collisions. This prevents
10   dbus-daemon --system from holding up the boot process (and causing
11   early-boot system services like systemd, logind, networkd to time
12   out) on entropy-starved embedded systems.
13   (fd.o #101858, Simon McVittie)
14
15 D-Bus 1.11.16 (2017-07-27)
16 ==
17
18 The “south facing garden” release.
19
20 Build-time configuration changes:
21
22 • The Autotools build system now supports varying ${runstatedir}
23   independently of ${localstatedir}, if using an Autoconf version
24   that has that feature; version 2.70 will eventually have this, but
25   many Linux distributions add it to version 2.69 as a patch.
26   A typical use is to set prefix=/usr, sysconfdir=/etc, localstatedir=/var
27   and runstatedir=/run. (fd.o #101569, Simon McVittie)
28
29 Enhancements:
30
31 • New APIs DBUS_MESSAGE_ITER_INIT_CLOSED, dbus_message_iter_init_closed()
32   and dbus_message_iter_abandon_container_if_open() simplify the
33   single-exit-point ("goto out") style of resource cleanup. The API
34   documentation around DBusMessageIter and containers has also been
35   clarified. (fd.o #101568, Simon McVittie)
36
37 Fixes:
38
39 • Fix the implementation of re-enabling a timeout (again) so that its
40   countdown is always restarted as intended. (fd.o #95619,
41   Michal Koutný)
42
43 • Make the dbus-daemon's Properties interface, as introduced in 1.11.14,
44   available to all users on the system bus (fd.o #101700, Simon McVittie)
45
46 • dbus_message_iter_append_basic() no longer leaks memory if it fails to
47   append a file descriptor to a message. (fd.o #101568, Simon McVittie)
48
49 • dbus_message_iter_open_container() no longer leaks memory if it runs out
50   of memory. (fd.o #101568, Simon McVittie)
51
52 • dbus_message_append_args_valist() no longer leaks memory if given an
53   unsupported type. This situation is still considered to be a programming
54   error which needs to be corrected by the user of libdbus.
55   (fd.o #101568, Simon McVittie)
56
57 • dbus_message_iter_append_basic() and dbus_message_iter_open_container()
58   will no longer report that their arguments were invalid if they run out
59   of memory at exactly the wrong time. (fd.o #101568, Simon McVittie)
60
61 • Ensure that tests fail if they would otherwise have tried to connect to
62   the real session bus (fd.o #101698, Simon McVittie)
63
64 • Make build-time tests cope with finding Python 3, but not Python 2
65   (fd.o #101716, Simon McVittie)
66
67 Internal changes relevant to dbus developers:
68
69 • DBusVariant is a new mechanism to copy single values from a message into
70   a buffer without copying the entire message (fd.o #101568, Simon McVittie)
71
72 • DBUS_SYSTEM_LOG_FATAL has been replaced by DBUS_SYSTEM_LOG_ERROR.
73   Logging an ERROR message does not make the process exit; the caller
74   is responsible for calling abort() or exit(), whichever is more appropriate.
75   (fd.o #101568, Simon McVittie)
76
77 • Better test coverage (fd.o #101568, Simon McVittie)
78
79 D-Bus 1.11.14 (2017-06-29)
80 ==
81
82 The “irrational fear of bees” release.
83
84 Dependencies:
85
86 • Expat >= 2.1.0 is always required
87 • libselinux >= 2.0.86 is required if SELinux support is enabled
88 • GLib >= 2.40 is required if full test coverage is enabled
89
90 Build-time configuration changes:
91
92 • We now use pkg-config to find libexpat in Autotools builds. This requires
93   Expat 2.1.0 (March 2012) or later. In particular, this should remove the
94   need to configure with LDFLAGS=-L/usr/local/lib on OpenBSD, which can
95   itself cause compilation failures.
96
97   As with all pkg-config-based configure checks, you can use
98   PKG_CONFIG_PATH=/whatever/lib/pkgconfig to find expat.pc in a
99   non-standard prefix, or EXPAT_CFLAGS="-I/whatever/include" and
100   EXPAT_LIBS="-L/whatever/lib -lexpat" to avoid needing a .pc file
101   at all.
102
103   (fd.o #69801, Simon McVittie)
104
105 • Similarly, we now use pkg-config to find libselinux. Version 2.0.86
106   is required due to the removal of explicit refcounting for SIDs.
107   (fd.o #100912, Laurent Bigonville)
108
109 Behaviour changes:
110
111 • Previously, /etc/machine-id could be copied to /var/lib/dbus/machine-id
112   as a side-effect of a sufficiently privileged process merely reading the
113   machine ID. It is no longer copied as a side-effect of reading.
114   Running dbus-uuidgen --ensure, which should be done after installing dbus,
115   continues to copy /etc/machine-id to /var/lib/dbus/machine-id if the
116   former exists and the latter does not.
117   (fd.o #101257, Simon McVittie)
118
119 • The undocumented Verbose interface, and the GetAllMatchRules method on
120   the undocumented Stats interface, must now be used via the object path
121   /org/freedesktop/DBus. Previously, they existed on all object paths.
122   (fd.o #101257, Simon McVittie)
123
124 • AddMatch() with a match rule containing eavesdrop='true' will now fail
125   unless called by either the same user as the dbus-daemon, or Unix uid 0
126   (root), matching the restrictions applied to the newer BecomeMonitor()
127   method. On the session bus this has no practical effect. On the system
128   bus this will prevent certain configurations that already did not
129   work well in practice. (fd.o #101567, Simon McVittie)
130
131 Enhancements:
132
133 • D-Bus Specification version 0.31
134   · Don't require implementation-specific search paths to be lowest
135     priority
136   · Correct regex syntax for optionally-escaped bytes in addresses so it
137     includes hyphen-minus, forward slash and underscore as intended
138   · Describe all message bus methods in the same section
139   · Clarify the correct object path for method calls to the message bus
140     (/org/freedesktop/DBus, DBUS_PATH_DBUS in the reference implementation)
141   · Document that the message bus implements Introspectable, Peer and
142     Properties
143   · Add new Features and Interfaces properties for message bus
144     feature-discovery
145   · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
146     abstract sockets
147   · Don't require eavesdrop='true' to be accepted from connections not
148     sufficiently privileged to use it successfully
149   · Formally deprecate eavesdropping in favour of BecomeMonitor
150   (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
151   Simon McVittie, Tom Gundersen)
152
153 • Implement the Properties and Peer interfaces in dbus-daemon
154   (fd.o #101257, Simon McVittie)
155
156 • New function dbus_try_get_local_machine_id() is like
157   dbus_get_local_machine_id(), but returning a DBusError. Other code
158   that needs the machine ID will now report a recoverable error (instead
159   of logging to stderr and aborting) if no machine ID is available.
160   Generating a machine ID is still considered to be a required part of
161   installing dbus correctly. (fd.o #13194, Simon McVittie)
162
163 • Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
164   (fd.o #101315, Laurent Bigonville)
165
166 • Avoid deprecated API calls when using SELinux
167   (fd.o #100912, Laurent Bigonville)
168
169 • Switch a test from the deprecated g_test_trap_fork() to
170   g_test_trap_subprocess(), for Windows support and better robustness
171   on Unix (fd.o #101362, Simon McVittie)
172
173 • On systemd systems, if ${localstatedir}/dbus/machine-id doesn't exist,
174   instruct systemd-tmpfiles to make it a symbolic link to /etc/machine-id.
175   This prevents the two files from going out of sync on stateless or live
176   images without needing to run dbus-uuidgen, and supports older D-Bus
177   implementations that do not necessarily read /etc/machine-id themselves.
178   (fd.o #101570, Simon McVittie)
179
180 • Implement unix:dir=..., which resembles unix:tmpdir=... but never uses
181   abstract sockets. This is preferable when used with Linux containers.
182   (fd.o #101567, Simon McVittie)
183
184 Fixes:
185
186 • Fix a reference leak when blocking on a pending call on a connection
187   that has been disconnected (fd.o #101481, Shin-ichi MORITA)
188
189 • Don't put timestamps in the Doxygen-generated documentation,
190   or hard-code the build directory into builds with embedded tests,
191   for reproducible builds (fd.o #100692, Simon McVittie)
192
193 • Fix some integration test issues (fd.o #100686, Simon McVittie)
194
195 • Fix memory leaks in the tests (fd.o #101257, Simon McVittie)
196
197 • If we somehow get an autolaunch address with multiple semicolon-separated
198   components, and they don't work, don't invalidly "pile up" errors
199   (fd.o #101257, Simon McVittie)
200
201 Documentation:
202
203 • Update git URIs in HACKING document to sync up with cgit.freedesktop.org
204   (fd.o #100715, Simon McVittie)
205
206 D-Bus 1.11.12 (2017-04-07)
207 ==
208
209 The “it's something humans do” release.
210
211 Enhancements:
212
213 • The session dbus-daemon now supports transient .service files
214   in $XDG_RUNTIME_DIR/dbus-1/services. Unlike the other standard
215   service directories, this directory is not monitored with inotify
216   or similar, and the service files must be named exactly
217   ${bus_name}.service. (fd.o #99825, Simon McVittie)
218
219 • dbus can be configured with --enable-relocation when building with
220   Autotools, or with -DDBUS_RELOCATABLE=ON when building with cmake,
221   to make the pkg-config metadata relocatable. This is useful for
222   non-standard prefixes, and in particular for Windows installations.
223   However, it is not recommended for system-wide installations into
224   /usr, because it interferes with pkg-config's ability to filter out
225   compiler default linker directories.
226
227   With Autotools, the default is --enable-relocation when building
228   for Windows or --disable-relocation otherwise. With CMake, the default
229   is -DDBUS_RELOCATABLE=ON.
230
231   (fd.o #99721; Ralf Habacker, Simon McVittie)
232
233 • Users of CMake ≥ 2.6 can now link to libdbus without providing their
234   own FindDBus.cmake macros, whether dbus was compiled with Autotools
235   or with CMake. See the end of README.cmake for more information.
236   (fd.o #99721; Ralf Habacker, Simon McVittie)
237
238 Fixes:
239
240 • Always read service file directories in the intended order
241   (fd.o #99825, Simon McVittie)
242
243 • When tests are skipped, don't try to kill nonexistent process 0
244   (fd.o #99825, Simon McVittie)
245
246 • Avoid valgrind false positives (fd.o #88808, Philip Withnall)
247
248 • Fix a harmless read overflow and some memory leaks in a unit test
249   (fd.o #100568, Philip Withnall)
250
251 • Fix some typos in test code
252   (fd.o #99999, Coverity #141876, #141877; Philip Withnall)
253
254 • Clarify the roles of /etc/dbus-1/s*.d and /usr/share/dbus-1/s*.d
255   in documentation (fd.o #99901, Philip Withnall)
256
257 • Fix and enable compiler warnings related to -Wswitch
258   (fd.o #98191; Thomas Zimmermann, Simon McVittie)
259
260 • Fix writing off the end of a fd_set when testing with valgrind
261   (fd.o #99839, Philip Withnall)
262
263 D-Bus 1.11.10 (2017-02-16)
264 ==
265
266 The “purple hair gives you telekinesis?” release.
267
268 Dependencies:
269
270 • AppArmor support requires at least libapparmor 2.8.95, reduced
271   from 2.10 in previous versions. One test requires 2.10 and is
272   skipped if building with an older version.
273
274 Enhancements:
275
276 • Do the Travis-CI build in Docker containers for Ubuntu LTS, Debian
277   stable and Debian testing in addition to the older Ubuntu that is
278   the default (fd.o #98889, Simon McVittie)
279
280 • Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
281
282 • Silence many -Wswitch-enum and -Wswitch-default warnings
283   (fd.o #98191; Thomas Zimmermann, Simon McVittie)
284
285 • Install a sysusers.d snippet so `dbus-daemon --system` can be used
286   with an unpopulated /etc (fd.o #99162, Lennart Poettering)
287
288 • Install pkg-config metadata on Unix even if building with CMake
289   (fd.o #99752, Ralf Habacker)
290
291 • Exclude auth mechanisms from REJECTED message if they are supported
292   in the code but but configured to be disallowed (fd.o #99621,
293   Ralf Habacker)
294
295 Fixes:
296
297 • Prevent symlink attacks in the nonce-tcp transport on Unix that could
298   allow an attacker to overwrite a file named "nonce", in a directory
299   that the user running dbus-daemon can write, with a random value
300   known only to the user running dbus-daemon. This is unlikely to be
301   exploitable in practice, particularly since the nonce-tcp transport
302   is really only useful on Windows.
303
304   On Unix systems we strongly recommend using only the unix: and systemd:
305   transports, together with EXTERNAL authentication. These are the only
306   transports and authentication mechanisms enabled by default.
307
308   (fd.o #99828, Simon McVittie)
309
310 • Avoid symlink attacks in the "embedded tests", which are not enabled
311   by default and should never be enabled in production builds of dbus.
312   (fd.o #99828, Simon McVittie)
313
314 • Fix the implementation of re-enabling a timeout so that its
315   countdown is restarted as intended, instead of continually
316   decreasing. (fd.o #95619; Michal Koutný, Simon McVittie)
317
318 • When receiving a message with file descriptors, do not start reading
319   the beginning of the next message, so that only one such message
320   is processed at a time. In conjunction with the fix for #95619
321   this means that processes sending many file descriptors, such as
322   systemd-logind on a system that receives very rapid ssh connections,
323   are not treated as abusive and kicked off the bus. Revert the previous
324   workaround that special-cased uid 0.
325   (fd.o #95263, LP#1591411; Simon McVittie)
326
327 • Do not require TMPDIR, TEMP or TMP to be set when cross-compiling
328   for Windows with CMake (fd.o #99586, Ralf Habacker)
329
330 • Do not set Unix-specific variables when targeting Windows
331   (fd.o #99586, Ralf Habacker)
332
333 • Install Unix executables to ${CMAKE_INSTALL_PREFIX}/bin as intended,
334   not ${CMAKE_INSTALL_PREFIX}/lib (fd.o #99752, Ralf Habacker)
335
336 • Use relative install locations in CMake on Unix to respect DESTDIR,
337   and use GNU-style install layout (fd.o #99721, #99752; Ralf Habacker)
338
339 • Install dbus-arch-deps.h correctly when using CMake
340   (fd.o #99586, #99721; Ralf Habacker)
341
342 • Improve argument validation for `dbus-test-tool spam`
343   (ffd.o #99693, Coverity #54759; Philip Withnall)
344
345 • Don't shift by a negative integer if a hash table becomes monstrously
346   large (fd.o #99641, Coverity #54682; Philip Withnall)
347
348 • Don't leak LSM label if dbus-daemon runs out of memory when dealing with
349   a new connection (fd.o #99612, Coverity #141058; Philip Withnall)
350
351 • Remove an unnecessary NULL check
352   (fd.o #99642, Coverity #141062; Philip Withnall)
353
354 • Improve error handling in unit tests and dbus-send
355   (fd.o #99643, #99694, #99712, #99722, #99723, #99724, #99758,
356   #99759, #99793, Coverity #54688, #54692, #54693, #54697, #54701,
357   #54710, #54711, #54714, #54715, #54718, #54721, #54724, #54726,
358   #54730, #54740, #54822, #54823, #54824, #54825; Philip Withnall)
359
360 • Do not print verbose messages' timestamps to stderr if the actual message
361   has been redirected to the Windows debug port (fd.o #99749, Ralf Habacker)
362
363 D-Bus 1.11.8 (2016-11-28)
364 ==
365
366 The “panics in the face of breakfast foods” release.
367
368 Build-time configuration:
369
370 • The new --enable-debug configure option provides an easy way to
371   enable debug symbols, disable optimization and/or enable profiling.
372
373 • The --enable-compile-warnings configure option can be used to control
374   compiler warnings.
375
376 • The --disable-compiler-optimisations configure option is no longer
377   supported. Use --enable-debug=yes or CFLAGS=-O0 instead.
378
379 Enhancements:
380
381 • D-Bus Specification version 0.30
382   · Define the jargon term "activation" more clearly
383   · Define the jargon term "auto-starting", which is one form of activation
384   · Document the optional SystemdService key in service files
385   · Use versioned interface and bus names in most examples
386   · Clarify intended behaviour of Properties.GetAll
387   (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
388
389 • Fix and enable a lot of compiler warnings to improve future code
390   quality. This might incidentally also fix some environment variable
391   accesses on OS X.
392   · In particular, printf-style functions in the libdbus API are now annotated
393     with __attribute__((__format__(__printf__, *, *))) when compiling with
394     gcc or clang. This might make printf bugs in other software visible
395     at compile time.
396   (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
397   Thomas Zimmermann, Simon McVittie)
398
399 • When running with AppArmor mediation (for example using Ubuntu's patched
400   Linux kernel), clients can no longer auto-start services unless they would
401   have been able to send the auto-starting message to the service after it
402   starts. StartServiceByName() is unaffected, and continues to be allowed by
403   default in AppArmor's <abstractions/dbus-strict> and
404   <abstractions/dbus-session-strict>. (fd.o #98666, Simon McVittie)
405
406 Fixes:
407
408 • Work around an undesired effect of the fix for CVE-2014-3637
409   (fd.o #80559), in which processes that frequently send fds, such as
410   logind during a flood of new PAM sessions, can get disconnected for
411   continuously having at least one fd "in flight" for too long;
412   dbus-daemon interprets that as a potential denial of service attack.
413   The workaround is to disable that check for uid 0 process such as
414   logind, with a message in the system log. The bug remains open while
415   we look for a more general solution.
416   (fd.o #95263, LP#1591411; Simon McVittie)
417
418 • Don't run the test test-dbus-launch-x11.sh if X11 autolaunching
419   was disabled at compile time. That test is not expected to work
420   in that configuration. (fd.o #98665, Simon McVittie)
421
422 D-Bus 1.11.6 (2016-10-10)
423 ==
424
425 The “darkly whimsical” release.
426
427 Security fixes:
428
429 • Do not treat ActivationFailure message received from root-owned systemd
430   name as a format string. In principle this is a security vulnerability,
431   but we do not believe it is exploitable in practice, because only
432   privileged processes can own the org.freedesktop.systemd1 bus name, and
433   systemd does not appear to send activation failures that contain "%".
434
435   Please note that this probably *was* exploitable in dbus versions
436   older than 1.6.30, 1.8.16 and 1.9.10 due to a missing check which at
437   the time was only thought to be a denial of service vulnerability
438   (CVE-2015-0245). If you are still running one of those versions,
439   patch or upgrade immediately.
440
441   (fd.o #98157, Simon McVittie)
442
443 Enhancements:
444
445 • D-Bus Specification version 0.29
446   · Recommend not using '/' for object paths (fd.o #37095, Philip Withnall)
447   · Allow <annotation> in <arg> elements (fd.o #86162, Philip Withnall)
448
449 • Log to syslog when we exceed various anti-DoS limits, and add test
450   coverage for them (fd.o #86442, Simon McVittie)
451
452 • Improve syslog handling so that _dbus_warn() and similar warnings
453   go to syslog, add dbus-daemon --syslog|--nosyslog|--syslog-only options,
454   and log to syslog (instead of /dev/null) when dbus-daemon is started by
455   dbus-launch. (fd.o #97009, Simon McVittie)
456
457 • Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
458   (fd.o #89011, Philip Withnall)
459
460 • When logging messages about service activation, mention which peer
461   requested the activation (fd.o #68212, Philip Withnall)
462
463 • On Linux, mention the LSM label (if available) whenever we print
464   debug information about a peer (fd.o #68212, Philip Withnall)
465
466 Other fixes:
467
468 • Harden dbus-daemon against malicious or incorrect ActivationFailure
469   messages by rejecting them if they do not come from a privileged
470   process, or if systemd activation is not enabled
471   (fd.o #98157, Simon McVittie)
472
473 • Avoid undefined behaviour when setting reply serial number without going
474   via union DBusBasicValue (fd.o #98035, Marc Mutz)
475
476 • Fix CMake build for Unix platforms that do not have -lrt, such as Android,
477   or that do need -lsocket, such as QNX (fd.o #94096, Ralf Habacker)
478
479 • autogen.sh: fail cleanly if autoconf fails (Simon McVittie)
480
481 D-Bus 1.11.4 (2016-08-15)
482 ==
483
484 The “copper pickaxe” release.
485
486 Dependencies:
487
488 • Building from git (but not from tarballs) now requires
489   macros from the GNU Autoconf Archive, for example the autoconf-archive
490   package in Debian or Fedora derivatives.
491
492 Build-time configuration:
493
494 • The option to enable coverage instrumentation has changed from
495   --enable-compiler-coverage to --enable-code-coverage.
496
497 Enhancements:
498
499 • D-Bus Specification version 0.28
500   · Clarify some details of serialization (fd.o #93382, Philip Withnall)
501
502 • Increase listen() backlog of AF_UNIX sockets to the maximum possible,
503   minimizing failed connections under heavy load
504   (fd.o #95264, Lennart Poettering)
505
506 • Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)
507
508 • Use the same regression tests for subprocess starting on Unix and Windows
509   (fd.o #95191, Ralf Habacker)
510
511 • Print timestamps and thread IDs in verbose messages
512   (fd.o #95191, Ralf Habacker)
513
514 • On Unix, unify the various places that reopen stdin, stdout and/or stderr
515   pointing to /dev/null (fd.o #97008, Simon McVittie)
516
517 • Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
518   (fd.o #88922, Thomas Zimmermann)
519
520 Fixes:
521
522 • On Windows, fix a memory leak in replacing the installation prefix
523   (fd.o #95191, Ralf Habacker)
524
525 • On Linux, when dbus-daemon is run with reduced susceptibility to the
526   OOM killer (typically via systemd), do not let child processes inherit
527   that setting (fd.o #32851; Kimmo Hämäläinen, WaLyong Cho)
528
529 • On Unix, make dbus-launch and dbus-daemon --fork work as intended
530   even if a parent process incorrectly starts them with stdin, stdout
531   and/or stderr closed (fd.o #97008, Simon McVittie)
532
533 • Output valid shell syntax in ~/.dbus/session-bus/ if the bus address
534   contains a semicolon (fd.o #94746, Thiago Macieira)
535
536 • Fix memory leaks and thread safety in subprocess starting on Windows
537   (fd.o #95191, Ralf Habacker)
538
539 • Stop test-dbus-daemon incorrectly failing on platforms that cannot
540   discover the process ID of clients (fd.o #96653, Руслан Ижбулатов)
541
542 • In tests that exercise correct handling of crashing D-Bus services,
543   suppress Windows crash handler (fd.o #95155; Yiyang Fei, Ralf Habacker)
544
545 • Explicitly check for stdint.h (Ioan-Adrian Ratiu)
546
547 • In tests, add an invalid DBusAuthState to avoid undefined behaviour
548   in some test cases (fd.o #93909, Nick Lewycky)
549
550 • Add assertions to reassure a static analysis tool
551   (fd.o #93210, Deepika Aggarwal)
552
553 • Be explicit about enum comparison when loading XML
554   (fd.o #93205, Deepika Aggarwal)
555
556 • update-activation-environment: produce better diagnostics on error
557   (fd.o #96653, Simon McVittie)
558
559 • Avoid various compiler warnings with gcc 6
560   (fd.o #97282; Thomas Zimmermann, Simon McVittie)
561
562 • On Unix when configured to use the system log, report as "dbus-daemon",
563   not as "dbus" (fd.o #97009, Simon McVittie)
564
565 • During unit tests, reduce the amount we write to the system log
566   (fd.o #97009, Simon McVittie)
567
568 D-Bus 1.11.2 (2016-03-07)
569 ==
570
571 The “pneumatic drill vs. Iron Maiden” release.
572
573 Fixes:
574
575 • Enable "large file support" on systems where it exists: dbus-daemon
576   is not expected to open large files, but it might need to stat files
577   that happen to have large inode numbers (fd.o #93545, Hongxu Jia)
578
579 • Eliminate padding inside DBusMessageIter on 64-bit platforms,
580   which might result in a pedantic C compiler not copying the entire contents
581   of a DBusMessageIter; statically assert that this is not an ABI change
582   in practice (fd.o #94136, Simon McVittie)
583
584 • Document dbus-test-tool echo --sleep-ms=N instead of incorrect --sleep=N
585   (fd.o #94244, Dmitri Iouchtchenko)
586
587 • Correctly report test failures in C tests from run-test.sh
588   (fd.o #93379; amit tewari, Simon McVittie)
589
590 • When tests are enabled, run all the marshal-validate tests, not just
591   the even-numbered ones (fd.o #93908, Nick Lewycky)
592
593 • Correct the expected error from one marshal-validate test, which was
594   previously not run due to the above bug (fd.o #93908, Simon McVittie)
595
596 • Fix compilation under CMake when embedded tests are disabled
597   (fd.o #94094, eric.hyer)
598
599 Internal changes:
600
601 • Fix all -Wpointer-sign (signed/unsigned mismatch) warnings, and enable the
602   warning (fd.o #93069; Ralf Habacker, Simon McVittie)
603
604 • When building with CMake, use the same gcc/clang warnings as under Autotools,
605   or MSVC warnings that are broadly similar (fd.o #93069, Ralf Habacker)
606
607 • test/name-test: make C tests produce TAP output and run them directly, not
608   via run-test.sh (fd.o #92899, Simon McVittie)
609
610 • Under CMake when cross-compiling for Windows on Unix, run the tests
611   under Wine even if binfmt_misc support is not available
612   (fd.o #88966, Ralf Habacker)
613
614 • The DBUS_USE_TEST_BINARY environment variable is no longer used by builds with
615   embedded tests; DBUS_TEST_DBUS_LAUNCH replaces it (fd.o #92899, Simon McVittie)
616
617 • Factor out some functions that will be needed in future for a Windows
618   implementation of dbus-run-session (fd.o #92899, Ralf Habacker)
619
620 D-Bus 1.11.0 (2015-12-02)
621 ==
622
623 The “peppermint deer” release.
624
625 Dependencies:
626
627 • On non-Windows platforms, dbus now requires an <inttypes.h> that defines
628   C99 constants such as PRId64 and PRIu64.
629
630 Enhancements:
631
632 • D-Bus Specification version 0.27
633   · Specify that services should not reply if NO_REPLY_EXPECTED was used
634     (fd.o #75749, Lars Uebernickel)
635
636 • Add a script to do continuous-integration builds, and metadata to run it
637   on travis-ci.org. To use this, clone the dbus git repository on GitHub
638   and set it up with travis-ci.org; the only special setting needed is
639   "only build branches with a .travis.yml". (fd.o #93194, Simon McVittie)
640
641 • If dbus-daemon is run with --systemd-activation, do not require
642   org.freedesktop.systemd1.service to exist (fd.o #93194, Simon McVittie)
643
644 Fixes:
645
646 • Re-order dbus-daemon startup so that on SELinux systems, the thread
647   that reads AVC notifications retains the ability to write to the
648   audit log (fd.o #92832, Laurent Bigonville)
649
650 • Print 64-bit integers on non-GNU Unix platforms (fd.o #92043, Natanael Copa)
651
652 • When using the Monitoring interface, match messages' destinations
653   (fd.o #92074, Simon McVittie)
654
655 • On Linux with systemd, stop installing a reference to the obsolete
656   dbus.target, and enable dbus.socket statically (fd.o #78412, #92402;
657   Simon McVittie)
658
659 • On Windows, when including configuration files with <include> or
660   <includedir>, apply the same relocation as for the Exec paths
661   in .service files (fd.o #92028, Simon McVittie)
662
663 • Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)
664
665 • Fix many -Wpointer-sign warnings (fd.o #93069, Ralf Habacker)
666
667 D-Bus 1.10.6 (2015-12-01)
668 ==
669
670 The “marzipan beetles” release.
671
672 Fixes:
673
674 • On Unix when running tests as root, don't assert that root and
675   the dbus-daemon user can still call UpdateActivationEnvironment;
676   assert that those privileged users can call BecomeMonitor instead
677   (fd.o #93036, Simon McVittie)
678
679 • On Windows, fix a memory leak in the autolaunch transport (fd.o #92899,
680   Simon McVittie)
681
682 • On Windows Autotools builds, don't run tests that rely on
683   dbus-run-session and other Unix-specifics (fd.o #92899, Simon McVittie)
684
685 D-Bus 1.10.4 (2015-11-17)
686 ==
687
688 The “Frostburn Canyon” release.
689
690 Enhancements:
691
692 • GetConnectionCredentials, GetConnectionUnixUser and
693   GetConnectionUnixProcessID with argument "org.freedesktop.DBus"
694   will now return details of the dbus-daemon itself. This is required
695   to be able to call SetEnvironment on systemd.
696   (fd.o #92857, Jan Alexander Steffens)
697
698 Fixes:
699
700 • Make UpdateActivationEnvironment always fail with AccessDenied on the
701   system bus. Previously, it was possible to configure it so root could
702   call it, but the environment variables were not actually used,
703   because the launch helper would discard them.
704   (fd.o #92857, Jan Alexander Steffens)
705
706 • On Unix with --systemd-activation on a user bus, make
707   UpdateActivationEnvironment pass on its arguments to systemd's
708   SetEnvironment method, solving inconsistency between the environments
709   used for traditional activation and systemd user-service activation.
710   (fd.o #92857, Jan Alexander Steffens)
711
712 • On Windows, don't crash if <syslog/> or --syslog is used
713   (fd.o #92538, Ralf Habacker)
714
715 • On Windows, fix a memory leak when setting a DBusError from a Windows
716   error (fd.o #92721, Ralf Habacker)
717
718 • On Windows, don't go into infinite recursion if we abort the process
719   with backtraces enabled (fd.o #92721, Ralf Habacker)
720
721 • Fix various failing tests, variously on Windows and cross-platform:
722   · don't test system.conf features (users, groups) that only make sense
723     on the system bus, which is not supported on Windows
724   · don't call _dbus_warn() when we skip a test, since it is fatal
725   · fix computation of expected <standard_session_servicedirs/>
726   · when running TAP tests, translate newlines to Unix format, fixing
727     cross-compiled tests under Wine on Linux
728   · don't stress-test refcounting under Wine, where it's really slow
729   · stop assuming that a message looped-back to the test will be received
730     immediately
731   · skip some system bus tests on Windows since they make no sense there
732   (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
733
734 D-Bus 1.10.2 (2015-10-26)
735 ==
736
737 The “worst pies in London” release.
738
739 Fixes:
740
741 • Correct error handling for activation: if there are multiple attempts
742   to activate the same service and it fails immediately, the first attempt
743   would get the correct reply, but the rest would time out. We now send
744   the same error reply to each attempt. (fd.o #92200, Simon McVittie)
745
746 • If BecomeMonitor is called with a syntactically invalid match rule,
747   don't crash with an assertion failure, fixing a regression in 1.9.10.
748   This was not exploitable as a denial of service, because the check
749   for a privileged user is done first. (fd.o #92298, Simon McVittie)
750
751 • On Linux with --enable-user-session, add the bus address to the
752   environment of systemd services for better backwards compatibility
753   (fd.o #92612, Jan Alexander Steffens)
754
755 • On Windows, fix the logic for replacing the installation prefix
756   in service files' Exec lines (fd.o #83539; Milan Crha, Simon McVittie)
757
758 • On Windows, if installed in the conventional layout with ${prefix}/etc
759   and ${prefix}/share, use relative paths between bus configuration files
760   to allow the tree to be relocated (fd.o #92028, Simon McVittie)
761
762 • Make more of the regression tests pass in Windows builds (fd.o #92538,
763   Simon McVittie)
764
765 D-Bus 1.10.0 (2015-08-25)
766 ==
767
768 The “0x20” release.
769
770 This is a new stable branch, recommended for use in OS distributions.
771
772 Fixes since 1.9.20:
773
774 • distribute test/tap-test.sh.in, even if the tarball was built without
775   tests enabled (fd.o #91684, Simon McVittie)
776 • work around a fd leak in libcap-ng < 0.7.7 (fd.o #91684, Simon McVittie)
777
778 Summary of major changes since 1.8.0:
779
780 • The basic setup for the well-known system and session buses is
781   now done in read-only files in ${datadir} (normally /usr/share).
782   See the NEWS entry for 1.9.18 for details.
783
784 • AppArmor integration has been merged, with features similar to the
785   pre-existing SELinux integration. It is mostly compatible with the
786   patches previously shipped by Ubuntu, with one significant change:
787   Ubuntu's GetConnectionAppArmorSecurityContext method has been superseded
788   by GetConnectionCredentials and was not included.
789
790 • The --enable-user-session configure option can be enabled
791   by OS integrators intending to use systemd to provide a session bus
792   per user (in effect, treating all concurrent graphical and non-graphical
793   login sessions as one large session).
794
795 • The new listenable address mode "unix:runtime=yes" listens on
796   $XDG_RUNTIME_DIR/bus, the same AF_UNIX socket used by the systemd
797   user session. libdbus and "dbus-launch --autolaunch" will connect to
798   this address by default. GLib ≥ 2.45.3 and sd-bus ≥ 209 have a
799   matching default.
800
801 • All executables are now dynamically linked to libdbus-1.
802   Previously, some executables, most notably dbus-daemon, were statically
803   linked to a specially-compiled variant of libdbus. This results in
804   various private functions in the _dbus namespace being exposed by the
805   shared library. These are not API, and must not be used outside
806   the dbus source tree.
807
808 • On platforms with ELF symbol versioning, all public symbols
809   are versioned LIBDBUS_1_3.
810
811 New bus APIs:
812
813 • org.freedesktop.DBus.GetConnectionCredentials returns
814   LinuxSecurityLabel where supported
815 • org.freedesktop.DBus.Monitoring interface (privileged)
816   · BecomeMonitor method supersedes match rules with eavesdrop=true,
817     which are now deprecated
818 • org.freedesktop.DBus.Stats interface (semi-privileged)
819   · now enabled by default
820   · new GetAllMatchRules method
821 • org.freedesktop.DBus.Verbose interface (not normally compiled)
822   · toggles the effect of DBUS_VERBOSE
823
824 New executables:
825
826 • dbus-test-tool
827 • dbus-update-activation-environment
828
829 New optional dependencies:
830
831 • The systemd: pseudo-transport requires libsystemd or libsd-daemon
832 • Complete documentation requires Ducktype and yelp-tools
833 • Full test coverage requires GLib 2.36 and PyGI
834 • AppArmor integration requires libapparmor and optionally libaudit
835
836 Dependencies removed:
837
838 • dbus-glib
839
840 D-Bus 1.9.20 (2015-08-06)
841 ==
842
843 The “Remember Tomorrow” release.
844
845 This is a release-candidate for D-Bus 1.10.0. OS distribution vendors
846 should test it.
847
848 Fixes:
849
850 • Don't second-guess what the ABI of poll() is, allowing it to be used
851   on Integrity RTOS and other unusual platforms (fd.o #90314;
852   Rolland Dudemaine, Simon McVittie)
853
854 • Don't duplicate audit subsystem integration if AppArmor and SELinux are
855   both enabled (fd.o #89225, Simon McVittie)
856
857 • Log audit events for AppArmor/SELinux policy violations whenever
858   we have CAP_AUDIT_WRITE, even if not the system bus
859   (fd.o #83856, Laurent Bigonville)
860
861 D-Bus 1.9.18 (2015-07-21)
862 ==
863
864 The “Pirate Elite” release.
865
866 Configuration changes:
867
868 • The basic setup for the well-known system and session buses is now done
869   in read-only files in ${datadir}, moving a step closer to systems
870   that can operate with an empty /etc directory. In increasing order
871   of precedence:
872
873   · ${datadir}/dbus-1/s*.conf now perform the basic setup such as setting
874     the default message policies.
875   · ${sysconfdir}/dbus-1/s*.conf are now optional. By default
876     dbus still installs a trivial version of each, for documentation
877     purposes; putting configuration directives in these files is deprecated.
878   · ${datadir}/dbus-1/s*.d/ are now available for third-party software
879     to install "drop-in" configuration snippets (any packages
880     using those directories should explicitly depend on at least this
881     version of dbus).
882   · ${sysconfdir}/dbus-1/s*.d/ are also still available for sysadmins
883     or third-party software to install "drop-in" configuration snippets
884   · ${sysconfdir}/dbus-1/s*-local.conf are still available for sysadmins'
885     overrides
886
887   ${datadir} is normally /usr/share, ${sysconfdir} is normally /etc,
888   and "s*" refers to either system or session as appropriate.
889
890   (fd.o #89280, Dimitri John Ledkov)
891
892 Fixes:
893
894 • Fix a memory leak when GetConnectionCredentials() succeeds
895   (fd.o #91008, Jacek Bukarewicz)
896
897 • Ensure that dbus-monitor does not reply to messages intended for others,
898   resulting in its own disconnection (fd.o #90952, Simon McVittie)
899
900 D-Bus 1.9.16 (2015-05-14)
901 ==
902
903 The “titanium barns” release.
904
905 Dependencies:
906
907 • Automake 1.13 is now required when compiling from git or modifying
908   the build system.
909
910 Security hardening:
911
912 • On Unix platforms, change the default configuration for the session bus
913   to only allow EXTERNAL authentication (secure kernel-mediated
914   credentials-passing), as was already done for the system bus.
915
916   This avoids falling back to DBUS_COOKIE_SHA1, which relies on strongly
917   unpredictable pseudo-random numbers.
918
919   If you are using D-Bus over the (unencrypted!) tcp: or nonce-tcp: transport,
920   in conjunction with DBUS_COOKIE_SHA1 and a shared home directory using
921   NFS or similar, you will need to reconfigure the session bus to accept
922   DBUS_COOKIE_SHA1 by commenting out the <auth> element. This configuration
923   is not recommended.
924
925   (fd.o #90414, Simon McVittie)
926
927 • When asked for random numbers for DBUS_COOKIE_SHA1, the nonce-tcp:
928   transport, UUIDs or any other reason, fail if we cannot obtain entropy
929   (from /dev/urandom or CryptGenRandom()) or an out-of-memory condition
930   occurs, instead of silently falling back to low-entropy pseudorandom
931   numbers from rand(). (fd.o #90414; Simon McVittie, Ralf Habacker)
932
933 Enhancements:
934
935 • Add dbus_message_iter_get_element_count()
936   (fd.o #30350; Christian Dywan, Simon McVittie)
937
938 • Introduce new internal DBusSocket and DBusPollable types so we can
939   stop treating the Windows SOCKET type as if it was int. DBusSocket
940   is specifically a socket, cross-platform. DBusPollable is whatever
941   _dbus_poll() can act on, i.e. a fd on Unix or a SOCKET on Windows.
942   (fd.o #89444; Ralf Habacker, Simon McVittie)
943
944 • All regression tests now output TAP <https://testanything.org/>
945   (fd.o #89846, Simon McVittie)
946
947 • Internal APIs consistently use signed values for timestamps
948   (fd.o #18494, Peter McCurdy)
949
950 • Improve diagnostics when UpdateActivationEnvironment calls are rejected
951   (fd.o #88812, Simon McVittie)
952
953 • Clean up a lot of compiler warnings
954   (fd.o #17289, fd.o #89284; Ralf Habacker, Simon McVittie)
955
956 Fixes:
957
958 • Add locking to DBusCounter's reference count and notify function
959   (fd.o #89297, Adrian Szyndela)
960
961 • Ensure that DBusTransport's reference count is protected by the
962   corresponding DBusConnection's lock (fd.o #90312, Adrian Szyndela)
963
964 • Correctly release DBusServer mutex before early-return if we run out
965   of memory while copying authentication mechanisms (fd.o #90021,
966   Ralf Habacker)
967
968 • Make dbus-test-tool and dbus-update-activation-environment portable
969   to Windows (fd.o #90089, Ralf Habacker)
970
971 • Correctly initialize all fields of DBusTypeReader (fd.o #90021;
972   Ralf Habacker, Simon McVittie)
973
974 • Fix some missing \n in verbose (debug log) messages (fd.o #90004,
975   Ralf Habacker)
976
977 • Clean up some memory and fd leaks in test code and tools
978   (fd.o #90021, Ralf Habacker)
979
980 • Fix a NULL dereference if the dbus-daemon cannot read a configuration
981   directory for a reason that is not ENOENT (fd.o #90021, Ralf Habacker)
982
983 • CMake generates a versioned shared library even if the revision is 0,
984   as it usually is on the development branch. (fd.o #89450, Ralf Habacker)
985
986 D-Bus 1.9.14 (2015-03-02)
987 ==
988
989 The “don't stand in the poison cloud” release.
990
991 Dependencies:
992
993 • dbus-daemon and dbus-daemon-launch-helper now require libdbus. They
994   were previously linked to a static version of libdbus.
995
996 • The tests no longer require dbus-glib in order to exercise the libdbus
997   shared library; they are always linked to libdbus now.
998
999 Build-time configuration:
1000
1001 • The new --enable-user-session option, off by default, can be enabled
1002   by OS integrators intending to use systemd to provide a session bus
1003   per user (in effect, treating all concurrent graphical and non-graphical
1004   login sessions as one large session)
1005
1006 Enhancements:
1007
1008 • All executables are now linked dynamically to libdbus.
1009   (fd.o #83115; Bertrand SIMONNET, Simon McVittie, Ralf Habacker)
1010
1011 • On platforms that support them (GNU libc and possibly others),
1012   libdbus now has versioned symbols for its public API.
1013   All public symbols (visible in the header files) are currently
1014   versioned as LIBDBUS_1_3; private symbols starting with _dbus or
1015   dbus_internal have a version that changes with each release, and
1016   must not be used by applications. (also fd.o #83115)
1017
1018 • New listenable address mode "unix:runtime=yes" which listens on
1019   a real filesystem (non-abstract) socket $XDG_RUNTIME_DIR/bus
1020   (fd.o #61303; Colin Walters, Alexander Larsson, Simon McVittie)
1021
1022 • Add optional systemd units for a per-user bus listening on
1023   $XDG_RUNTIME_DIR/bus (fd.o #61301; Simon McVittie, Colin Walters)
1024
1025 • On Unix platforms, both libdbus and "dbus-launch --autolaunch"
1026   default to connecting to $XDG_RUNTIME_DIR/bus if it is a socket
1027   (also fd.o #61301)
1028
1029 • New dbus-update-activation-environment tool uploads environment
1030   variables to "dbus-daemon --session" and optionally "systemd --user",
1031   primarily as a way to keep the per-user bus compatible with
1032   distributions' existing X11 login scripts (also fd.o #61301)
1033
1034 • <includedir/> elements in dbus-daemon configuration are now silently
1035   ignored if the directory does not exist. (fd.o #89280, Dimitri John Ledkov)
1036
1037 • Add microsecond-resolution timestamps to the default output of
1038   dbus-monitor and dbus-send (fd.o #88896; Ralf Habacker, Simon McVittie)
1039
1040 Fixes:
1041
1042 • Fix a race condition in the 'monitor' test introduced in 1.9.10
1043   (fd.o #89222, Simon McVittie)
1044
1045 D-Bus 1.9.12 (2015-02-19)
1046 ==
1047
1048 The “monster lasagna” release.
1049
1050 Dependencies:
1051
1052 • Ducktype and yelp-tools are now required to build complete documentation
1053   (they are optional for normal builds).
1054
1055 Enhancements:
1056
1057 • D-Bus Specification version 0.26
1058   · GetConnectionCredentials can return LinuxSecurityLabel or WindowsSID
1059   · document the BecomeMonitor method
1060
1061 • On Linux, add LinuxSecurityLabel to GetConnectionCredentials
1062   (fd.o #89041; Tyler Hicks, Simon McVittie)
1063
1064 • On Linux, add support for AppArmor mediation of message sending and
1065   receiving and name ownership (paralleling existing SELinux mediation
1066   support), and eavesdropping (a new check, currently AppArmor-specific)
1067   (fd.o #75113; John Johansen, Tyler Hicks, Simon McVittie)
1068
1069 • In dbus-send and dbus-monitor, pretty-print \0-terminated bytestrings
1070   that have printable ASCII contents; we previously only did this for
1071   unterminated bytestrings (fd.o #89109, Simon McVittie)
1072
1073 • Add a guide to designing good D-Bus APIs (fd.o #88994, Philip Withnall)
1074
1075 • On Windows, add WindowsSID to GetConnectionCredentials
1076   (fd.o #54445, Ralf Habacker)
1077
1078 • Improve clarity of dbus-monitor --profile output and add more columns
1079   (fd.o #89165, Ralf Habacker)
1080
1081 • Add a man page for dbus-test-tool, and build it under CMake as well
1082   as Autotools (fd.o#89086, Simon McVittie)
1083
1084 • If dbus-daemon was compiled with --enable-verbose, add a D-Bus API
1085   to control it at runtime, overriding the DBUS_VERBOSE environment variable
1086   (fd.o #88896, Ralf Habacker)
1087
1088 Fixes:
1089
1090 • Reduce the number of file descriptors used in the fd-passing test,
1091   avoiding failure under the default Linux fd limit, and automatically
1092   skip it if the rlimit is too small (fd.o #88998, Simon McVittie)
1093
1094 D-Bus 1.9.10 (2015-02-09)
1095 ==
1096
1097 The “sad cyborgs” release.
1098
1099 Security fixes merged from 1.8.16:
1100
1101 • Do not allow non-uid-0 processes to send forged ActivationFailure
1102   messages. On Linux systems with systemd activation, this would
1103   allow a local denial of service: unprivileged processes could
1104   flood the bus with these forged messages, winning the race with
1105   the actual service activation and causing an error reply
1106   to be sent back when service auto-activation was requested.
1107   This does not prevent the real service from being started,
1108   so the attack only works while the real service is not running.
1109   (CVE-2015-0245, fd.o #88811; Simon McVittie)
1110
1111 Enhancements:
1112
1113 • The new Monitoring interface in the dbus-daemon lets dbus-monitor and
1114   similar tools receive messages without altering the security properties
1115   of the system bus, by calling the new BecomeMonitor method on a
1116   private connection. This bypasses the normal <allow> and <deny> rules
1117   entirely, so to preserve normal message-privacy assumptions, only root
1118   is allowed to do this on the system bus. Restricted environments,
1119   such as Linux with LSMs, should lock down access to the Monitoring
1120   interface. (fd.o #46787, Simon McVittie)
1121
1122 • dbus-monitor uses BecomeMonitor to capture more traffic, if the
1123   dbus-daemon supports it and access permissions allow it.
1124   It still supports the previous approach ("eavesdropping" match rules)
1125   for compatibility with older bus daemons. (fd.o #46787, Simon)
1126
1127 • dbus-monitor can now log the message stream as binary data for later
1128   analysis, with either no extra framing beyond the normal D-Bus headers,
1129   or libpcap-compatible framing treating each D-Bus message
1130   as a captured packet. (fd.o #46787, Simon)
1131
1132 Other fixes:
1133
1134 • Fix some CMake build regressions (fd.o #88964, Ralf Habacker)
1135
1136 • On Unix, forcibly terminate regression tests after 60 seconds to
1137   prevent them from blocking continuous integration frameworks
1138   (fd.o #46787, Simon)
1139
1140 D-Bus 1.9.8 (2015-02-03)
1141 ==
1142
1143 The “all the types of precipitation” release.
1144
1145 Dependencies:
1146
1147 • full test coverage now requires GLib 2.36
1148 • full test coverage now requires PyGI (PyGObject 3,
1149   "import gi.repository.GObject") instead of the
1150   obsolete PyGObject 2 ("import gobject")
1151
1152 Enhancements:
1153
1154 • add GLib-style "installed tests" (fd.o #88810, Simon McVittie)
1155
1156 • better regression test coverage, including systemd activation
1157   (fd.o #57952, #88810; Simon McVittie)
1158
1159 Fixes:
1160
1161 • fatal errors correctly make the dbus-daemon exit even if <syslog/> is
1162   turned off (fd.o #88808, Simon McVittie)
1163
1164 • TCP sockets on Windows no longer fail to listen approximately 1 time
1165   in 256, caused by a logic error that should have always made it fail but
1166   was mitigated by incorrect endianness for the port number
1167   (fd.o #87999, Ralf Habacker)
1168
1169 • fix some Windows build failures (fd.o #88009, #88010; Ralf Habacker)
1170
1171 • on Windows, allow up to 8K connections to the dbus-daemon instead of the
1172   previous 64, completing a previous fix which only worked under
1173   Autotools (fd.o #71297, Ralf Habacker)
1174
1175 • on Windows, if the IP family is unspecified only use IPv4,
1176   to mitigate IPv6 not working correctly (fd.o #87999, Ralf Habacker)
1177
1178 • fix some unlikely memory leaks on OOM (fd.o #88087, Simon McVittie)
1179
1180 • lcov code coverage analysis works again (fd.o #88808, Simon McVittie)
1181
1182 • fix an unused function error with --disable-embedded-tests (fd.o #87837,
1183   Thiago Macieira)
1184
1185 D-Bus 1.9.6 (2015-01-05)
1186 ==
1187
1188 The “I do have a bread knife” release.
1189
1190 Security hardening:
1191
1192 • Do not allow calls to UpdateActivationEnvironment from uids other than
1193   the uid of the dbus-daemon. If a system service installs unsafe
1194   security policy rules that allow arbitrary method calls
1195   (such as CVE-2014-8148) then this prevents memory consumption and
1196   possible privilege escalation via UpdateActivationEnvironment.
1197
1198   We believe that in practice, privilege escalation here is avoided
1199   by dbus-daemon-launch-helper sanitizing its environment; but
1200   it seems better to be safe.
1201
1202 • Do not allow calls to UpdateActivationEnvironment or the Stats interface
1203   on object paths other than /org/freedesktop/DBus. Some system services
1204   install unsafe security policy rules that allow arbitrary method calls
1205   to any destination, method and interface with a specified object path;
1206   while less bad than allowing arbitrary method calls, these security
1207   policies are still harmful, since dbus-daemon normally offers the
1208   same API on all object paths and other system services might behave
1209   similarly.
1210
1211 Other fixes:
1212
1213 • Add missing initialization so GetExtendedTcpTable doesn't crash on
1214   Windows Vista SP0 (fd.o #77008, Илья А. Ткаченко)
1215
1216 D-Bus 1.9.4 (2014-11-24)
1217 ==
1218
1219 The “extra-sturdy caramel” release.
1220
1221 Fixes:
1222
1223 • Partially revert the CVE-2014-3639 patch by increasing the default
1224   authentication timeout on the system bus from 5 seconds back to 30
1225   seconds, since this has been reported to cause boot regressions for
1226   some users, mostly with parallel boot (systemd) on slower hardware.
1227
1228   On fast systems where local users are considered particularly hostile,
1229   administrators can return to the 5 second timeout (or any other value
1230   in milliseconds) by saving this as /etc/dbus-1/system-local.conf:
1231
1232   <busconfig>
1233     <limit name="auth_timeout">5000</limit>
1234   </busconfig>
1235
1236   (fd.o #86431, Simon McVittie)
1237
1238 • Add a message in syslog/the Journal when the auth_timeout is exceeded
1239   (fd.o #86431, Simon McVittie)
1240
1241 • Send back an AccessDenied error if the addressed recipient is not allowed
1242   to receive a message (and in builds with assertions enabled, don't
1243   assert under the same conditions). (fd.o #86194, Jacek Bukarewicz)
1244
1245 D-Bus 1.9.2 (2014-11-10)
1246 ==
1247
1248 The “structurally unsound flapjack” release.
1249
1250 Security fixes:
1251
1252 • Increase dbus-daemon's RLIMIT_NOFILE rlimit to 65536
1253   so that CVE-2014-3636 part A cannot exhaust the system bus'
1254   file descriptors, completing the incomplete fix in 1.8.8.
1255   (CVE-2014-7824, fd.o #85105; Simon McVittie, Alban Crequy)
1256
1257 Enhancements:
1258
1259 • D-Bus Specification version 0.25
1260   · new value 'const' for EmitsChangedSignal annotation
1261     (fd.o #72958, Lennart Poettering)
1262   · new ALLOW_INTERACTIVE_AUTHORIZATION flag, for PolicyKit and similar
1263     (fd.o #83449; Lennart Poettering, Simon McVittie)
1264   · annotate table of types with reserved/basic/container, and for
1265     basic types, fixed/string-like
1266   · clarify arbitrary limits by quoting them in mebibytes
1267
1268 • New API: add accessors for the ALLOW_INTERACTIVE_AUTHORIZATION flag
1269   (fd.o #83449, Simon McVittie)
1270
1271 • Add dbus-test-tool, a D-Bus swiss army knife with multiple subcommands,
1272   useful for debugging and performance testing:
1273   · dbus-test-tool spam: send repeated messages
1274   · dbus-test-tool echo: send an empty reply for all method calls
1275   · dbus-test-tool black-hole: do not reply to method calls
1276   (fd.o #34140; Alban Crequy, Simon McVittie, Will Thompson)
1277
1278 • Add support for process ID in credentials-passing on NetBSD
1279   (fd.o #69702, Patrick Welche)
1280
1281 • Add an example script to find potentially undesired match rules
1282   (fd.o #84598, Alban Crequy)
1283
1284 • Document the central assumption that makes our use of credentials-passing
1285   secure (fd.o #83499, Simon McVittie)
1286
1287 • Replace the dbus-glib section of the tutorial with a GDBus recommendation,
1288   and add some links to GDBus and QtDBus documentation (fd.o #25140,
1289   Simon McVittie)
1290
1291 Fixes:
1292
1293 • Use a less confusing NoReply message when disconnected with a reply pending
1294   (fd.o #76112, Simon McVittie)
1295
1296 • Make the .pc file relocatable by letting pkg-config do all variable
1297   expansion itself (fd.o #75858, Руслан Ижбулатов)
1298
1299 • Fix a build failure on platforms with kqueue, which regressed in 1.9.0
1300   (fd.o #85563, Patrick Welche)
1301
1302 • Consistently save errno after socket calls (fd.o #83625, Simon McVittie)
1303
1304 • In dbus-spawn, when the grandchild process exits due to a failed exec(),
1305   do not lose the exec() errno (fd.o #24821, Simon McVittie)
1306
1307 • Do not fail the tests if a parent process has leaked non-close-on-exec
1308   file descriptors to us (fd.o #73689, fd.o #83899; Simon McVittie)
1309
1310 • Do not fail the tests on Unix platforms with incomplete
1311   credentials-passing support, but do fail if we can't pass credentials
1312   on a platform where it is known to work: Linux, FreeBSD, OpenBSD, NetBSD
1313   (fd.o #69702, Simon McVittie)
1314
1315 • Detect accept4, dirfd, inotify_init1, pipe2, and Unix fd passing
1316   when building with cmake, and expand test coverage there
1317   (fd.o #73689; Ralf Habacker, Simon McVittie)
1318
1319 D-Bus 1.9.0 (2014-10-01)
1320 ==
1321
1322 The “tiered cheeses” release.
1323
1324 Requirements:
1325
1326 • Support for the systemd: (LISTEN_FDS) pseudo-transport on Linux now
1327   requires either the libsystemd or libsd-daemon shared library, dropping the
1328   embedded convenience copy of sd-daemon (fd.o #71818, Simon)
1329
1330 Build-time configuration changes:
1331
1332 • The Stats interface is now enabled by default, and locked-down to
1333   root-only on the system bus. Configure with --disable-stats
1334   to disable it altogether on memory- or disk-constrained systems,
1335   or see ${docdir}/examples/ to open it up to non-root users on the
1336   system bus or restrict access on the session bus.
1337   (fd.o #80759; Simon McVittie, Alban Crequy)
1338
1339 • The CMake build system now builds the same shared library name as Autotools
1340   on at least Linux and Windows:
1341   - on Linux (and perhaps other Unix platforms), it previously built
1342     libdbus-1.so, but now builds libdbus-1.so.3.* with development
1343     symlink libdbus-1.so and SONAME/symlink libdbus-1.so.3
1344   - on Windows, it previously built either libdbus-1.dll (release) or
1345     libdbus-1d.dll (debug), but now builds libdbus-1-3.dll, copied to
1346     libdbus-1.dll for compatibility with older applications.
1347   (fd.o #74117, Ralf Habacker)
1348
1349 Enhancements:
1350
1351 • D-Bus Specification version 0.24
1352   · document how to quote match rules (fd.o #24307, Simon McVittie)
1353   · explicitly say that most message types never expect a reply
1354     regardles of whether they have NO_REPLY_EXPECTED
1355     (fd.o #75749, Simon McVittie)
1356
1357 • on Unix platforms, disable Nagle's algorithm on TCP connections to improve
1358   initial latency (fd.o #75544, Matt Hoosier)
1359
1360 • use backtrace() if it is in -lexecinfo instead of libc, as on NetBSD
1361   (fd.o #69702, Patrick Welche)
1362
1363 • in dbus-monitor, print more information about file descriptors
1364   (fd.o #80603, Alban Crequy)
1365
1366 • do not install system bus configuration if built for Windows
1367   (fd.o #83583; Ralf Habacker, Simon McVittie)
1368
1369 • Add GetAllMatchRules to the Stats interface (fd.o #24307, Alban Crequy)
1370
1371 • Add a regression test for file descriptor passing (fd.o #83622,
1372   Simon McVittie)
1373
1374 Fixes:
1375
1376 • fix an incorrect error message if a Unix socket path is too long
1377   (fd.o #73887, Antoine Jacoutot)
1378
1379 • in an MSYS/Cygwin environment, pass Unix-style filenames to xmlto,
1380   fixing documentation generation (fd.o #75860, Руслан Ижбулатов)
1381
1382 • in Unix with X11, avoid giving dbus-launch a misleading argv[0]
1383   in ps(1) (fd.o #69716, Chengwei Yang)
1384
1385 • avoid calling poll() with timeout < -1, which is considered invalid
1386   on FreeBSD and NetBSD (fd.o #78480, Jaap Boender)
1387
1388 • be portable to BSD-derived platforms where O_CLOEXEC is unavailable in libc
1389   (like Mac OS X 10.6), or available in libc but unsupported by the kernel
1390   (fd.o #77032; rmvsxop, OBATA Akio, Patrick Welche)
1391
1392 • Fix include path for test/internal/*.c with cmake (Ralf Habacker)
1393
1394 • Documentation improvements
1395   (fd.o #80795, #84313; Thomas Haller, Sebastian Rasmussen)
1396
1397 • in dbus-monitor, do not leak file descriptors that we have monitored
1398   (fd.o #80603, Alban Crequy)
1399
1400 • Set the close-on-exec flag for the inotify file descriptor, even
1401   if built with CMake or older libc (fd.o #73689, Simon McVittie)
1402
1403 • Remove some LGPL code from the Windows dbus-daemon
1404   (fd.o #57272, Ralf Habacker)
1405
1406 D-Bus 1.8.8 (2014-09-16)
1407 ==
1408
1409 The "smashy smashy egg man" release.
1410
1411 Security fixes:
1412
1413 • Do not accept an extra fd in the padding of a cmsg message, which
1414   could lead to a 4-byte heap buffer overrun.
1415   (CVE-2014-3635, fd.o #83622; Simon McVittie)
1416
1417 • Reduce default for maximum Unix file descriptors passed per message
1418   from 1024 to 16, preventing a uid with the default maximum number of
1419   connections from exhausting the system bus' file descriptors under
1420   Linux's default rlimit. Distributors or system administrators with a
1421   more restrictive fd limit may wish to reduce these limits further.
1422
1423   Additionally, on Linux this prevents a second denial of service
1424   in which the dbus-daemon can be made to exceed the maximum number
1425   of fds per sendmsg() and disconnect the process that would have
1426   received them.
1427   (CVE-2014-3636, fd.o #82820; Alban Crequy)
1428
1429 • Disconnect connections that still have a fd pending unmarshalling after
1430   a new configurable limit, pending_fd_timeout (defaulting to 150 seconds),
1431   removing the possibility of creating an abusive connection that cannot be
1432   disconnected by setting up a circular reference to a connection's
1433   file descriptor.
1434   (CVE-2014-3637, fd.o #80559; Alban Crequy)
1435
1436 • Reduce default for maximum pending replies per connection from 8192 to 128,
1437   mitigating an algorithmic complexity denial-of-service attack
1438   (CVE-2014-3638, fd.o #81053; Alban Crequy)
1439
1440 • Reduce default for authentication timeout on the system bus from
1441   30 seconds to 5 seconds, avoiding denial of service by using up
1442   all unauthenticated connection slots; and when all unauthenticated
1443   connection slots are used up, make new connection attempts block
1444   instead of disconnecting them.
1445   (CVE-2014-3639, fd.o #80919; Alban Crequy)
1446
1447 Other fixes:
1448
1449 • Check for libsystemd from systemd >= 209, falling back to
1450   the older separate libraries if not found (Umut Tezduyar Lindskog,
1451   Simon McVittie)
1452
1453 • On Linux, use prctl() to disable core dumps from a test executable
1454   that deliberately raises SIGSEGV to test dbus-daemon's handling
1455   of that condition (fd.o #83772, Simon McVittie)
1456
1457 • Fix compilation with --enable-stats (fd.o #81043, Gentoo #507232;
1458   Alban Crequy)
1459
1460 • Improve documentation for running tests on Windows (fd.o #41252,
1461   Ralf Habacker)
1462
1463 D-Bus 1.8.6 (2014-06-02)
1464 ==
1465
1466 Security fixes:
1467
1468 • On Linux ≥ 2.6.37-rc4, if sendmsg() fails with ETOOMANYREFS, silently drop
1469   the message. This prevents an attack in which a malicious client can
1470   make dbus-daemon disconnect a system service, which is a local
1471   denial of service.
1472   (fd.o #80163, CVE-2014-3532; Alban Crequy)
1473
1474 • Track remaining Unix file descriptors correctly when more than one
1475   message in quick succession contains fds. This prevents another attack
1476   in which a malicious client can make dbus-daemon disconnect a system
1477   service.
1478   (fd.o #79694, fd.o #80469, CVE-2014-3533; Alejandro Martínez Suárez,
1479   Simon McVittie, Alban Crequy)
1480
1481 Other fixes:
1482
1483 • When dbus-launch --exit-with-session starts a dbus-daemon but then cannot
1484   attach to a session, kill the dbus-daemon as intended
1485   (fd.o #74698, Роман Донченко)
1486
1487 D-Bus 1.8.4 (2014-06-10)
1488 ==
1489
1490 Security fix:
1491
1492 • Alban Crequy at Collabora Ltd. discovered and fixed a denial-of-service
1493   flaw in dbus-daemon, part of the reference implementation of D-Bus.
1494   Additionally, in highly unusual environments the same flaw could lead to
1495   a side channel between processes that should not be able to communicate.
1496   (CVE-2014-3477, fd.o #78979)
1497
1498 D-Bus 1.8.2 (2014-04-30)
1499 ==
1500
1501 The “nobody wants red” release.
1502
1503 Enhancements:
1504
1505 • in the CMake build system, add some hints for Linux users cross-compiling
1506   Windows D-Bus binaries to be able to run tests under Wine
1507   (fd.o #41252, Ralf Habacker)
1508
1509 • add Documentation key to dbus.service (fd.o #77447, Cameron Norman)
1510
1511 Fixes:
1512
1513 • in "dbus-uuidgen --ensure", try to copy systemd's /etc/machine-id
1514   to /var/lib/dbus/machine-id instead of generating an entirely new ID
1515   (fd.o #77941, Simon McVittie)
1516
1517 • if dbus-launch receives an X error very quickly, do not kill
1518   unrelated processes (fd.o #74698, Роман Донченко)
1519
1520 • on Windows, allow up to 8K connections to the dbus-daemon, instead of the
1521   previous 64 (fd.o #71297; Cristian Onet, Ralf Habacker)
1522
1523 • cope with \r\n newlines in regression tests, since on Windows,
1524   dbus-daemon.exe uses text mode (fd.o #75863, Руслан Ижбулатов)
1525
1526 D-Bus 1.8.0 (2014-01-20)
1527 ==
1528
1529 The “Wolverine distrusts my printer” release.
1530
1531 This starts a new stable branch. The 1.6.x branch is now considered to be
1532 outdated, and will only receive fixes for serious bugs such as security
1533 flaws. The 1.4.x and 1.2.x branches no longer have upstream support and
1534 are unlikely to get any more releases, but if distributors still need to
1535 support them, please share security patches via upstream.
1536
1537 Summary of changes since 1.6.x:
1538
1539 • libdbus always behaves as if dbus_threads_init_default() had been called
1540   (thread-safety by default)
1541 • new dbus-run-session tool, replacing certain misuses of dbus-launch
1542 • dbus-monitor can talk to outdated versions of dbus-daemon again
1543 • new org.freedesktop.DBus.GetConnectionCredentials method
1544 • GetConnectionUnixProcessID also works correctly on Windows, returning
1545   the Windows process ID
1546 • GetConnectionWindowsSID returns the correct SID on Windows
1547 • expat is required, libxml2 can no longer be used as a substitute
1548 • the userDB cache is required, and cannot be disabled
1549 • a 64-bit integer type (either int, long, long long or _int64) is required
1550 • better systemd-journald integration on Linux
1551 • fixed long-standing fd and array leaks when failing to parse a message
1552 • fixed referenced-but-never-freed parent nodes (effectively memory leaks)
1553   when using certain object-path allocation patterns, notably in Avahi
1554 • better defaults for Windows support
1555 • better CMake support
1556 • better portability to mingw32, FreeBSD, NetBSD, QNX and Hurd
1557 • the source language for the man pages is now Docbook XML
1558
1559 Enhancements since 1.7.10:
1560
1561 • Enhance the CMake build system to check for GLib and compile/run
1562   a subset of the regression tests (fd.o #41252, #73495; Ralf Habacker)
1563
1564 Fixes since 1.7.10:
1565
1566 • don't rely on va_copy(), use DBUS_VA_COPY() wrapper (fd.o #72840,
1567   Ralf Habacker)
1568
1569 • fix compilation of systemd journal support on older systemd versions where
1570   sd-journal.h doesn't include syslog.h (fd.o #73455, Ralf Habacker)
1571
1572 • fix compilation on older MSVC versions by including stdlib.h
1573   (fd.o #73455, Ralf Habacker)
1574
1575 • Allow <allow_anonymous/> to appear in an included configuration file
1576   (fd.o #73475, Matt Hoosier)
1577
1578 Test behaviour changes since 1.7.10:
1579
1580 • If the tests crash with an assertion failure, they no longer default to
1581   blocking for a debugger to be attached. Set DBUS_BLOCK_ON_ABORT in the
1582   environment if you want the old behaviour.
1583
1584 • To improve debuggability, the dbus-daemon and dbus-daemon-eavesdrop tests
1585   can be run with an external dbus-daemon by setting
1586   DBUS_TEST_DAEMON_ADDRESS in the environment. Test-cases that require
1587   an unusually-configured dbus-daemon are skipped.
1588
1589 D-Bus 1.7.10 (2014-01-06)
1590 ==
1591
1592 The “weighted companion cube” release.
1593
1594 This is a release candidate for D-Bus 1.8.
1595
1596 D-Bus Specification 0.23:
1597
1598 • don't require messages with no INTERFACE to be dispatched
1599   (fd.o #68597, Simon McVittie)
1600
1601 • document "tcp:bind=..." and "nonce-tcp:bind=..." (fd.o #72301,
1602   Chengwei Yang)
1603
1604 • define "listenable" and "connectable" addresses, and discuss
1605   the difference (fd.o #61303, Simon McVittie)
1606
1607 Enhancements:
1608
1609 • support printing Unix file descriptors in dbus-send, dbus-monitor
1610   (fd.o #70592, Robert Ancell)
1611
1612 • don't install systemd units if --disable-systemd is given
1613   (fd.o #71818, Chengwei Yang)
1614
1615 Fixes:
1616
1617 • don't leak memory on out-of-memory while listing activatable or
1618   active services (fd.o #71526, Radoslaw Pajak)
1619
1620 • fix undefined behaviour in a regression test (fd.o #69924, DreamNik)
1621
1622 • escape Unix socket addresses correctly (fd.o #46013, Chengwei Yang)
1623
1624 • on SELinux systems, don't assume that SECCLASS_DBUS, DBUS__ACQUIRE_SVC
1625   and DBUS__SEND_MSG are numerically equal to their values in the
1626   reference policy (fd.o #88719, osmond sun)
1627
1628 • define PROCESS_QUERY_LIMITED_INFORMATION if missing from MinGW < 4 headers
1629   (fd.o #71366, Matt Fischer)
1630
1631 • define WIN32_LEAN_AND_MEAN to avoid conflicts between winsock.h and
1632   winsock2.h (fd.o #71405, Matt Fischer)
1633
1634 • do not return failure from _dbus_read_nonce() with no error set,
1635   preventing a potential crash (fd.o #72298, Chengwei Yang)
1636
1637 • on BSD systems, avoid some O(1)-per-process memory and fd leaks in kqueue,
1638   preventing test failures (fd.o #69332, fd.o #72213; Chengwei Yang)
1639
1640 • fix warning spam on Hurd by not trying to set SO_REUSEADDR on Unix sockets,
1641   which doesn't do anything anyway on at least Linux and FreeBSD
1642   (fd.o #69492, Simon McVittie)
1643
1644 • fix use of TCP sockets on FreeBSD and Hurd by tolerating EINVAL from
1645   sendmsg() with SCM_CREDS (retrying with plain send()), and looking
1646   for credentials more correctly (fd.o #69492, Simon McVittie)
1647
1648 • ensure that tests run with a temporary XDG_RUNTIME_DIR to avoid
1649   getting mixed up in XDG/systemd "user sessions" (fd.o #61301,
1650   Simon McVittie)
1651
1652 • refresh cached policy rules for existing connections when bus
1653   configuration changes (fd.o #39463, Chengwei Yang)
1654
1655 D-Bus 1.7.8 (2013-11-01)
1656 ==
1657
1658 The “extreme hills” release.
1659
1660 Dependencies:
1661
1662 • If systemd support is enabled, libsystemd-journal is now required.
1663
1664 Enhancements:
1665
1666 • When activating a non-systemd service under systemd, annotate its
1667   stdout/stderr with its bus name in the Journal. Known limitation:
1668   because the socket is opened before forking, the process will still be
1669   logged as if it had dbus-daemon's process ID and user ID.
1670   (fd.o #68559, Chengwei Yang)
1671
1672 • Document more configuration elements in dbus-daemon(1)
1673   (fd.o #69125, Chengwei Yang)
1674
1675 Fixes:
1676
1677 • Don't leak string arrays or fds if dbus_message_iter_get_args_valist()
1678   unpacks them and then encounters an error (fd.o #21259, Chengwei Yang)
1679
1680 • If compiled with libaudit, retain CAP_AUDIT_WRITE so we can write
1681   disallowed method calls to the audit log, fixing a regression in 1.7.6
1682   (fd.o #49062, Colin Walters)
1683
1684 • path_namespace='/' in match rules incorrectly matched nothing; it
1685   now matches everything. (fd.o #70799, Simon McVittie)
1686
1687 D-Bus 1.7.6 (2013-10-09)
1688 ==
1689
1690 The “CSI Shrewsbury” release.
1691
1692 Build-time configuration changes:
1693
1694 • Directory change notification via dnotify on Linux is no longer
1695   supported; it hadn't compiled successfully since 2010 in any case.
1696   If you don't have inotify (Linux) or kqueue (*BSD), you will need
1697   to send SIGHUP to the dbus-daemon when its configuration changes.
1698   (fd.o #33001, Chengwei Yang)
1699
1700 • Compiling with --disable-userdb-cache is no longer supported;
1701   it didn't work since at least 2008, and would lead to an extremely
1702   slow dbus-daemon even it worked. (fd.o #15589, #17133, #66947;
1703   Chengwei Yang)
1704
1705 • The DBUS_DISABLE_ASSERTS CMake option didn't actually disable most
1706   assertions. It has been renamed to DBUS_DISABLE_ASSERT to be consistent
1707   with the Autotools build system. (fd.o #66142, Chengwei Yang)
1708
1709 • --with-valgrind=auto enables Valgrind instrumentation if and only if
1710   valgrind headers are available. The default is still --with-valgrind=no.
1711   (fd.o #56925, Simon McVittie)
1712
1713 Dependencies:
1714
1715 • Platforms with no 64-bit integer type are no longer supported.
1716   (fd.o #65429, Simon McVittie)
1717
1718 • GNU make is now (documented to be) required. (fd.o #48277, Simon McVittie)
1719
1720 • Full test coverage no longer requires dbus-glib, although the tests do not
1721   exercise the shared library (only a static copy) if dbus-glib is missing.
1722   (fd.o #68852, Simon McVittie)
1723
1724 Enhancements:
1725
1726 • D-Bus Specification 0.22
1727   · Document GetAdtAuditSessionData() and
1728     GetConnectionSELinuxSecurityContext() (fd.o #54445, Simon)
1729   · Fix example .service file (fd.o #66481, Chengwei Yang)
1730   · Don't claim D-Bus is "low-latency" (lower than what?), just
1731     give factual statements about it supporting async use
1732     (fd.o #65141, Justin Lee)
1733   · Document the contents of .service files, and the fact that
1734     system services' filenames are constrained
1735     (fd.o #66608; Simon McVittie, Chengwei Yang)
1736
1737 • Be thread-safe by default on all platforms, even if
1738   dbus_threads_init_default() has not been called. For compatibility with
1739   older libdbus, library users should continue to call
1740   dbus_threads_init_default(): it is harmless to do so.
1741   (fd.o #54972, Simon McVittie)
1742
1743 • Add GetConnectionCredentials() method (fd.o #54445, Simon)
1744
1745 • New API: dbus_setenv(), a simple wrapper around setenv().
1746   Note that this is not thread-safe. (fd.o #39196, Simon)
1747
1748 • Add dbus-send --peer=ADDRESS (connect to a given peer-to-peer connection,
1749   like --address=ADDRESS in previous versions) and dbus-send --bus=ADDRESS
1750   (connect to a given bus, like dbus-monitor --address=ADDRESS).
1751   dbus-send --address still exists for backwards compatibility,
1752   but is no longer documented. (fd.o #48816, Andrey Mazo)
1753
1754 • Windows-specific:
1755   · "dbus-daemon --nofork" is allowed on Windows again. (fd.o #68852,
1756     Simon McVittie)
1757
1758 Fixes:
1759
1760 • Avoid an infinite busy-loop if a signal interrupts waitpid()
1761   (fd.o #68945, Simon McVittie)
1762
1763 • Clean up memory for parent nodes when objects are unexported
1764   (fd.o #60176, Thomas Fitzsimmons)
1765
1766 • Make dbus_connection_set_route_peer_messages(x, FALSE) behave as
1767   documented. Previously, it assumed its second parameter was TRUE.
1768   (fd.o #69165, Chengwei Yang)
1769
1770 • Escape addresses containing non-ASCII characters correctly
1771   (fd.o #53499, Chengwei Yang)
1772
1773 • Document <servicedir> search order correctly (fd.o #66994, Chengwei Yang)
1774
1775 • Don't crash on "dbus-send --session / x.y.z" which regressed in 1.7.4.
1776   (fd.o #65923, Chengwei Yang)
1777
1778 • If malloc() returns NULL in _dbus_string_init() or similar, don't free
1779   an invalid pointer if the string is later freed (fd.o #65959, Chengwei Yang)
1780
1781 • If malloc() returns NULL in dbus_set_error(), don't va_end() a va_list
1782   that was never va_start()ed (fd.o #66300, Chengwei Yang)
1783
1784 • fix build failure with --enable-stats (fd.o #66004, Chengwei Yang)
1785
1786 • fix a regression test on platforms with strict alignment (fd.o #67279,
1787   Colin Walters)
1788
1789 • Avoid calling function parameters "interface" since certain Windows headers
1790   have a namespace-polluting macro of that name (fd.o #66493, Ivan Romanov)
1791
1792 • Assorted Doxygen fixes (fd.o #65755, Chengwei Yang)
1793
1794 • Various thread-safety improvements to static variables (fd.o #68610,
1795   Simon McVittie)
1796
1797 • Make "make -j check" work (fd.o #68852, Simon McVittie)
1798
1799 • Fix a NULL pointer dereference on an unlikely error path
1800   (fd.o #69327, Sviatoslav Chagaev)
1801
1802 • Improve valgrind memory pool tracking (fd.o #69326,
1803   Sviatoslav Chagaev)
1804
1805 • Don't over-allocate memory in dbus-monitor (fd.o #69329,
1806   Sviatoslav Chagaev)
1807
1808 • dbus-monitor can monitor dbus-daemon < 1.5.6 again
1809   (fd.o #66107, Chengwei Yang)
1810
1811 • Unix-specific:
1812   · If accept4() fails with EINVAL, as it can on older Linux kernels
1813     with newer glibc, try accept() instead of going into a busy-loop.
1814     (fd.o #69026, Chengwei Yang)
1815   · If socket() or socketpair() fails with EINVAL or EPROTOTYPE,
1816     for instance on Hurd or older Linux with a new glibc, try without
1817     SOCK_CLOEXEC. (fd.o #69073; Pino Toscano, Chengwei Yang)
1818   · Fix a file descriptor leak on an error code path.
1819     (fd.o #69182, Sviatoslav Chagaev)
1820   · dbus-run-session: clear some unwanted environment variables
1821     (fd.o #39196, Simon)
1822   · dbus-run-session: compile on FreeBSD (fd.o #66197, Chengwei Yang)
1823   · Don't fail the autolaunch test if there is no DISPLAY (fd.o #40352, Simon)
1824   · Use dbus-launch from the builddir for testing, not the installed copy
1825     (fd.o #37849, Chengwei Yang)
1826   · Fix compilation if writev() is unavailable (fd.o #69409,
1827     Vasiliy Balyasnyy)
1828   · Remove broken support for LOCAL_CREDS credentials passing, and
1829     document where each credential-passing scheme is used (fd.o #60340,
1830     Simon McVittie)
1831   · Make autogen.sh work on *BSD by not assuming GNU coreutils functionality
1832     (fd.o #35881, #69787; Chengwei Yang)
1833   · dbus-monitor: be portable to NetBSD (fd.o #69842, Chengwei Yang)
1834   · dbus-launch: stop using non-portable asprintf (fd.o #37849, Simon)
1835   · Improve error reporting from the setuid activation helper (fd.o #66728,
1836     Chengwei Yang)
1837
1838 • Windows-specific:
1839   · Remove unavailable command-line options from 'dbus-daemon --help'
1840     (fd.o #42441, Ralf Habacker)
1841   · Add support for looking up local TCPv4 clients' credentials on
1842     Windows XP via the undocumented AllocateAndGetTcpExTableFromStack
1843     function (fd.o #66060, Ralf Habacker)
1844   · Fix insufficient dependency-tracking (fd.o #68505, Simon McVittie)
1845   · Don't include wspiapi.h, fixing a compiler warning (fd.o #68852,
1846     Simon McVittie)
1847
1848 • Internal changes:
1849   · add DBUS_ENABLE_ASSERT, DBUS_ENABLE_CHECKS for less confusing
1850     conditionals (fd.o #66142, Chengwei Yang)
1851   · improve verbose-mode output (fd.o #63047, Colin Walters)
1852   · consolidate Autotools and CMake build (fd.o #64875, Ralf Habacker)
1853   · fix various unused variables, unusual build configurations
1854     etc. (fd.o #65712, #65990, #66005, #66257, #69165, #69410, #70218;
1855     Chengwei Yang, Vasiliy Balyasnyy)
1856
1857 D-Bus 1.7.4 (2013-06-13)
1858 ==
1859
1860 The “but is your thread-safety thread-safe?” release.
1861
1862 Security fixes:
1863
1864 • CVE-2013-2168: Fix misuse of va_list that could be used as a denial
1865   of service for system services. Vulnerability reported by Alexandru Cornea.
1866   (Simon)
1867
1868 Dependencies:
1869
1870 • The Windows version of libdbus now contains a C++ source file, used
1871   to provide global initialization when the library is loaded.
1872   gcc (mingw*) users should ensure that g++ is also installed.
1873
1874 • The libxml2-based configuration reader (which hasn't worked for 2.5 years,
1875   and was never the recommended option) has been removed. Expat is now a
1876   hard dependency.
1877
1878 Enhancements:
1879
1880 • It should now be safe to call dbus_threads_init_default() from any thread,
1881   at any time. Authors of loadable modules and plugins that use libdbus
1882   should consider doing so during initialization.
1883   (fd.o #54972, Simon McVittie)
1884
1885 • Improve dbus-send documentation and command-line parsing (fd.o #65424,
1886   Chengwei Yang)
1887
1888 Unix-specific:
1889   · dbus-run-session: experimental new tool to start a temporary D-Bus
1890     session, e.g. for regression tests or a text console, replacing
1891     certain uses of dbus-launch which weren't really correct
1892     (fd.o #39196, Simon)
1893
1894 Other fixes:
1895
1896 • In dbus-daemon, don't crash if a .service file starts with key=value
1897   (fd.o #60853, Chengwei Yang)
1898
1899 • Unix-specific:
1900   · Fix a crash similar to CVE-2013-2168 the first time we try to use syslog
1901     on a platform not defining LOG_PERROR, such as Solaris or QNX.
1902     This regressed in 1.7.0. (Simon)
1903   · Fix an assertion failure if we try to activate systemd services before
1904     systemd connects to the bus (fd.o #50199, Chengwei Yang)
1905   · Avoid compiler warnings for ignoring the return from write()
1906     (Chengwei Yang)
1907
1908 • Windows-specific:
1909   · Under cmake, install runtime libraries (DLLs) into bin/ instead of lib/
1910     so that Windows finds them (fd.o #59733, Ralf Habacker)
1911
1912 D-Bus 1.7.2 (2013-04-25)
1913 ==
1914
1915 The “only partially opaque” release.
1916
1917 Configuration changes:
1918
1919 • On non-QNX Unix platforms, the default limit on fds per message in the
1920   session bus configuration has reduced from 4096 to 1024. The default
1921   limit used on the system bus was already 1024. On QNX, both limits are
1922   reduced further, to 128.
1923
1924 Enhancements:
1925
1926 • D-Bus Specification 0.21
1927   · Following Unicode Corrigendum #9, the noncharacters U+nFFFE, U+nFFFF,
1928     U+FDD0..U+FDEF are allowed in UTF-8 strings again. (fd.o #63072,
1929     Simon McVittie)
1930
1931 Fixes:
1932
1933 • Diagnose incorrect use of dbus_connection_get_data() with negative slot
1934   (i.e. before allocating the slot) rather than returning junk
1935   (fd.o #63127, Dan Williams)
1936
1937 • Fix a cmake build regression since 1.7.0 (fd.o #63682; Ralf Habacker,
1938   Simon McVittie)
1939
1940 • Unix-specific:
1941   · On Linux, link successfully with glibc 2.17 (fd.o #63166, Simon McVittie)
1942   · Under systemd, log to syslog only, not stderr, avoiding duplication
1943     (fd.o #61399, #39987; Colin Walters, Dagobert Michelsen)
1944   · Under systemd, remove unnecessary dependency on syslog.socket
1945     (fd.o #63531, Cristian Rodríguez)
1946   · Include alloca.h for alloca() if available, fixing compilation on
1947     Solaris 10 (fd.o #63071, Dagobert Michelsen)
1948   · Allow use of systemd-logind without the rest of systemd
1949     (fd.o #62585, Martin Pitt)
1950   · When built with CMake, link to librt and use the right path for
1951     meinproc's XSLT stylesheets (fd.o #61637, Ralf Habacker)
1952   · Reduce the default limit on number of fds per message to 128 under
1953     QNX, working around an arbitrary OS limit (fd.o #61176, Matt Fischer)
1954
1955 • Windows-specific:
1956   · Do not claim that all bus clients have the dbus-daemon's credentials;
1957     pick up local TCPv4 clients' credentials (process ID and security
1958     identifier, i.e. user) using GetExtendedTcpTable() (fd.o #61787,
1959     Ralf Habacker)
1960
1961 D-Bus 1.7.0 (2013-02-22)
1962 ==
1963
1964 The "Disingenuous Assertions" release.
1965
1966 This is a new development release, starting the 1.7.x branch. D-Bus 1.6
1967 remains the recommended version for long-term-supported distributions
1968 or the upcoming GNOME 3.8 release.
1969
1970 Build-time configuration changes:
1971
1972 • The --with-dbus-session-bus-default-address configure option is no longer
1973   supported. Use the new --with-dbus-session-bus-connect-address and
1974   --with-dbus-session-bus-listen-address options instead. On Windows, you
1975   usually want them to have the same argument; on Unix, the defaults are
1976   usually correct.
1977
1978 • Similarly, the DBUS_SESSION_BUS_DEFAULT_ADDRESS CMake variable is no longer
1979   supported; use the new DBUS_SESSION_BUS_LISTEN_ADDRESS and
1980   DBUS_SESSION_BUS_CONNECT_ADDRESS variables instead.
1981
1982 • cmake/cross-compile.sh has been removed. Instead, please use a
1983   cross-toolchain file (-DCMAKE_TOOLCHAIN_FILE) as documented at
1984   <http://www.vtk.org/Wiki/CMake_Cross_Compiling>; or use Autotools
1985   as documented in "info automake Cross-Compilation", and set
1986   PKG_CONFIG_PATH appropriately.
1987
1988 Requirements:
1989
1990 • Man pages now require xmlto (or either xmlto or meinproc, if using CMake).
1991 • man2html is no longer used.
1992
1993 Enhancements:
1994
1995 • D-Bus Specification 0.20
1996   · actually say that /org/freedesktop/DBus is the object that
1997     implements o.fd.DBus (fd.o #51865, Colin Walters)
1998   · various reorganisation for better clarity (fd.o #38252, Simon McVittie)
1999   · stop claiming that all basic types work just like INT32 (strings don't!)
2000
2001 • The "source code" for the man pages is now Docbook XML, eliminating
2002   the outdated duplicate copies used when building with CMake.
2003   (fd.o #59805; Ralf Habacker, Simon McVittie)
2004
2005 Fixes:
2006
2007 • In the activation helper, when compiled for tests, do not reset the system
2008   bus address, fixing the regression tests. (fd.o #52202, Simon)
2009
2010 • Fix building with Valgrind 3.8, at the cost of causing harmless warnings
2011   with Valgrind 3.6 on some compilers (fd.o #55932, Arun Raghavan)
2012
2013 • Merge <servicehelper> from system-local.conf if necessary (fd.o #51560,
2014   Krzysztof Konopko)
2015
2016 • Under CMake, prefer xmlto over meinproc (fd.o #59733, Ralf Habacker)
2017
2018 • Stop duplicating CMake's own logic to find libexpat
2019   (fd.o #59733, Ralf Habacker)
2020
2021 • Don't assume CMake host and build system are the same (fd.o #59733,
2022   Ralf Habacker)
2023
2024 • Avoid deprecation warnings for GLib 2.35 (fd.o #59971, Simon McVittie)
2025
2026 • Unix-specific:
2027   · Check for functions in libpthread correctly, fixing compilation on
2028     (at least) OpenBSD (fd.o #47239, Simon)
2029   · Don't leak temporary fds pointing to /dev/null (fd.o #56927,
2030     Michel HERMIER)
2031   · Update sd-daemon.[ch] from systemd (fd.o #60681)
2032   · Add partial support for QNX (fd.o #60339, fd.o #61176; Matt Fischer)
2033
2034 • Windows-specific:
2035   · The default session bus listening and connecting address is now
2036     "autolaunch:", which makes D-Bus on Windows interoperate with itself
2037     and GDBus "out of the box". Use the configure options and cmake variables
2038     described above if you require a different autolaunch scope.
2039     (fd.o #38201, Simon McVittie)
2040   · Avoid a CMake warning under Cygwin (fd.o #59401, Ralf Habacker)
2041
2042 • Create session.d, system.d directories under CMake (fd.o #41319,
2043   Ralf Habacker)
2044
2045 D-Bus 1.6.8 (2012-09-28)
2046 ==
2047
2048 The "Fix one thing, break another" release.
2049
2050 • Follow up to CVE-2012-3524: The additional hardening
2051   work to use __secure_getenv() as a followup to bug #52202
2052   broke certain configurations of gnome-keyring.  Given
2053   the difficulty of making this work without extensive
2054   changes to gnome-keyring, use of __secure_getenv() is
2055   deferred.
2056
2057 D-Bus 1.6.6 (2012-09-28)
2058 ==
2059
2060 The "Clear the environment in your setuid binaries, please" release.
2061
2062 • CVE-2012-3524: Don't access environment variables (fd.o #52202)
2063   Thanks to work and input from Colin Walters, Simon McVittie,
2064   Geoffrey Thomas, and others.
2065 • Unix-specific:
2066   · Fix compilation on Solaris (fd.o #53286, Jonathan Perkin)
2067   · Work around interdependent headers on OpenBSD by including sys/types.h
2068     before each use of sys/socket.h (fd.o #54418, Brad Smith)
2069
2070 D-Bus 1.6.4 (2012-07-18)
2071 ==
2072
2073 • Detect that users are "at the console" correctly when configured with
2074   a non-default path such as --enable-console-auth-dir=/run/console
2075   (fd.o #51521, Dave Reisner)
2076
2077 • Remove an incorrect assertion from DBusTransport (fd.o #51657,
2078   Simon McVittie)
2079
2080 • Make --enable-developer default to "no" (regression in 1.6.2;
2081   fd.o #51657, Simon McVittie)
2082
2083 • Windows-specific:
2084   · Launch dbus-daemon correctly if its path contains a space
2085     (fd.o #49450, Wolfgang Baron)
2086
2087 D-Bus 1.6.2 (2012-06-27)
2088 ==
2089
2090 The "Ice Cabbage" release.
2091
2092 • Change how we create /var/lib/dbus so it works under Automake >= 1.11.4
2093   (fd.o #51406, Simon McVittie)
2094
2095 • Don't return from dbus_pending_call_set_notify with a lock held on OOM
2096   (fd.o #51032, Simon McVittie)
2097
2098 • Disconnect "developer mode" (assertions, verbose mode etc.) from
2099   Automake maintainer mode. D-Bus developers should now configure with
2100   --enable-developer. Automake maintainer mode is now on by default;
2101   distributions can disable it with --disable-maintainer-mode.
2102   (fd.o #34671, Simon McVittie)
2103
2104 • Automatically define DBUS_STATIC_BUILD in static-only Autotools builds,
2105   fixing linking when targeting Windows (fd.o #33973; william, Simon McVittie)
2106
2107 • Unix-specific:
2108   · Check for libpthread under CMake on Unix (fd.o #47237, Simon McVittie)
2109
2110 D-Bus 1.6.0 (2012-06-05)
2111 ==
2112
2113 The “soul of this machine has improved” release.
2114
2115 This version starts a new stable branch of D-Bus: only bug fixes will
2116 be accepted into 1.6.x. Other changes will now go to the 1.7.x branch.
2117
2118 Summary of changes since 1.4.x:
2119
2120 • New requirements
2121   · PTHREAD_MUTEX_RECURSIVE on Unix
2122   · compiler support for 64-bit integers (int64_t or equivalent)
2123
2124 • D-Bus Specification v0.19
2125
2126 • New dbus-daemon features
2127   · <allow own_prefix="com.example.Service"/> rules allow the service to
2128     own names like com.example.Service.Instance3
2129   · optional systemd integration when checking at_console policies
2130   · --nopidfile option, mainly for use by systemd
2131   · path_namespace and arg0namespace may appear in match rules
2132   · eavesdropping is disabled unless the match rule contains eavesdrop=true
2133
2134 • New public API
2135   · functions to validate various string types (dbus_validate_path() etc.)
2136   · dbus_type_is_valid()
2137   · DBusBasicValue, a union of every basic type
2138
2139 • Bug fixes
2140   · removed an unsafe reimplementation of recursive mutexes
2141   · dbus-daemon no longer busy-loops if it has far too many file descriptors
2142   · dbus-daemon.exe --print-address works on Windows
2143   · all the other bug fixes from 1.4.20
2144
2145 • Other major implementation changes
2146   · on Linux, dbus-daemon uses epoll if supported, for better scalability
2147   · dbus_threads_init() ignores its argument and behaves like
2148     dbus_threads_init_default() instead
2149   · removed the per-connection link cache, improving dbus-daemon performance
2150
2151 • Developer features
2152   · optional Valgrind instrumentation (--with-valgrind)
2153   · optional Stats interface on the dbus-daemon (--enable-stats)
2154   · optionally abort whenever malloc() fails (--enable-embedded-tests
2155     and export DBUS_MALLOC_CANNOT_FAIL=1)
2156
2157 Changes since 1.5.12:
2158
2159 • Be more careful about monotonic time vs. real time, fixing DBUS_COOKIE_SHA1
2160   spec-compliance (fd.o #48580, David Zeuthen)
2161
2162 • Don't use install(1) within the source/build trees, fixing the build as
2163   non-root when using OpenBSD install(1) (fd.o #48217, Antoine Jacoutot)
2164
2165 • Add missing commas in some tcp and nonce-tcp addresses, and remove
2166   an unused duplicate copy of the nonce-tcp transport in Windows builds
2167   (fd.o #45896, Simon McVittie)
2168
2169 D-Bus 1.5.12 (2012-03-27)
2170 ==
2171
2172 The “Big Book of Science” release.
2173
2174 • Add public API to validate various string types:
2175   dbus_validate_path(), dbus_validate_interface(), dbus_validate_member(),
2176   dbus_validate_error_name(), dbus_validate_bus_name(), dbus_validate_utf8()
2177   (fd.o #39549, Simon McVittie)
2178
2179 • Turn DBusBasicValue into public API so bindings don't need to invent their
2180   own "union of everything" type (fd.o #11191, Simon McVittie)
2181
2182 • Enumerate data files included in the build rather than using find(1)
2183   (fd.o #33840, Simon McVittie)
2184
2185 • Add support for policy rules like <allow own_prefix="com.example.Service"/>
2186   in dbus-daemon (fd.o #46273, Alban Crequy)
2187
2188 • Windows-specific:
2189   · make dbus-daemon.exe --print-address (and --print-pid) work again
2190     on Win32, but not on WinCE (fd.o #46049, Simon McVittie)
2191   · fix duplicate case value when compiling against mingw-w64
2192     (fd.o #47321, Andoni Morales Alastruey)
2193
2194 D-Bus 1.5.10 (2012-02-21)
2195 ==
2196
2197 The "fire in Delerium" release.
2198
2199 On Unix platforms, PTHREAD_MUTEX_RECURSIVE (as specified in POSIX 2008 Base
2200 and SUSv2) is now required.
2201
2202 • D-Bus Specification 0.19:
2203   · Formally define unique connection names and well-known bus names,
2204     and document best practices for interface, bus, member and error names,
2205     and object paths (fd.o #37095, Simon McVittie)
2206   · Document the search path for session and system services on Unix, and
2207     where they should be installed by build systems (fd.o #21620, fd.o #35306;
2208     Simon McVittie)
2209   · Document the systemd transport (fd.o #35232, Lennart Poettering)
2210
2211 • Make dbus_threads_init() use the same built-in threading implementation
2212   as dbus_threads_init_default(); the user-specified primitives that it
2213   takes as a parameter are now ignored (fd.o #43744, Simon McVittie)
2214
2215 • Allow all configured auth mechanisms, not just one (fd.o #45106,
2216   Pavel Strashkin)
2217
2218 • Improve cmake build system (Ralf Habacker):
2219   · simplify XML parser dependencies (fd.o #41027)
2220   · generate build timestamp (fd.o #41029)
2221   · only create batch files on Windows
2222   · fix option and cache syntax
2223   · add help-options target
2224   · share dbus-arch-deps.h.in with autotools rather than having our
2225     own version (fd.o #41033)
2226
2227 • Build tests successfully with older GLib, as found in e.g. Debian 6
2228   (fd.o #41219, Simon McVittie)
2229
2230 • Avoid use of deprecated GThread API (fd.o #44413, Martin Pitt)
2231
2232 • Build documentation correctly if man2html doesn't support filenames on
2233   its command-line (fd.o #43875, Jack Nagel)
2234
2235 • Improve test coverage. To get even more coverage, run the tests with
2236   DBUS_TEST_SLOW=1 (fd.o #38285, #42811; Simon McVittie)
2237
2238 • Reduce the size of the shared library by moving functionality only used
2239   by dbus-daemon, tests etc. into their internal library and deleting
2240   unused code (fd.o #34976, #39759; Simon McVittie)
2241
2242 • Add dbus-daemon --nopidfile option, overriding the configuration, for
2243   setups where the default configuration must include <pidfile/> to avoid
2244   breaking traditional init, but the pid file is in fact unnecessary; use
2245   it under systemd to improve startup time a bit (fd.o #45520,
2246   Lennart Poettering)
2247
2248 • Optionally (if configured --with-valgrind) add instrumentation to debug
2249   libdbus and associated tools more meaningfully under Valgrind
2250   (fd.o #37286, Simon McVittie)
2251
2252 • Improve the dbus-send(1) man page (fd.o #14005, Simon McVittie)
2253
2254 • Make dbus-protocol.h compatible with C++11 (fd.o #46147, Marc Mutz)
2255
2256 • If tests are enabled and DBUS_MALLOC_CANNOT_FAIL is set in the environment,
2257   abort on failure to malloc() (like GLib does), to turn runaway memory leaks
2258   into a debuggable core-dump if a resource limit is applied (fd.o #41048,
2259   Simon McVittie)
2260
2261 • Don't crash if realloc() returns NULL in a debug build (fd.o #41048,
2262   Simon McVittie)
2263
2264 • Unix-specific:
2265   · Replace our broken reimplementation of recursive mutexes, which has
2266     been broken since 2006, with an ordinary pthreads recursive mutex
2267     (fd.o #43744; Sigmund Augdal, Simon McVittie)
2268   · Use epoll(7) for a more efficient main loop in Linux; equivalent patches
2269     welcomed for other OSs' equivalents like kqueue, /dev/poll, or Solaris
2270     event ports (fd.o #33337; Simon McVittie, Ralf Habacker)
2271   · When running under systemd, use it instead of ConsoleKit to check
2272     whether to apply at_console policies (fd.o #39609, Lennart Poettering)
2273   · Avoid a highly unlikely fd leak (fd.o #29881, Simon McVittie)
2274   · Don't close invalid fd -1 if getaddrinfo fails (fd.o #37258, eXeC001er)
2275   · Don't touch ~/.dbus and ~/.dbus-keyrings when running 'make installcheck'
2276     (fd.o #41218, Simon McVittie)
2277   · Stop pretending we respect XDG_DATA_DIRS for system services: the launch
2278     helper doesn't obey environment variables to avoid privilege escalation
2279     attacks, so make the system bus follow the same rules
2280     (fd.o #21620, Simon McVittie)
2281
2282 • Windows-specific:
2283   · Find the dbus-daemon executable next to the shared library (fd.o #41558;
2284     Jesper Dam, Ralf Habacker)
2285   · Remove the faulty implementation of _dbus_condvar_wake_all (fd.o #44609,
2286     Simon McVittie)
2287
2288 D-Bus 1.5.8 (2011-09-21)
2289 ==
2290
2291 The "cross-metering" release.
2292
2293 In addition to dead code removal and refactoring, this release contains all
2294 of the bugfixes from 1.4.16.
2295
2296 • Clean up dead code, and make more warnings fatal in development builds
2297   (fd.o #39231, fd.o #41012; Simon McVittie)
2298
2299 • If full test coverage is requested via --enable-tests, strictly require
2300   Python, pygobject and dbus-python, which are required by some tests; if not,
2301   and Python is missing, skip those tests rather than failing
2302   (fd.o #37847, Simon McVittie)
2303
2304 • When using cmake, provide the same version-info API in the installed headers
2305   as for autotools (DBUS_VERSION, etc.) (fd.o #40905, Ralf Habacker)
2306
2307 • Add a regression test for fd.o #38005 (fd.o #39836, Simon McVittie)
2308
2309 • Make "NOCONFIGURE=1 ./autogen.sh" not run configure (Colin Walters)
2310
2311 • Add _DBUS_STATIC_ASSERT and use it to check invariants (fd.o #39636,
2312   Simon McVittie)
2313
2314 • Fix duplicates in authors list (Ralf Habacker)
2315
2316 • Fix broken links from dbus-tutorial.html if $(htmldir) != $(docdir)
2317   (fd.o #39879, Chris Mayo)
2318
2319 • Fix a small memory leak, and a failure to report errors, when updating
2320   a service file entry for activation (fd.o #39230, Simon McVittie)
2321
2322 • Unix-specific:
2323   · Clean up (non-abstract) Unix sockets on bus daemon exit (fd.o #38656;
2324     Brian Cameron, Simon McVittie)
2325   · On systems that use libcap-ng but not systemd, drop supplemental groups
2326     when switching to the daemon user (Red Hat #726953, Steve Grubb)
2327   · Make the cmake build work again on GNU platforms (fd.o #29228,
2328     Simon McVittie)
2329   · Fix compilation on non-C99 systems that have inttypes.h but not stdint.h,
2330     like Solaris (fd.o #40313, Dagobert Michelsen)
2331   · Define CMSG_ALIGN, CMSG_LEN, CMSG_SPACE on Solaris < 10
2332     (fd.o #40235, Simon McVittie)
2333   · Cope with Unixes that don't have LOG_PERROR, like Solaris 10
2334     (fd.o #39987, Simon McVittie)
2335   · Cope with platforms whose vsnprintf violates both POSIX and C99, like
2336     Tru64, IRIX and HP-UX (fd.o #11668, Simon McVittie)
2337
2338 • Windows-specific:
2339   · Fix compilation on MSVC, which doesn't understand "inline" with its
2340     C99 meaning (fd.o #40000; Ralf Habacker, Simon McVittie)
2341   · Fix misuse of GPid in test/dbus-daemon.c (fd.o #40003, Simon McVittie)
2342   · Fix cross-compilation to Windows with Automake (fd.o #40003, Simon McVittie)
2343
2344 D-Bus 1.5.6 (2011-07-29)
2345 ==
2346
2347 The "weird, gravy-like aftertaste" release.
2348
2349 In addition to new features and refactoring, this release contains all of the
2350 bugfixes from 1.4.14.
2351
2352 Potentially incompatible (Bustle and similar debugging tools will need
2353 changes to work as intended):
2354
2355 • Do not allow match rules to "eavesdrop" (receive messages intended for a
2356   different recipient) by mistake: eavesdroppers must now opt-in to this
2357   behaviour by putting "eavesdrop='true'" in the match rule, which will
2358   not have any practical effect on buses where eavesdropping is not allowed
2359   (fd.o #37890, Cosimo Alfarano)
2360
2361 Other changes:
2362
2363 • D-Bus Specification version 0.18 (fd.o #37890, fd.o #39450, fd.o #38252;
2364   Cosimo Alfarano, Simon McVittie)
2365   · add the "eavesdrop" keyword to match rules
2366   · define eavesdropping, unicast messages and broadcast messages
2367   · stop claiming that match rules are needed to match unicast messages to you
2368   · promote the type system to be a top-level section
2369
2370 • Use DBUS_ERROR_OBJECT_PATH_IN_USE if dbus_connection_try_register_object_path
2371   or dbus_connection_try_register_fallback fails, not ...ADDRESS_IN_USE,
2372   and simplify object-path registration (fd.o #38874, Jiří Klimeš)
2373
2374 • Consistently use atomic operations on everything that is ever manipulated
2375   via atomic ops, as was done for changes to DBusConnection's refcount in
2376   1.4.12 (fd.o #38005, Simon McVittie)
2377
2378 • Fix a file descriptor leak when connecting to a TCP socket (fd.o #37258,
2379   Simon McVittie)
2380
2381 • Make "make check" in a clean tree work, by not running tests until
2382   test data has been set up (fd.o #34405, Simon McVittie)
2383
2384 • The dbus-daemon no longer busy-loops if it has a very large number of file
2385   descriptors (fd.o #23194, Simon McVittie)
2386
2387 • Refactor message flow through dispatching to avoid locking violations if
2388   the bus daemon's message limit is hit; remove the per-connection link cache,
2389   which was meant to improve performance, but now reduces it (fd.o #34393,
2390   Simon McVittie)
2391
2392 • Some cmake fixes (Ralf Habacker)
2393
2394 • Remove dead code, mainly from DBusString (fd.o #38570, fd.o #39610;
2395   Simon McVittie, Lennart Poettering)
2396
2397 • Stop storing two extra byte order indicators in each D-Bus message
2398   (fd.o #38287, Simon McVittie)
2399
2400 • Add an optional Stats interface which can be used to get statistics from
2401   a running dbus-daemon if enabled at configure time with --enable-stats
2402   (fd.o #34040, Simon McVittie)
2403
2404 • Fix various typos (fd.o #27227, fd.o #38284; Sascha Silbe, Simon McVittie)
2405
2406 • Documentation (fd.o #36156, Simon McVittie):
2407   · let xsltproc be overridden as usual: ./configure XSLTPROC=myxsltproc
2408   · install more documentation automatically, including man2html output
2409   · put dbus.devhelp in the right place (it must go in ${htmldir})
2410
2411 • Unix-specific:
2412   · look for system services in /lib/dbus-1/system-services in addition to all
2413     the other well-known locations; note that this should always be /lib,
2414     even on platforms where shared libraries on the root FS would go in /lib64,
2415     /lib/x86_64-linux-gnu or similar (fd.o #35229, Lennart Poettering)
2416   · opt-in to fd passing on Solaris (fd.o #33465, Simon McVittie)
2417
2418 • Windows-specific (Ralf Habacker):
2419   · fix use of a mutex for autolaunch server detection
2420   · don't crash on malloc failure in _dbus_printf_string_upper_bound
2421
2422 D-Bus 1.5.4 (2011-06-10)
2423 ==
2424
2425 Security (local denial of service):
2426
2427 • Byte-swap foreign-endian messages correctly, preventing a long-standing
2428   local DoS if foreign-endian messages are relayed through the dbus-daemon
2429   (backporters: this is git commit c3223ba6c401ba81df1305851312a47c485e6cd7)
2430   (CVE-2011-2200, fd.o #38120, Debian #629938; Simon McVittie)
2431
2432 New things:
2433
2434 • The constant to use for an infinite timeout now has a name,
2435   DBUS_TIMEOUT_INFINITE. It is numerically equivalent to 0x7fffffff (INT32_MAX)
2436   which can be used for source compatibility with older versions of libdbus.
2437
2438 • If GLib and DBus-GLib are already installed, more tests will be built,
2439   providing better coverage. The new tests can also be installed via
2440       ./configure --enable-installed-tests
2441   for system integration testing, if required. (fd.o #34570, Simon McVittie)
2442
2443 Changes:
2444
2445 • Consistently use atomic operations for the DBusConnection's refcount,
2446   fixing potential threading problems (fd.o #38005, Simon McVittie)
2447
2448 • Don't use -Wl,--gc-sections by default: in practice the size decrease is
2449   small (300KiB on x86-64) and it frequently doesn't work in unusual
2450   toolchains. To optimize for minimum installed size, you should benchmark
2451   various possibilities for CFLAGS and LDFLAGS, and set the best flags for
2452   your particular toolchain at configure time. (fd.o #33466, Simon McVittie)
2453
2454 • Use #!/bin/sh for run-with-tmp-session-bus.sh, making it work on *BSD
2455   (fd.o #35880, Timothy Redaelli)
2456
2457 • Use ln -fs to set up dbus for systemd, which should fix reinstallation
2458   when not using a DESTDIR (fd.o #37870, Simon McVittie)
2459
2460 • Windows-specific changes:
2461   · don't try to build dbus-daemon-launch-helper (fd.o #37838, Mark Brand)
2462
2463 D-Bus 1.5.2 (2011-06-01)
2464 ==
2465
2466 The "Boar Hunter" release.
2467
2468 Notes for distributors:
2469
2470   This version of D-Bus no longer uses -fPIE by default. Distributions wishing
2471   to harden the dbus-daemon and dbus-launch-helper can re-enable this if their
2472   toolchain supports it reliably, via something like:
2473
2474     ./configure CFLAGS=-fPIE LDFLAGS="-pie -Wl,-z,relro"
2475
2476   or by using distribution-specific wrappers such as Debian's hardening-wrapper.
2477
2478 Changes:
2479
2480   • D-Bus Specification v0.17
2481     · Reserve the extra characters used in signatures by GVariant
2482       (fd.o #34529, Simon McVittie)
2483     · Define the ObjectManager interface (fd.o #34869, David Zeuthen)
2484   • Don't force -fPIE: distributions and libtool know better than we do whether
2485     it's desirable (fd.o #16621, fd.o #27215; Simon McVittie)
2486   • Allow --disable-gc-sections, in case your toolchain offers the
2487     -ffunction-sections, -fdata-sections and -Wl,--gc-sections options
2488     but they're broken, as seen on Solaris (fd.o #33466, Simon McVittie)
2489   • Install dbus-daemon and dbus-daemon-launch-helper in a more normal way
2490     (fd.o #14512; Simon McVittie, loosely based on a patch from Luca Barbato)
2491   • Ensure that maintainers upload documentation with the right permissions
2492     (fd.o #36130, Simon McVittie)
2493   • Don't force users of libdbus to be linked against -lpthread, -lrt
2494     (fd.o #32827, Simon McVittie)
2495   • Log system-bus activation information to syslog (fd.o #35705,
2496     Colin Walters)
2497   • Log messages dropped due to quotas to syslog (fd.o #35358,
2498     Simon McVittie)
2499   • Make the nonce-tcp transport work on Unix (fd.o #34569, Simon McVittie)
2500   • On Unix, if /var/lib/dbus/machine-id cannot be read, try /etc/machine-id
2501     (fd.o #35228, Lennart Poettering)
2502   • In the regression tests, don't report fds as "leaked" if they were open
2503     on startup (fd.o #35173, Simon McVittie)
2504   • Make dbus-monitor bail out if asked to monitor more than one bus,
2505     rather than silently using the last one (fd.o #26548, Will Thompson)
2506   • Clarify documentation (fd.o #35182, Simon McVittie)
2507   • Clean up minor dead code and some incorrect error handling
2508     (fd.o #33128, fd.o #29881; Simon McVittie)
2509   • Check that compiler options are supported before using them (fd.o #19681,
2510     Simon McVittie)
2511   • Windows:
2512     • Remove obsolete workaround for winioctl.h (fd.o #35083, Ralf Habacker)
2513
2514 D-Bus 1.5.0 (2011-04-11)
2515 ==
2516
2517 The "you never know when you need to tow something from your giant
2518 flying shark" release.
2519
2520   • D-Bus Specification v0.16
2521     · Add support for path_namespace and arg0namespace in match rules
2522       (fd.o #24317, #34870; Will Thompson, David Zeuthen, Simon McVittie)
2523     · Make argNpath support object paths, not just object-path-like strings,
2524       and document it better (fd.o #31818, Will Thompson)
2525   • Let the bus daemon implement more than one interface (fd.o #33757,
2526     Simon McVittie)
2527   • Optimize _dbus_string_replace_len to reduce waste (fd.o #21261,
2528     Roberto Guido)
2529   • Require user intervention to compile with missing 64-bit support
2530     (fd.o #35114, Simon McVittie)
2531   • Add dbus_type_is_valid as public API (fd.o #20496, Simon McVittie)
2532   • Raise UnknownObject instead of UnknownMethod for calls to methods on
2533     paths that are not part of the object tree, and UnknownInterface for calls
2534     to unknown interfaces in the bus daemon (fd.o #34527, Lennart Poettering)
2535
2536 D-Bus 1.4.8 (2011-04-08)
2537 ==
2538
2539 The "It's like the beginning of a lobster" release.
2540
2541   • Rename configure.in to configure.ac, and update it to modern conventions
2542     (fd.o #32245; Javier Jardón, Simon McVittie)
2543   • Correctly give XDG_DATA_HOME priority over XDG_DATA_DIRS (fd.o #34496,
2544     Anders Kaseorg)
2545   • Prevent X11 autolaunching if $DISPLAY is unset or empty, and add
2546     --disable-x11-autolaunch configure option to prevent it altogether
2547     in embedded environments (fd.o #19997, NB#219964; Simon McVittie)
2548   • Install the documentation, and an index for Devhelp (fd.o #13495,
2549     Debian #454142; Simon McVittie, Matthias Clasen)
2550   • If checks are not disabled, check validity of string-like types and
2551     booleans when sending them (fd.o #16338, NB#223152; Simon McVittie)
2552   • Add UnknownObject, UnknownInterface, UnknownProperty and PropertyReadOnly
2553     errors to dbus-shared.h (fd.o #34527, Lennart Poettering)
2554   • Break up a huge conditional in config-parser so gcov can produce coverage
2555     data (fd.o #10887, Simon McVittie)
2556   • List which parts of the Desktop Entry specification are applicable to
2557     .service files (fd.o #19159, Sven Herzberg)
2558   • Don't suppress service activation if two services have the same Exec=
2559     (fd.o #35750, Colin Walters)
2560   • Windows:
2561     · Avoid the name ELEMENT_TYPE due to namespace-pollution from winioctl.h
2562       (Andre Heinecke)
2563     · Include _dbus_path_is_absolute in libdbus on Windows, fixing compilation
2564       (fd.o #32805, Mark Brand)
2565
2566 D-Bus 1.4.6 (2010-02-17)
2567 ==
2568
2569 The "1, 2, miss a few, 99, 100" release.
2570
2571   • Remove unfinished changes intended to support GTest-based tests,
2572     which were mistakenly included in 1.4.4
2573
2574 D-Bus 1.4.4 (2010-02-17)
2575 ==
2576
2577   • Switch back to using even micro versions for stable releases; 1.4.1
2578     should have been called 1.4.2, so skip that version number
2579   • Don't leave bad file descriptors being watched when spawning processes,
2580     which could result in a busy-loop (fd.o #32992, NB#200248; possibly
2581     also LP#656134, LP#680444, LP#713157)
2582   • Check for MSG_NOSIGNAL correctly
2583   • Fix failure to detect abstract socket support (fd.o #29895)
2584   • Make _dbus_system_logv actually exit with DBUS_SYSTEM_LOG_FATAL
2585     (fd.o #32262, NB#180486)
2586   • Improve some error code paths (fd.o #29981, fd.o #32264, fd.o #32262,
2587     fd.o #33128, fd.o #33277, fd.o #33126, NB#180486)
2588   • Avoid possible symlink attacks in /tmp during compilation (fd.o #32854)
2589   • Tidy up dead code (fd.o #25306, fd.o #33128, fd.o #34292, NB#180486)
2590   • Improve gcc malloc annotations (fd.o #32710)
2591   • If the system bus is launched via systemd, protect it from the OOM killer
2592   • Documentation improvements (fd.o #11190)
2593   • Avoid readdir_r, which is difficult to use correctly (fd.o #8284,
2594     fd.o #15922, LP#241619)
2595   • Cope with invalid files in session.d, system.d (fd.o #19186,
2596     Debian #230231)
2597   • Don't distribute generated files that embed our builddir (fd.o #30285,
2598     fd.o #34292)
2599   • Raise the system bus's fd limit to be sufficient for its configuration
2600     (fd.o #33474, LP#381063)
2601   • Fix syslog string processing
2602   • Ignore -Waddress
2603   • Remove broken gcov parsing code and --enable-gcov, and replace them
2604     with lcov HTML reports and --enable-compiler-coverage (fd.o #10887)
2605   • Windows:
2606     · avoid live-lock in Windows CE due to unfair condition variables
2607   • OpenBSD:
2608     · support credentials-passing (fd.o #32542)
2609   • Solaris:
2610     · opt-in to thread safety (fd.o #33464)
2611
2612 D-Bus 1.4.1 (20 December 2010)
2613 ==
2614
2615  • Fix for CVE-2010-4352: sending messages with excessively-nested variants can
2616    crash the bus. The existing restriction to 64-levels of nesting previously
2617    only applied to the static type signature; now it also applies to dynamic
2618    nesting using variants. Thanks to Rémi Denis-Courmont for discoving this
2619    issue.
2620  • OS X portability fixes, including launchd support.
2621  • Windows autolaunch improvements.
2622  • Various bug fixes.
2623
2624 D-Bus 1.4.0 (6 Sep 2010)
2625 ==
2626  - systemd hookup
2627
2628 D-Bus 1.3.1 (23 June 2010)
2629 ==
2630  - New standardized PropertiesChanged signal in the properties interface
2631  - Various portability fixes, in particular to Windows platforms
2632  - Support forking bus services, for compatibility
2633
2634 D-Bus 1.3.0 (29 July 2009)
2635 ==
2636  - ability for dbus-send to send to any bus (--address)
2637  - file descriptor passing on Unix socket transports
2638  - use of GCC atomic intrinsics for better processor support
2639    (requires -march=i486 or above for x86 compilation)
2640  - thread-safe FD_CLOEXEC setting on recent Linux kernels (2.6.24-27 and up)
2641    and glibc (2.9 for pipe2 and 2.10 for accept4)
2642  - feature negotiation in the bus daemon