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