Debian Codegraph @

NEWS

raw
1 dbus 1.16.2 (2025-02-27)
2 ========================
3
4 Build system:
5
6 • The branch used for development releases has been renamed to `main`.
7 Please see CONTRIBUTING.md for details of how to update existing checkouts.
8 (dbus#530, Simon McVittie)
9
10 Bug fixes:
11
12 • On Linux, fix build regression with libselinux ≥ 3.8 and verbose mode
13 enabled (Debian#1096212, dbus!511; Simon McVittie)
14
15 Internal changes:
16
17 • Documentation updates
18
19 dbus 1.16.0 (2024-12-16)
20 ========================
21
22 The “one hundred pink frogs” release.
23
24 1.16.x is a new stable branch, superseding 1.14.x.
25
26 Summary of major changes between 1.14.x and 1.16.0
27 --------------------------------------------------
28
29 Build system and dependencies:
30
31 • The Meson build system is the recommended way to build dbus on Unix.
32 This requires Meson 0.56 and Python 3.5.
33 · Projects that depend on libdbus can build it as a Meson subproject.
34 See tests/use-as-subproject/meson.build for suggested build options.
35
36 • CMake continues to be available as an alternative build system,
37 and is recommended on Windows. This requires CMake 3.10.
38
39 • A C99 compiler such as gcc, clang, or Visual Studio 2015 is required.
40 A C11 compiler such as gcc, clang, or Visual Studio 2019 is recommended.
41
42 • On platforms with larger-than-64-bit pointers, a C11 compiler is required
43
44 Behaviour changes:
45
46 • As a result of the move from Autotools to Meson as the recommended
47 build system on Unix, the names of all build-time options have changed.
48 Not all Meson options are a 1:1 replacement for their closest equivalent
49 in Autotools, so the options used for a dbus build should be reviewed.
50
51 • If `meson install` is run as root, and traditional (non-systemd)
52 activation is enabled, the ownership and setuid permission of
53 dbus-daemon-launch-helper are not set automatically.
54 This is not the same as the historical behaviour of the Autotools build
55 system, which would set the ownership and permissions automatically if
56 run as uid 0.
57 The ownership and permissions must now be set by OS distribution packaging,
58 or as a manual post-installation step if dbus is installed directly
59 without going via a packaging system (which is not recommended).
60
61 • On Unix, the well-known system bus socket is in the runtime state
62 directory by default (normally /run)
63 (see 1.15.4 for more details)
64
65 • On Linux with systemd, dbus-daemon starts as the target user/group
66 (retaining CAP_AUDIT_WRITE) instead of starting as root and
67 dropping privileges
68
69 Feature removals:
70
71 • Autotools build system
72
73 • pam_console/pam_foreground integration
74 (Autotools --with-console-auth, CMake -DDBUS_CONSOLE_AUTH_DIR)
75
76 New features and significant bug fixes:
77
78 • ProcessFD in GetConnectionCredentials() on Linux
79 (see 1.15.8 for more details)
80
81 • On Unix, the system message bus now loads .service files from /etc and /run
82
83 • Use close_range() to close unwanted file descriptors or mark them
84 close-on-exec, if available
85
86 • Use 64-bit timestamps internally on 32-bit platforms, for Y2038 safety
87
88 • Use APIs that can return 64-bit timestamps and inode numbers on
89 32-bit glibc
90
91 • AF_UNIX sockets are available on sufficiently recent Windows
92
93 • dbus-send can send arrays of variants, variant values in dictionaries,
94 and nested variants
95
96 • Portability to CPU architectures with larger-than-64-bit pointers
97
98 Changes since 1.15.92 release candidate
99 ---------------------------------------
100
101 Dependencies:
102
103 • Building with CMake now requires CMake ≥ 3.10.
104
105 Bug fixes:
106
107 • Avoid deprecation warnings with newer Meson versions
108 (dbus!507, Simon McVittie)
109
110 • Avoid deprecation warnings with newer CMake versions
111 (dbus#541, Ralf Habacker)
112
113 Tests and CI enhancements:
114
115 • When building with CMake, set the same environment variables as Meson.
116 This improves test coverage. (dbus#533, Ralf Habacker)
117
118 • Remove a remaining reference to Debian 11, which is EOL
119 (dbus!508, Simon McVittie)
120
121 dbus 1.15.92 (2024-12-11)
122 =========================
123
124 The "future flyer" release.
125
126 This is a second release-candidate for the new dbus 1.16.x stable branch.
127
128 Build-time configuration changes:
129
130 • When building with Meson, the embedded_tests option has been renamed
131 to intrusive_tests. This option adds test instrumentation in libdbus
132 and dbus-daemon, which reduces performance and is not secure.
133 For production builds of dbus in OS distributions, it must be false
134 (-Dintrusive_tests=false, which is the default)
135 During development, it should be set true (-Dintrusive_tests=true)
136 for full test coverage. (dbus#537, Simon McVittie)
137
138 • Similarly, when building with CMake, the DBUS_BUILD_TESTS option no
139 longer enables intrusive test instrumentation. A new option
140 -DDBUS_ENABLE_INTRUSIVE_TESTS=ON is equivalent to the Meson build
141 system's -Dintrusive_tests=true.
142
143 Bug fixes:
144
145 • If a DBusWatch callback fails because there is insufficient memory,
146 make sure to retry it within a finite time (dbus#536, Petr Malat)
147
148 • On macOS with launchd enabled, if the session bus launchd integration
149 is not correctly configured, don't treat that as a fatal error that
150 prevents connecting to the system bus (dbus#510, Mohamed Akram)
151
152 • If intrusive test instrumentation is enabled, older versions of dbus
153 would simulate an out-of-memory condition once per 2**32 allocations,
154 even if not specifically requested. This is no longer done.
155 (dbus#535, Simon McVittie)
156
157 • Fix compilation on non-Linux platforms with glibc, such as
158 Debian GNU/Hurd (dbus#539, Simon McVittie)
159
160 • Avoid test failures with non-trivial NSS modules, similar to dbus#256
161 (dbus#540, Simon McVittie)
162
163 • When built with CMake, make paths in DBus1Config relocatable
164 (dbus!499, Ralf Habacker)
165
166 dbus 1.15.90 (2024-12-06)
167 =========================
168
169 The “futuristic flyer” release.
170
171 This is a release-candidate for the new dbus 1.16.x stable branch.
172
173 Build-time configuration changes:
174
175 • The experimental Containers1 interface has been removed from this branch.
176 It is incomplete and not ready for production use, and has been
177 compile-time-disabled and impossible to enable without patching
178 since 1.13.20. To reduce confusion, delete the code completely.
179 It remains present on the git `main` branch for 1.17.x, and will
180 hopefully be reinstated during the 1.17.x cycle.
181 (dbus!488, dbus!490; Simon McVittie)
182
183 Bug fixes:
184
185 • Fix the Devhelp index for API documentation (dbus!486, Simon McVittie)
186
187 • Fix detection of socketpair() on Solaris 10 (dbus#531, Simon McVittie)
188
189 • Avoid undefined signed integer overflow when calculating hash table
190 indexes (dbus!487, Jami Kettunen)
191
192 dbus 1.15.12 (2024-10-29)
193 =========================
194
195 Enhancements:
196
197 • D-Bus Specification 0.43:
198 · Recommend loading system services from /etc/dbus-1/system-services
199 and /run/dbus-1/system-services (dbus!467, Luca Boccassi)
200 · Reorganise documentation of the message bus to make it easier to add
201 new interfaces (dbus!472, Simon McVittie)
202 · Document o.fd.DBus.Debug.Stats interface (dbus!472, Simon McVittie)
203 · Document o.fd.DBus.Verbose interface (dbus!472, Simon McVittie)
204 · Formatting improvements (dbus!471, dbus!472; Simon McVittie)
205 · Don't imply that all clients need to support obsolete message bus
206 implementations (dbus!471, Simon McVittie)
207
208 • API design advice:
209 · Document typical approaches to emulating nullable types in the D-Bus
210 type system (dbus!446, Zeeshan Ali Khan)
211
212 • On Unix, additionally load system services from:
213 · /etc/dbus-1/system-services, reserved for use by either the local system
214 administrator, or software such as asset managers and configuration
215 management frameworks acting on their behalf
216 · /run/dbus-1/system-services, for ephemeral services
217 (dbus!467, Luca Boccassi)
218
219 Bug fixes:
220
221 • Increase file descriptor soft limit to hard limit before testing file
222 descriptor passing, and correctly skip the test for flooding the bus
223 with fds when the limit is too low, fixing test failures on Solaris
224 (dbus#176, Alan Coopersmith)
225
226 • When building API documentation with Doxygen, always generate a working
227 link in the index HTML page
228 (dbus#519, dbus!470; Ralf Habacker, Simon McVittie)
229
230 • When building with Meson, add (more) test dependencies so that 'meson test'
231 does not always need to be preceded by 'meson compile'
232 (dbus!468, Simon McVittie)
233
234 • When installing with Meson, don't fail if we are installing as root but
235 the user/group that will own the setuid dbus-daemon-launch-helper do not
236 yet exist (dbus#492, Jordan Williams)
237
238 • When building with Meson on Solaris, fix detection and build of
239 Solaris audit API integration
240 (dbus!477, Alan Coopersmith)
241
242 • Fix service activation timeouts when built with embedded tests (test
243 instrumentation) and run on a platform with a large file descriptor limit
244 (dbus#527, Simon McVittie)
245
246 • Fix test failures on platforms where deleting the current working
247 directory is not allowed, such as Solaris
248 (dbus!480, Alan Coopersmith)
249
250 Internal changes:
251
252 • CI fixes (dbus!474, Simon McVittie)
253
254 dbus 1.15.10 (2024-09-25)
255 =========================
256
257 Build-time configuration changes:
258
259 • The Autotools build system has been removed. Its replacement is Meson.
260 (dbus#443, Ralf Habacker)
261
262 Enhancements:
263
264 • Use 64-bit timestamps internally.
265 This will allow 32-bit builds of libdbus to continue working after 2038
266 if there is OS-level support for 64-bit time_t, either opt-in
267 (as on 32-bit glibc systems) or by default. (dbus!444, Alexander Kanavin)
268
269 • When building with CMake, build more HTML documentation
270 (dbus#504, Ralf Habacker)
271
272 Bug fixes:
273
274 • Don't crash if configured to watch more than 128 directories with
275 inotify (dbus#481, hongjinghao)
276
277 • Never add (uid_t) -1, (gid_t) -1 or (pid_t) 0 to credentials
278 (dbus!464, Alyssa Ross)
279
280 • Fix a regression since 1.15.0 for "autolaunch:" on Windows
281 (dbus#503, Thomas Sondergaard)
282
283 • When building with Meson, don't use stdatomic.h if it exists but is
284 non-functional, for example under Visual Studio 2022
285 (dbus#494, Thomas Sondergaard)
286
287 • When building with Meson, add test dependencies so that 'meson test'
288 does not always need to be preceded by 'meson compile'
289 (dbus!465, Alyssa Ross)
290
291 • When building with Meson, really enable launchd if appropriate
292 (dbus!463, Alyssa Ross)
293
294 • In the test suite, use a more widely-implemented group name 'tty'
295 in preference to 'bin' (dbus#514, Alyssa Ross)
296
297 • Ensure that `dbus-test-tool spam` options cannot leave the payload
298 length uninitialized (dbus!469, Simon McVittie)
299
300 • Fix compiler warnings with gcc 14 (dbus!469, Simon McVittie)
301
302 Documentation:
303
304 • Clarify ownership transfer of pending call in
305 dbus_connection_send_with_reply() (dbus!455, Wiebe Cazemier)
306
307 • Explicitly document dbus-send exit status (dbus#452, Philip Withnall)
308
309 • Refer to d-spy in preference to unmaintaned D-Feet
310 (dbus!460, Ludovico de Nittis)
311
312 • Update URL to Bustle tool (dbus!460, Ludovico de Nittis)
313
314 Internal changes:
315
316 • Replace _dbus_string_append_int(), _dbus_string_append_uint() with
317 calls to _dbus_string_append_printf()
318 (dbus!445, Simon McVittie)
319
320 • Clean up unused macros in CMake build
321 (dbus!463, Alyssa Ross)
322
323 • Internal CI changes
324 (dbus#487, dbus#488, dbus#489, dbus#509;
325 Ralf Habacker, Simon McVittie)
326
327 dbus 1.15.8 (2023-08-21)
328 ========================
329
330 Build-time configuration changes:
331
332 • For this version of dbus, Meson is the recommended build system for all
333 Unix platforms. CMake continues to be recommended for Windows, but this
334 recommendation might change to Meson in a future release, so please
335 test the Meson build. See INSTALL for details.
336
337 • Autotools-generated files are no longer included in the tarball release.
338 The Autotools build system is likely to be removed in a future dbus
339 release, so Autotools users should migrate to Meson as soon as possible.
340 It is still possible to build using Autotools, by following the same
341 procedure as for a git clone (starting with the `./autogen.sh` script).
342
343 Enhancements:
344
345 • D-Bus Specification 0.42:
346 · GetConnectionCredentials can return ProcessFD
347 (dbus!420, dbus!398; Luca Boccassi)
348
349 • On Linux with sufficiently new glibc and kernel headers, report a pinned
350 process file descriptor (pidfd) as the ProcessFD member of the
351 GetConnectionCredentials() result
352 (dbus!420, dbus!398; Luca Boccassi)
353
354 • On Linux with systemd, start as the target user/group (retaining
355 CAP_AUDIT_WRITE to preserve the ability to write to the audit log),
356 instead of starting as root and dropping privileges
357 (dbus!399, Luca Boccassi)
358
359 • On 32-bit glibc systems, opt-in to 64-bit timestamps if possible.
360 This will allow 32-bit builds of libdbus to continue working after 2038.
361 (dbus#465, Simon McVittie)
362
363 • On 32-bit glibc systems when built with CMake, also opt-in to large
364 file sizes, offsets and inode numbers, as was done for Autotools
365 since 1.12.x and Meson since the Meson build was introduced
366 (dbus#465, fd.o #93545; Simon McVittie)
367
368 • Avoid known dbus-daemon options being interpreted as optional arguments
369 (dbus#467, Xin Shi)
370
371 • If libdbus is a Meson subproject in a larger project, announce it as an
372 implementation of the dbus-1 dependency (dbus!415, Barnabás Pőcze)
373
374 • When built with CMake, get the version number from Meson instead of
375 Autotools, in preparation for the Autotools build system being removed
376 (dbus!382, Ralf Habacker)
377
378 • When built with Meson, disable some unwanted warnings when either
379 assertions or checks is disabled (dbus!412, Simon McVittie)
380
381 • Use C11 <stdatomic.h> if possible (dbus!431, Simon McVittie)
382
383 • Expand coverage of SPDX/REUSE copyright/license information
384 (dbus!427, Simon McVittie)
385
386 • On Linux, let dbus-daemon start up successfully (with a warning) if
387 inotify initialization fails, even if DBUS_FATAL_WARNINGS=1 is present
388 in the environment (dbus#473, Simon McVittie)
389
390 • On Unix, provide a better error message when looking up a user by name
391 or user ID fails (dbus!442, Simon McVittie)
392
393 Bug fixes:
394
395 • Avoid a dbus-daemon crash if re-creating a connection's policy fails.
396 If it isn't possible to re-create its policy (for example if it belongs
397 to a user account that has been deleted or if the Name Service Switch is
398 broken, on a system not supporting SO_PEERGROUPS), we now log a warning,
399 continue to use its current policy, and continue to reload other
400 connections' policies. (dbus#343; Peter Benie, Simon McVittie)
401
402 • If getting the groups from a user ID fails, report the error correctly,
403 instead of logging "(null)" (dbus#343, Simon McVittie)
404
405 • Return the primary group ID in GetConnectionCredentials()' UnixGroupIDs
406 field for processes with a valid-but-empty supplementary group list
407 (dbus!422, cptpcrd)
408
409 • `sudo meson install` without a DESTDIR is now possible, although
410 strongly discouraged on production systems (dbus#436, Simon McVittie)
411
412 • Fix a Meson deprecation warning (dbus#439, Simon McVittie)
413
414 Tests and CI enhancements:
415
416 • Internal CI changes
417 (dbus#455, dbus!414, dbus#468, dbus#469, dbus!424, dbus!430, dbus#436,
418 dbus#470; Ralf Habacker, Simon McVittie)
419
420 dbus 1.15.6 (2023-06-06)
421 ========================
422
423 Denial-of-service fixes:
424
425 • Fix an assertion failure in dbus-daemon when a privileged Monitoring
426 connection (dbus-monitor, busctl monitor, gdbus monitor or similar)
427 is active, and a message from the bus driver cannot be delivered to a
428 client connection due to <deny> rules or outgoing message quota. This
429 is a denial of service if triggered maliciously by a local attacker.
430 (dbus#457; hongjinghao, Simon McVittie)
431
432 Enhancements:
433
434 • Special-case reading pseudo-files from Linux /proc to take into
435 account the filesystem's unusual semantics (dbus!401, Luca Boccassi)
436
437 Other fixes:
438
439 • Fix compilation on compilers not supporting __FUNCTION__
440 (dbus!404, Barnabás Pőcze)
441
442 • Fix some memory leaks on out-of-memory conditions
443 (dbus!403, Barnabás Pőcze)
444
445 • Documentation:
446 · Update the README to recommend building with Meson
447 (dbus!402, Ahmed Abdelfattah)
448 · Fix syntax of a code sample in dbus-api-design
449 (dbus!396; Yen-Chin, Lee)
450
451 • CMake build fixes:
452 · Detect presence of <sys/syscall.h> (dbus!400, Luca Boccassi)
453
454 Tests and CI enhancements:
455
456 • Fix CI pipelines after freedesktop/freedesktop#540
457 (dbus!405, dbus#456; Simon McVittie)
458
459 • Ensure the messagebus user is created if necessary
460 (dbus#445, Ralf Habacker)
461
462 dbus 1.15.4 (2023-02-08)
463 ========================
464
465 Dependencies:
466
467 • Building with CMake now requires CMake ≥ 3.9.
468
469 Build-time configuration changes:
470
471 • On Unix platforms, a path in the runtime state directory (often /run)
472 is now used for the well-known system bus socket by default. OS
473 distributors should check that the path used is equivalent to the
474 interoperable path /var/run/dbus/system_bus_socket, especially if
475 running on an OS where /var/run is not guaranteed to be a symbolic
476 link to /run.
477 (dbus#180; Issam E. Maghni, Simon McVittie)
478 · With Autotools, this is controlled by --runstatedir, which defaults
479 to ${localstatedir}/run but is often set to /run by OS distributors.
480 The path to the system bus socket can be overridden with the
481 --with-system-socket option if required.
482 · With CMake, this is controlled by the RUNSTATEDIR option, which has
483 behaviour similar to Autotools. There is no separate option for the
484 path to the system bus socket.
485 · With Meson, this is controlled by the runtime_dir option, which
486 defaults to /run if the installation prefix is set to /usr, or has
487 behaviour similar to Autotools otherwise. The path to the system bus
488 socket can be overridden with the system_socket option if required.
489
490 Denial of service fixes:
491
492 • Fix an incorrect assertion that could be used to crash dbus-daemon or
493 other users of DBusServer prior to authentication, if libdbus was compiled
494 with assertions enabled.
495 We recommend that production builds of dbus, for example in OS distributions,
496 should be compiled with checks but without assertions.
497 (dbus#421, Ralf Habacker; thanks to Evgeny Vereshchagin)
498
499 Enhancements:
500
501 • D-Bus Specification 0.41:
502 · Clarify handling of /run vs. /var/run on Unix systems
503 (dbus#180, Simon McVittie)
504
505 • Add dbus_connection_set_builtin_filters_enabled(), intended to be called
506 by tools that use BecomeMonitor() such as dbus-monitor
507 (dbus#301, Kai A. Hiller)
508
509 • When using the Meson build system, dbus can now be used as a subproject.
510 To avoid colliding with a separate system copy of dbus, building it as a
511 static library with tests, tools and the message bus disabled is
512 strongly recommended. See test/use-as-subproject for sample code.
513 (dbus!368, dbus!388; Daniel Wagner)
514
515 Other fixes:
516
517 • When connected to a dbus-broker, stop dbus-monitor from incorrectly
518 replying to Peer method calls that were sent to the dbus-broker with
519 a NULL destination (dbus#301, Kai A. Hiller)
520
521 • Fix out-of-bounds varargs read in the dbus-daemon's config-parser.
522 This is not attacker-triggerable and appears to be harmless in practice,
523 but is technically undefined behaviour and is detected as such by
524 AddressSanitizer. (dbus!357, Evgeny Vereshchagin)
525
526 • Avoid a data race in multi-threaded use of DBusCounter
527 (dbus#426, Ralf Habacker)
528
529 • Fix a crash with some glibc versions when non-auditable SELinux events
530 are logged (dbus!386, Jeremi Piotrowski)
531
532 • If dbus_message_demarshal() runs out of memory while validating a message,
533 report it as NoMemory rather than InvalidArgs (dbus#420, Simon McVittie)
534
535 • Use C11 _Alignof if available, for better standards-compliance
536 (dbus!389, Khem Raj)
537
538 • Stop including an outdated copy of pkg.m4 in the git tree
539 (dbus!365, Simon McVittie)
540
541 • Meson build fixes:
542 · Use -fvisibility=hidden on Unix if supported, in particular on Linux
543 (dbus!383, dbus#437; Simon McVittie)
544 · Fix build on macOS, and any other platform that has
545 CLOCK_MONOTONIC but not pthread_condattr_setclock()
546 (dbus#419, Jordan Williams)
547
548 • Documentation:
549 · Consistently use Gitlab bug reporting URL (dbus!372, Marco Trevisan)
550
551 • Licensing:
552 · Use MIT license for some test files that did not previous specify a
553 license, with permission from their authors (dbus!359, Simon McVittie)
554 · Add more SPDX/REUSE license markers
555 (dbus!311, dbus!369, dbus!370, dbus!371, dbus!375, dbus!376;
556 Ralf Habacker, Simon McVittie)
557 · Correct syntax of some SPDX license markers (dbus!360, Ralf Habacker)
558
559 • Tests fixes:
560 · Fix an assertion failure in test-autolaunch-win
561 (dbus#422, Ralf Habacker)
562 · Expand test coverage under CMake (dbus!322, Ralf Habacker)
563 · Fix the test-apparmor-activation test after dbus#416
564 (dbus!380, Dave Jones)
565
566 Internal changes:
567
568 • Add static assertions for some things we assume about pointers
569 (dbus!345, Simon McVittie)
570
571 • Refactoring (dbus!356, dbus#430, dbus#431; Simon McVittie, Xin Shi)
572
573 • Fix CI builds with recent git versions (dbus#447, Simon McVittie)
574
575 • Build dbus with clang during CI (dbus!358, Evgeny Vereshchagin)
576
577 dbus 1.15.2 (2022-10-05)
578 ========================
579
580 This development release incorporates the same denial-of-service fixes and
581 security hardening as dbus 1.14.4.
582
583 Behaviour changes:
584
585 • On Linux, dbus-daemon and other uses of DBusServer now create a
586 path-based Unix socket, unix:path=..., when asked to listen on a
587 unix:tmpdir=... address. This makes unix:tmpdir=... equivalent to
588 unix:dir=... on all platforms.
589 Previous versions would have created an abstract socket, unix:abstract=...,
590 in this situation.
591 This change primarily affects the well-known session bus when run via
592 dbus-launch(1) or dbus-run-session(1). The user bus, enabled by configuring
593 dbus with --enable-user-session and running it on a systemd system,
594 already used path-based Unix sockets and is unaffected by this change.
595 This behaviour change prevents a sandbox escape via the session bus socket
596 in sandboxing frameworks that can share the network namespace with the host
597 system, such as Flatpak.
598 This change might cause a regression in situations where the abstract socket
599 is intentionally shared between the host system and a chroot or container,
600 such as some use-cases of schroot(1). That regression can be resolved by
601 using a bind-mount to share either the D-Bus socket, or the whole /tmp
602 directory, with the chroot or container.
603 (dbus#416, Simon McVittie)
604
605 Denial of service fixes:
606
607 Evgeny Vereshchagin discovered several ways in which an authenticated
608 local attacker could cause a crash (denial of service) in
609 dbus-daemon --system or a custom DBusServer. In uncommon configurations
610 these could potentially be carried out by an authenticated remote attacker.
611
612 • An invalid array of fixed-length elements where the length of the array
613 is not a multiple of the length of the element would cause an assertion
614 failure in debug builds or an out-of-bounds read in production builds.
615 This was a regression in version 1.3.0.
616 (dbus#413, CVE-2022-42011; Simon McVittie)
617
618 • A syntactically invalid type signature with incorrectly nested parentheses
619 and curly brackets would cause an assertion failure in debug builds.
620 Similar messages could potentially result in a crash or incorrect message
621 processing in a production build, although we are not aware of a practical
622 example. (dbus#418, CVE-2022-42010; Simon McVittie)
623
624 • A message in non-native endianness with out-of-band Unix file descriptors
625 would cause a use-after-free and possible memory corruption in production
626 builds, or an assertion failure in debug builds. This was a regression in
627 version 1.3.0. (dbus#417, CVE-2022-42012; Simon McVittie)
628
629 Enhancements:
630
631 • D-Bus Specification 0.40 (dbus#416, Simon McVittie)
632 · Clarify that unix:tmpdir is not required to use abstract sockets,
633 even where supported
634 · Mention implications of abstract sockets for Linux namespacing
635
636 dbus 1.15.0 (2022-09-22)
637 ========================
638
639 Dependencies:
640
641 • On platforms where a pointer is larger than 64 bits, dbus requires at
642 least a C11 compiler.
643 On other platforms, dbus now requires either a C99 compiler such as
644 gcc or clang, or Microsoft Visual Studio 2015 or later. Some workarounds
645 for pre-C99 environments are currently still present, but we plan to
646 remove them during this development cycle.
647
648 • Building with CMake now requires CMake ≥ 3.4.
649
650 • Building with Meson requires Meson ≥ 0.56 and Python ≥ 3.5.
651
652 Feature removal:
653
654 • Remove support for the obsolete pam_console and pam_foreground modules
655 (the Autotools --with-console-auth-dir= and CMake -DDBUS_CONSOLE_AUTH_DIR=
656 options, which have been deprecated since dbus 1.11.18).
657 (dbus#181, fd.o#101629)
658
659 Build-time configuration changes:
660
661 • Add a Meson build system. This is currently considered experimental,
662 but the intention is for it to replace Autotools and/or CMake in future
663 releases, preferably both. Please test!
664 (dbus!303, dbus!325; Félix Piédallu, Marc-André Lureau, Simon McVittie)
665 · This requires Meson 0.56 or newer, and Python 3.5 or newer.
666 · Expat can be built as a subproject using Meson's "wrap" mechanism,
667 if desired. This should make it considerably easier to build dbus
668 for Windows or other platforms without a library packaging system.
669 · GLib can also be built as a subproject using Meson's "wrap" mechanism,
670 if desired. This should make it considerably easier to build full
671 test coverage on Windows or other platforms without a library
672 packaging system.
673
674 • Please note that not all Meson build options correspond 1:1 to how
675 the closest equivalents in Autotools or CMake behave, and the Meson
676 build options are subject to change.
677 Distributors and developers evaluating the Meson build should check
678 that they are configuring dbus the way they intend to.
679
680 Enhancements:
681
682 • D-Bus Specification 0.39:
683 · Document how to represent internationalized domain names in D-Bus
684 names (dbus!324, Simon McVittie)
685 · Improve documentation of AF_UNIX sockets (Marc-André Lureau)
686
687 • On Unix, speed up closing file descriptors for subprocesses by using
688 closefrom() or close_range() where available
689 (dbus#278; rim, Simon McVittie)
690
691 • On Windows, dbus can now use AF_UNIX sockets, not just TCP.
692 This requires Windows 10 build 17063 or later at runtime,
693 and either Windows 10 SDK 17063 or mingw-w64 version 9.0.0 or later
694 at compile-time. (dbus!249, Marc-André Lureau)
695
696 • Teach dbus-send to handle variants in containers: arrays of variants,
697 variant values in dictionaries, and nested variants
698 (dbus!206, Frederik Van Bogaert)
699
700 • Detect programming errors with Windows mutexes if assertions are
701 enabled, similar to what we already did for pthreads mutexes
702 (dbus#369, Ralf Habacker)
703
704 • Move license text into LICENSES, and start to use SPDX markers
705 (Simon McVittie, Ralf Habacker)
706
707 Fixes:
708
709 • Portability to CPU architectures with larger-than-64-bit pointers
710 (dbus!335, dbus!318; Alex Richardson)
711
712 • Fix build failure on FreeBSD (dbus!277, Alex Richardson)
713
714 • Fix build failure on macOS with launchd enabled
715 (dbus!287, Dawid Wróbel)
716
717 • Preserve errno on failure to open /proc/self/oom_score_adj
718 (dbus!285, Gentoo#834725; Mike Gilbert)
719
720 • Improve dbus-launch --autolaunch so it can pick up an existing bus from
721 Linux XDG_RUNTIME_DIR or macOS launchd, even if X11 autolaunching was
722 disabled (dbus#385, dbus#392; Simon McVittie, Alex Richardson)
723
724 • Correctly escape AF_UNIX socket paths when converting them to D-Bus
725 address strings (dbus#405, Marc-André Lureau)
726
727 • On Linux, don't log warnings if oom_score_adj is read-only but does not
728 need to be changed (dbus!291, Simon McVittie)
729
730 • Slightly improve error-handling for inotify
731 (dbus!235, Simon McVittie)
732
733 • Don't crash if dbus-daemon is asked to watch more than 128 directories
734 for changes (dbus!302, Jan Tojnar)
735
736 • Silence various compiler warnings
737 (dbus!275, dbus!289, dbus!305, dbus!307, dbus!312, dbus!315;
738 Ralf Habacker, Simon McVittie, Alex Richardson, Marc-André Lureau)
739
740 • On Windows, use safer locking patterns for the system-global mutex used
741 to implement autolaunching (dbus#368, dbus#370; Ralf Habacker)
742
743 • Index dbus-arch-deps.h for API documentation when building out-of-tree
744 (dbus!312, Marc-André Lureau)
745
746 • Silence xmlto warnings when building man pages
747 (dbus!312, Marc-André Lureau)
748
749 • Fix build failure when checks are disabled but assertions are enabled
750 (dbus#412, Johannes Kauffmann)
751
752 • Use C99 flexible arrays in the memory pool implementation for better
753 support for modern compilers
754 (dbus!343, dbus!344; Alex Richardson, Simon McVittie)
755
756 • Autotools build system fixes:
757 · Don't treat --with-x or --with-x=yes as a request to disable X11,
758 fixing a regression in 1.13.20. Instead, require X11 libraries and
759 fail if they cannot be detected. (dbus!263, Lars Wendler)
760 · When a CMake project uses an Autotools-built libdbus in a
761 non-standard prefix, find dbus-arch-deps.h successfully
762 (dbus#314, Simon McVittie)
763 · Don't include generated XML catalog in source releases
764 (dbus!317, Jan Tojnar)
765 · Improve robustness of detecting gcc __sync atomic builtins
766 (dbus!320, Alex Richardson)
767
768 • CMake build system fixes:
769 · Detect endianness correctly, fixing interoperability with other D-Bus
770 implementations on big-endian systems (dbus#375, Ralf Habacker)
771 · Fix a race condition generating man pages and HTML documentation
772 (dbus#381, Ralf Habacker)
773 · When building for Unix, install session and system bus setup
774 in the intended locations
775 (dbus!267, dbus!297; Ralf Habacker, Alex Richardson)
776 · Detect setresuid() and getresuid() (dbus!319, Alex Richardson)
777 · Detect backtrace() on FreeBSD (dbus!281, Alex Richardson)
778 · Don't include headers from parent directory (dbus!282, Alex Richardson)
779 · Fix -Wunused-command-line-argument on FreeBSD
780 (dbus!278, Alex Richardson)
781 · Only add warning flags if the compiler supports them
782 (dbus!276, Alex Richardson)
783 · Distinguish between host and target TMPDIR when cross-compiling
784 (dbus!279, Alex Richardson)
785 · Improve compiler warning detection (dbus#387, Ralf Habacker)
786 · Allow TEST_SOCKET_DIR to be overridden (dbus!295, Ralf Habacker)
787 · Fix detection of atomic operations (dbus!306, Alex Richardson)
788 · Use DWARF 2 instead of STABS for debug symbols on Windows, for
789 compatibility with newer gcc versions (dbus!323, Marc-André Lureau)
790 · Fix use of paths relative to the dbus project directory when dbus is
791 vendored into a larger CMake project (dbus!332, Jordan Williams)
792
793 Tests and CI enhancements:
794
795 • Add an automated test for Windows autolaunching
796 (dbus#235, Ralf Habacker)
797
798 • Avoid compiler warnings in test code
799 (dbus#383, dbus!274, dbus!275; Simon McVittie, Ralf Habacker)
800
801 • Avoid LeakSanitizer warnings in test code
802 (dbus!326, Simon McVittie)
803
804 • Speed up a particularly slow unit test by a factor of 30
805 (dbus!328, Simon McVittie)
806
807 • On Unix, skip tests that switch uid if run in a container that is
808 unable to do so, instead of failing (dbus#407, Simon McVittie)
809
810 • On Unix, consistently create test sockets in DBUS_TEST_SOCKET_DIR and
811 not the build directory, allowing the build directory to be mounted with
812 a non-POSIX filesystem (dbus!334, Alex Richardson)
813
814 • Gitlab-CI improvements
815 (dbus#383, dbus#388, dbus!262, dbus!288, dbus!292, dbus!296, dbus!299,
816 dbus!301;
817 Ralf Habacker, Simon McVittie, Alex Richardson)
818
819 • Added FreeBSD Gitlab-CI build jobs
820 (dbus!280, dbus!347; Alex Richardson)
821
822 • Use the latest MSYS2 packages for CI
823 (Ralf Habacker, Simon McVittie)
824
825 dbus 1.14.0 (2022-02-28)
826 ========================
827
828 1.14.x is a new stable branch, superseding 1.12.x.
829
830 Summary of major changes between 1.12.x and 1.14.0
831 --------------------------------------------------
832
833 Dependencies:
834
835 • dbus now requires at least a basic level of support for C99 variadic
836 macros, as implemented in gcc >= 3, all versions of Clang, and
837 MSVC >= 2005. In practice this requirement has existed since version
838 1.9.2, but it is now official.
839
840 • dbus now requires a C99-compatible va_copy() macro (or a __va_copy()
841 macro with the same behaviour), except when building for Windows using
842 MSVC and CMake.
843
844 • On Unix platforms, if getpwnam_r() and getgrnam_r() are implemented,
845 they must be POSIX-conformant. The non-POSIX signature seen in ancient
846 Solaris versions will no longer work.
847
848 • All Windows builds now require Windows Vista or later.
849 (Note that we do not recommend or support use of dbus on operating
850 systems outside their vendor's security support lifetime, such as Vista.)
851
852 • GLib >= 2.38 is required if full test coverage is enabled
853 (reduced from 2.40 in dbus 1.12.x.)
854
855 • Building using CMake now requires CMake 3.4.
856
857 • Building documentation using CMake now requires xsltproc, Docbook DTDs
858 (for example docbook-xml on Debian derivatives), and Docbook XSLT
859 stylesheets (for example docbook-xsl on Debian derivatives). Using
860 KDE's meinproc4 documentation processor is no longer supported.
861
862 Build-time configuration changes:
863
864 • Move CMake build system to top level, matching normal practice for
865 CMake projects
866
867 Deprecations:
868
869 • Third-party software should install default dbus policies for the system
870 bus into ${datadir}/dbus-1/system.d (this has been supported since dbus
871 1.10, released in August 2015). Installing default dbus policies in
872 ${sysconfdir}/dbus-1/system.d is now considered to be deprecated. Policy
873 files in ${sysconfdir}/dbus-1/system.d continue to be read, but this
874 directory should only be used by system administrators wishing to
875 override the default policies.
876
877 The ${datadir} applicable to dbus is usually /usr/share and the
878 ${sysconfdir} is usually /etc.
879
880 • A similar pattern applies to the session bus policies in session.d.
881
882 • The dbus-send(1) man page now documents --bus and --peer instead of
883 the old --address synonym for --peer, which has been deprecated since
884 the introduction of --bus and --peer in 1.7.6
885
886 • The dbus-daemon man page now has scarier warnings about
887 <allow_anonymous/> and non-local TCP, which are insecure and should
888 not be used, particularly for the standard system and session buses
889
890 • DBusServer (and hence the dbus-daemon) no longer accepts usernames
891 (login names) for the recommended EXTERNAL authentication mechanism,
892 only numeric user IDs or the empty string. See 1.13.0 release notes
893 for full details.
894
895 New features:
896
897 • On Linux 4.13 or later when built against a suitable glibc version,
898 GetConnectionCredentials() now includes UnixGroupIDs, the effective
899 group IDs of the initiator of the connection, taken from
900 SO_PEERGROUPS.
901
902 • On Linux 4.13 or later, <policy group="…"> now uses the SO_PEERGROUPS
903 credentials-passing socket option to get the effective group IDs
904 of the initiator of the connection. See 1.13.4 release notes for details.
905
906 • Add a --sender option to dbus-send, which requests a name and holds it
907 until the signal has been sent
908
909 • dbus-daemon <allow> and <deny> rules can now specify a
910 send_destination_prefix attribute, which is like a combination of
911 send_destination and the arg0namespace keyword in match rules.
912 See 1.13.12 release notes for more details
913
914 • The dbus-daemon now filters the messages that it relays, removing
915 header fields that it does not understand. Clients must not rely on
916 this behaviour unless they have confirmed that they are connected to
917 a suitable message bus implementation, for example by querying its
918 Features property.
919
920 • The dbus-daemon now emits a signal, ActivatableServicesChanged, when
921 the list of activatable services may have changed. Support for this
922 signal can be discovered by querying the Features property.
923
924 • It is now possible to disable traditional (non-systemd) service
925 activation at build-time (Autotools: --disable-traditional-activation,
926 CMake: -DENABLE_TRADITIONAL_ACTIVATION=OFF). See 1.13.10 release notes
927 for details.
928
929 • The API reference manual can be built as a Qt compiled help file if
930 qhelpgenerator(-qt5) is available. See 1.13.16 release notes for details.
931
932 Miscellaneous behaviour changes:
933
934 • When using the "user bus" (--enable-user-session), put the dbus-daemon
935 in the session slice
936
937 • Several environment variables set by systemd are no longer passed
938 on to activated services
939
940 • If the dbus-daemon is compiled for Linux with systemd support, it
941 now informs systemd that it is ready for use via the sd_notify()
942 mechanism
943
944 • Tarball releases no longer contain pre-2007 changelogs and are now
945 compressed with xz, making them around 35% smaller.
946
947 Changes since 1.13.22
948 ---------------------
949
950 • On Windows, consistently use msvcrt.dll-style printf formats, fixing
951 builds with mingw-w64 8.0.0 (dbus#380, Simon McVittie)
952
953 • Fix some broken links in the API design document
954 (dbus!257, Michael Nosthoff)
955
956 • CI updates
957 · Enable -Werror for the CMake builds
958 · Use https to download MSYS packages
959 · Use Debian 11 for most builds
960 · Stop testing on Debian 9, which is EOL
961 · Stop testing on Ubuntu 16.04, which is EOL
962 · Remove workarounds for missing/outdated packages in Debian 8, Debian 9
963 and Ubuntu 16.04
964 (dbus#380, dbus!260; Simon McVittie)
965
966 dbus 1.13.22 (2022-02-23)
967 =========================
968
969 This is a release candidate for a new dbus 1.14.x stable branch.
970
971 Enhancements:
972
973 • D-Bus Specification 0.38:
974 · Add ActivatableServicesChanged signal and feature flag
975 (dbus#376, Ralf Habacker)
976 · Document * as optionally-escaped in D-Bus addresses, matching
977 the implementation (dbus!248, Kir Kolyshkin)
978
979 • Emit the new ActivatableServicesChanged signal when configuration
980 and/or activatable services are reloaded (dbus#376, Ralf Habacker)
981
982 • Add an XML catalog file for the DTDs we install
983 (dbus!202, Jan Tojnar)
984
985 Bug fixes:
986
987 • On Linux, when using traditional (non-systemd) service activation,
988 don't log warnings about failing to reset OOM score adjustment if the
989 process is already more susceptible to the OOM killer, as user processes
990 usually are with systemd ≥ 250. (dbus#374, Simon McVittie)
991
992 • On Linux, when using traditional (non-systemd) system bus activation,
993 reset the OOM score adjustment to 0 as intended.
994 If the system dbus-daemon is protected from the OOM killer, this
995 avoids that protection unintentionally being inherited by every
996 system service. (dbus#378, Simon McVittie)
997
998 • Fix a code path that could result in a crash on out-of-memory
999 (dbus#246, Marc-André Lureau)
1000
1001 • Fix compilation if embedded tests are enabled but verbose mode and
1002 stats are both disabled (Marc-André Lureau)
1003
1004 • CMake: Improve support for Windows with MSVC and add CI coverage
1005 (dbus!218, Marc-André Lureau)
1006
1007 • CMake: Improve Docbook documentation-generation
1008 (dbus#377, Ralf Habacker)
1009
1010 • On Linux, fix a race condition in the integration test for transient
1011 services (Debian#1005889, dbus!256; Simon McVittie)
1012
1013 dbus 1.13.20 (2021-12-17)
1014 =========================
1015
1016 The “not how anyone wanted to learn the Greek alphabet” release.
1017
1018 Dependencies:
1019
1020 • Building using CMake now requires CMake 3.4.
1021
1022 Enhancements:
1023
1024 • D-Bus Specification 0.37:
1025 · Update recommendations for DBUS_COOKIE_SHA1 timeouts
1026 (dbus!171, Simon McVittie)
1027 · Clarify padding requirements for arrays and variants
1028 (dbus!203, Zeeshan Ali)
1029 · Describe where the interoperable machine ID comes from
1030 (dbus!198, Thomas Kluyver)
1031 · Clarify use of dictionary (array of dict-entry) types
1032 (dbus#347, Ralf Habacker)
1033
1034 • When using the "user bus" (--enable-user-session), put the dbus-daemon
1035 in the session slice (dbus!219, David Redondo)
1036
1037 Feature removal:
1038
1039 • Disable the experimental Containers1 interface that was added in 1.13.0.
1040 It is incomplete and not ready for production use, so we're disabling it
1041 in preparation for a new 1.14.x stable branch; the code remains present
1042 and will be re-enabled later, but there is no longer a build-time
1043 configuration option to enable it. (dbus!236, Simon McVittie)
1044
1045 Bug fixes:
1046
1047 • Avoid malloc() after fork on non-GNU libc (dbus!181, Jean-Louis Fuchs)
1048
1049 • Don't return successfully from RemoveMatch if the match rule didn't
1050 exist (dbus#351, Simon McVittie)
1051
1052 • On Windows, fix a race condition where dbus-run-session could start the
1053 wrapped application before the dbus-daemon was ready
1054 (dbus#297, Ralf Habacker)
1055
1056 • Fix build with clang 13 by using Standard C offsetof where available
1057 (dbus!237, Simon McVittie)
1058
1059 • Fix build of tests on FreeBSD (dbus!167, Simon McVittie)
1060
1061 • Various CMake build improvements
1062 (dbus#310, dbus!213, dbus#319, dbus!217, dbus#346, dbus#356;
1063 Ralf Habacker)
1064
1065 • Set IMPORTED_IMPLIB property in CMake metadata installed via Autotools
1066 with mingw toolchain
1067 (dbus!172, Julien Schueller)
1068
1069 • Make documentation build more reproducible
1070 (dbus!189, dbus!238; Arnout Engelen, Simon McVittie)
1071
1072 • On Unix, make X11 autolaunch cope with slashes in DISPLAY
1073 (dbus#8, dbus#311; William Earley)
1074
1075 • Don't try to raise RLIMIT_NOFILE beyond OPEN_MAX on macOS
1076 (dbus#309, William Earley)
1077
1078 • Improve SELinux audit messages (dbus!173, Chris PeBenito)
1079
1080 • Validate various strings in dbus-send to avoid client-side assertion
1081 failures on invalid input (dbus#338, Simon McVittie)
1082
1083 • Fix a memory leak in a unit test (dbus!208, David King)
1084
1085 • In Autotools builds, use pkg-config in preference to AC_PATH_XTRA
1086 (dbus!212, Scott Hamilton)
1087
1088 • On Windows, prevent (theoretical?) stack buffer overflow with very
1089 long paths (dbus!221, Ralf Habacker)
1090
1091 • Fix build with newer mingw compilers (dbus#355, Ralf Habacker)
1092
1093 • Various Windows error-handling fixes
1094 (dbus!229, dbus#357, dbus#279, dbus#360, dbus#365;
1095 Ralf Habacker, Simon McVittie)
1096
1097 • Clearer diagnostics when tests are skipped (dbus#363, Simon McVittie)
1098
1099 • CI improvements
1100 (dbus#318, dbus!197, dbus!187, dbus!196, dbus!201, dbus#359;
1101 Simon McVittie, Ralf Habacker, Arnout Engelen, Marc-André Lureau)
1102
1103 • Typo fixes, etc.
1104 (dbus!183, dbus!182; Chigozirim Chukwu, Samy Mahmoudi)
1105
1106 dbus 1.13.18 (2020-07-02)
1107 =========================
1108
1109 The “carnivorous border” release.
1110
1111 Maybe security fixes:
1112
1113 • On Unix, avoid a use-after-free if two usernames have the same
1114 numeric uid. In older versions this could lead to a crash (denial of
1115 service) or other undefined behaviour, possibly including incorrect
1116 authorization decisions if <policy group=...> is used.
1117 Like Unix filesystems, D-Bus' model of identity cannot distinguish
1118 between users of different names with the same numeric uid, so this
1119 configuration is not advisable on systems where D-Bus will be used.
1120 Thanks to Daniel Onaca.
1121 (dbus#305, dbus!166, CVE-2020-35512; Simon McVittie)
1122
1123 Other fixes:
1124
1125 • On Solaris and its derivatives, if a cmsg header is truncated, ensure
1126 that we do not overrun the buffer used for fd-passing, even if the
1127 kernel tells us to.
1128 (dbus#304, dbus!165; Andy Fiddaman)
1129
1130 • When built with CMake, use GNUInstallDirs' special-cases for prefixes
1131 /, /usr and /opt/*
1132 (dbus!155, Ralf Habacker)
1133
1134 • When built with CMake on Linux, allow systemd-specific features to be
1135 enabled, for feature parity with Autotools
1136 (dbus!155, Ralf Habacker)
1137
1138 • When built with CMake, install the same example files as with Autotools
1139 (dbus!155, Ralf Habacker)
1140
1141 • Correct the doc-comment for DBUS_ERROR_SPAWN_NO_MEMORY
1142 (dbus!163, Marc-André Lureau)
1143
1144 dbus 1.13.16 (2020-06-02)
1145 =========================
1146
1147 The “ominous mushroom hat” release.
1148
1149 Denial of service fixes:
1150
1151 • CVE-2020-12049: If a message contains more file descriptors than can
1152 be sent, close those that did get through before reporting error.
1153 Previously, a local attacker could cause the system dbus-daemon (or
1154 another system service with its own DBusServer) to run out of file
1155 descriptors, by repeatedly connecting to the server and sending fds that
1156 would get leaked.
1157 Thanks to Kevin Backhouse of GitHub Security Lab.
1158 (dbus#294, GHSL-2020-057; Simon McVittie)
1159
1160 Enhancements:
1161
1162 • The API reference manual can be built as a Qt compiled help file if
1163 qhelpgenerator(-qt5) is available. This is controlled by
1164 --enable-qt-help and --with-qchdir in the Autotools build, or
1165 -DENABLE_QT_HELP and -DINSTALL_QCH_DIR in CMake.
1166 (dbus!150, Ralf Habacker)
1167
1168 Fixes:
1169
1170 • When built for Windows, return all autolaunch error information in
1171 the DBusError rather than printing some of it to stderr
1172 (dbus#191, dbus!131; Ralf Habacker)
1173
1174 • When built for Windows, don't truncate long log messages
1175 (dbus!134, Ralf Habacker)
1176
1177 • When built using CMake for a Unix platform, dbus-cleanup-sockets and
1178 dbus-uuidgen are now included (dbus!154, Ralf Habacker)
1179
1180 • When built for Windows with verbose mode enabled, don't print debugging
1181 messages related to poll() emulation into a fixed-size buffer that
1182 could overflow (dbus!125, Ralf Habacker)
1183
1184 • Adjust .desktop file parser to avoid a Coverity false positive
1185 (dbus!146, Coverity CID 354884; Ralf Habacker)
1186
1187 • Print shell-test diagnostics to stderr, avoiding warnings or errors
1188 from strict TAP parsers (dbus!157, Félix Piédallu)
1189
1190 Tests and CI enhancements:
1191
1192 • When the CI cross-builds Windows binaries on Linux, run unit tests
1193 using Wine (dbus#296, dbus!158; Ralf Habacker)
1194
1195 • Really build x86_64 Windows binaries in Gitlab-CI, instead of building
1196 i686 binaries a second time (Ralf Habacker)
1197
1198 • When tests will be run using Wine, use STABS debug symbol format so
1199 that Wine can display backtraces (dbus#133, dbus!104; Ralf Habacker)
1200
1201 dbus 1.13.14 (2020-04-21)
1202 =========================
1203
1204 The “mystery allium” release.
1205
1206 Dependencies:
1207
1208 • On Unix platforms, if getpwnam_r() and getgrnam_r() are implemented,
1209 they must be POSIX-conformant. The non-POSIX signature seen in ancient
1210 Solaris versions will no longer work. (dbus!11, Simon McVittie)
1211
1212 Enhancements:
1213
1214 • D-Bus Specification 0.36:
1215 · Fix a typo in an annotated hexdump of part of a message
1216 (dbus!152, Zygmunt Krynicki)
1217
1218 • On Linux, use getrandom(2) in preference to /dev/urandom
1219 (dbus!147, Natanael Copa)
1220
1221 • Add a --sender option to dbus-send, which requests a name and holds it
1222 until the signal has been sent. (dbus!116, Christopher Morin)
1223
1224 Fixes:
1225
1226 • Fix a crash when the dbus-daemon is terminated while one or more
1227 monitors are active (dbus#291, dbus!140; Simon McVittie)
1228
1229 • Fix several test failures if the build-time tests were run as uid 0.
1230 Note that running the tests with elevated privileges is likely to be
1231 insecure, and should only be attempted in an expendable container or
1232 virtual machine. (dbus!117, Simon McVittie)
1233
1234 • Fix an assertion failure if a client encounters an out-of-memory
1235 condition while sending its response to the "OK" authentication
1236 message, and processing of the "OK" message is subsequently retried
1237 when more memory is available (dbus!119, Simon McVittie)
1238
1239 • Don't leak struct addrinfo if we run out of memory during a TCP
1240 connect()
1241 (dbus!143, dbus!144, Coverity CID 354880; Ralf Habacker, Simon McVittie)
1242
1243 • On Linux with SELinux, don't assume that the system policy has the
1244 "dbus" security class or the associated AV
1245 (dbus#198, dbus!128; Laurent Bigonville)
1246
1247 • Handle dbus_connection_set_change_sigpipe() in a thread-safe way
1248 (dbus!132; Simon McVittie, Ralf Habacker)
1249
1250 • On Unix, use POSIX <poll.h> in preference to <sys/poll.h>
1251 (dbus!148, Natanael Copa)
1252
1253 • When building with CMake, cope with libX11 in a non-standard location
1254 (dbus!129, Tuomo Rinne)
1255
1256 • On Windows with verbose mode enabled and outputting to the debug port,
1257 use a dynamically-allocated buffer to avoid potential stack buffer
1258 overflows in long messages (dbus#45, dbus!133; Ralf Habacker)
1259
1260 • The dbus-send(1) man page now documents --bus and --peer instead of
1261 the old --address synonym for --peer, which has been deprecated since
1262 the introduction of --bus and --peer in 1.7.6
1263 (fd.o #48816, dbus!115; Chris Morin)
1264
1265 • Fix a wrong environment variable name in dbus-daemon(1)
1266 (dbus#275, dbus!122; Mubin, Philip Withnall)
1267
1268 • Fix formatting of dbus_message_append_args example
1269 (dbus!126, Felipe Franciosi)
1270
1271 Internal changes:
1272
1273 • Move more test-only code from dbus/ to tests/
1274 (dbus!120, dbus!121, dbus!153; Simon McVittie)
1275
1276 • Improve diagnostics if memory or fd leaks are detected
1277 (dbus!118, dbus!120; Simon McVittie)
1278
1279 • Move from Debian 9 to Debian 10 for most continuous integration jobs
1280 (dbus!151, Simon McVittie)
1281
1282 • On Windows, improve embedded version information
1283 (dbus!136, dbus!138, dbus!139; Ralf Habacker)
1284
1285 • Indentation fixes (dbus!149, Taras Zaporozhets)
1286
1287 dbus 1.13.12 (2019-06-11)
1288 =========================
1289
1290 The “patio squirrel” release.
1291
1292 Security fixes:
1293
1294 • CVE-2019-12749: Do not attempt to carry out DBUS_COOKIE_SHA1
1295 authentication for identities that differ from the user running the
1296 DBusServer. Previously, a local attacker could manipulate symbolic
1297 links in their own home directory to bypass authentication and connect
1298 to a DBusServer with elevated privileges. The standard system and
1299 session dbus-daemons in their default configuration were immune to this
1300 attack because they did not allow DBUS_COOKIE_SHA1, but third-party
1301 users of DBusServer such as Upstart could be vulnerable.
1302 Thanks to Joe Vennix of Apple Information Security.
1303 (dbus#269, Simon McVittie)
1304
1305 Enhancements:
1306
1307 • dbus-daemon <allow> and <deny> rules can now specify a
1308 send_destination_prefix attribute, which is like a combination of
1309 send_destination and the arg0namespace keyword in match rules: a rule
1310 with send_destination_prefix="com.example.Foo" matches messages sent to
1311 any destination that is in the queue to own well-known names like
1312 com.example.Foo or com.example.Foo.A.B (but not com.example.Foobar).
1313 (dbus!85, Adrian Szyndela)
1314
1315 dbus 1.13.10 (2019-05-13)
1316 =========================
1317
1318 The “engineering brick” release.
1319
1320 Dependencies:
1321
1322 • GLib >= 2.38 is required if full test coverage is enabled
1323 (reduced from 2.40 in dbus 1.12.x.)
1324
1325 Deprecations:
1326
1327 • Third-party software should install default dbus policies for the system
1328 bus into ${datadir}/dbus-1/system.d (this has been supported since dbus
1329 1.10, released in August 2015). Installing default dbus policies in
1330 ${sysconfdir}/dbus-1/system.d is now considered to be deprecated. Policy
1331 files in ${sysconfdir}/dbus-1/system.d continue to be read, but this
1332 directory should only be used by system administrators wishing to
1333 override the default policies.
1334
1335 The ${datadir} applicable to dbus is usually /usr/share and the
1336 ${sysconfdir} is usually /etc.
1337
1338 • A similar pattern applies to the session bus policies in session.d.
1339
1340 Enhancements:
1341
1342 • D-Bus Specification 0.35:
1343 · Add UnixGroupIDs to GetConnectionCredentials()
1344 (dbus#196, dbus!105; Matthijs van Duin)
1345 · Remove some redundancies from the spec for interface names
1346 (dbus!102, Felipe Gasper)
1347
1348 • Raise soft fd limit to match hard limit, even if unprivileged.
1349 This makes session buses with many clients, or with clients that make
1350 heavy use of fd-passing, less likely to suffer from fd exhaustion.
1351 (dbus!103, Simon McVittie)
1352
1353 • On Linux 4.13 or later when built against a suitable glibc version,
1354 GetConnectionCredentials() now includes UnixGroupIDs, the effective
1355 group IDs of the initiator of the connection, taken from
1356 SO_PEERGROUPS. (dbus#196, dbus!105; Matthijs van Duin)
1357
1358 • Embedded/special-purpose builds of dbus can now be configured with
1359 --disable-traditional-activation, to disable services being launched
1360 as a subprocess of the dbus-daemon. This allows the system dbus-daemon
1361 to be run in a more tightly restricted security profile (an example
1362 "drop-in" for systemd is provided).
1363
1364 If systemd support is enabled, then services with a SystemdService
1365 configured can still be activated in these builds, via IPC to systemd.
1366 Otherwise, services will not be activatable at all.
1367
1368 Please note that this option is not suitable for general-purpose
1369 Linux distributions that are intended to support running third-party
1370 D-Bus services.
1371
1372 (dbus!107, Topi Miettinen)
1373
1374 • Move CMake build system to top level, matching normal practice for
1375 CMake projects (dbus!84, Ralf Habacker)
1376
1377 • Reformat CMake files (dbus#252, dbus!82, dbus!91; Ralf Habacker)
1378
1379 • Avoid GLib 2.40 dependencies (dbus!79, Ralf Habacker)
1380
1381 • Officially deprecate packaged XML policies in ${sysconfdir}, and
1382 document how to install system services correctly
1383 (dbus!76, Simon McVittie)
1384
1385 • Add AddressSanitizer and ubsan support (dbus!57, Simon McVittie)
1386
1387 Fixes:
1388
1389 • If a privileged dbus-daemon has a hard fd limit greater than 64K, don't
1390 reduce it to 64K, ensuring that we can put back the original fd limits
1391 when carrying out traditional (non-systemd) activation. This fixes a
1392 regression with systemd >= 240 in which system services inherited
1393 dbus-daemon's hard and soft limit of 64K fds, instead of the intended
1394 soft limit of 1K and hard limit of 512K or 1M.
1395 (dbus!103, Debian#928877; Simon McVittie)
1396
1397 • Fix build failures caused by an AX_CODE_COVERAGE API change in newer
1398 autoconf-archive versions (dbus#249, dbus!88; Simon McVittie)
1399
1400 • Fix build failures with newer autoconf-archive versions that include
1401 AX_-prefixed shell variable names (dbus#249, dbus!86; Simon McVittie)
1402
1403 • Avoid possible memory corruption in certain DBusHashTableIter use
1404 patterns, which in practice were never used (dbus!44, Simon McVittie)
1405
1406 • Avoid a test failure on Linux when built in a container as uid 0, but
1407 without the necessary privileges to increase resource limits
1408 (dbus!58, Debian #908092; Simon McVittie)
1409
1410 • Don't overwrite PKG_CONFIG_PATH and related environment variables when
1411 the pkg-config-based version of DBus1Config is used in a CMake project
1412 (dbus#267, dbus!96; Clemens Lang)
1413
1414 • In CMake builds, respect GNUInstallDirs variables
1415 (dbus!77, Ralf Habacker)
1416
1417 • In CMake builds, don't rebuild documentation every time
1418 (dbus!94, Ralf Habacker)
1419
1420 • In CMake builds for Windows, don't require libiconv
1421 (dbus#262, dbus!100; Ralf Habacker)
1422
1423 • Fix intermittent build failures with parallel CMake
1424 (dbus#266, dbus!113; Simon McVittie)
1425
1426 • Don't assume we can set permissions on a directory, for the benefit of
1427 MSYS and Cygwin builds (dbus#216, dbus!110; Simon McVittie)
1428
1429 • Avoid test failures with non-trivial NSS modules
1430 (dbus#256, dbus!93; Simon McVittie)
1431
1432 • Fix test failures in test-syslog and test-sysdeps under Windows
1433 (dbus#238, dbus#243, dbus!61, dbus!62; Simon McVittie)
1434
1435 • Ensure that CTest build-time tests on Windows use the just-built
1436 libdbus-1-3.dll (dbus!83, Ralf Habacker)
1437
1438 • Don't take so long to run test-refs on Windows
1439 (dbus#244, dbus!65; Ralf Habacker)
1440
1441 • Fix memory leaks in tests (dbus!68, Simon McVittie)
1442
1443 • Avoid casting user-supplied pointers to DBusBasicValue *, which is
1444 formally undefined behaviour (dbus!69, Simon McVittie)
1445
1446 • Fix a non-exploitable stack array overrun in dbus-run-session on Windows
1447 (Ralf Habacker)
1448
1449 Tests and CI enhancements:
1450
1451 • Verify that the result of an Autotools `make dist` can be used for a
1452 successful CMake build (dbus#255, dbus!87; Simon McVittie)
1453
1454 • Rewrite Python tests into C to reduce circular dependencies and
1455 facilitate use of AddressSanitizer (dbus!37, Simon McVittie)
1456
1457 • Refactor tests to extract most of their code from the bus/ and dbus/
1458 directories, and break them up into smaller modules
1459 (dbus#223, dbus#240, dbus!1, dbus!99, dbus!73, dbus!74, dbus!75;
1460 Simon McVittie, Ralf Habacker)
1461
1462 • Do CI builds in a more minimal environment (dbus!63, Simon McVittie)
1463
1464 • Improve test coverage with CMake (dbus#135, dbus!23; Ralf Habacker)
1465
1466 • Avoid firewall exception requests when running build-time tests on
1467 Windows (dbus!64, Ralf Habacker)
1468
1469 • Allow use of Wine to run cross-compiled Windows tests on Linux
1470 (dbus!60, Ralf Habacker)
1471
1472 Internal changes:
1473
1474 • Rename DBusSocketSet to the more accurate DBusPollableSet
1475 (dbus!81, Ralf Habacker)
1476
1477 • Refactor Windows implementation of dbus-spawn
1478 (dbus!80; Ralf Habacker, Simon McVittie)
1479
1480 • Delete unused code from userdb module (dbus!92, Simon McVittie)
1481
1482 • Remove unnecessary _dbus_threads_init_debug() (dbus!72, Simon McVittie)
1483
1484 dbus 1.13.8 (2018-12-04)
1485 ========================
1486
1487 The “demanding dragon” release.
1488
1489 dbus version control is now hosted on freedesktop.org's Gitlab
1490 installation, and bug reports and feature requests have switched from
1491 Bugzilla bugs (indicated by "fd.o #nnn") to Gitlab issues ("dbus#nnn")
1492 and merge requests ("dbus!nnn"). See README and CONTRIBUTING.md for
1493 more details.
1494
1495 Dependencies:
1496
1497 • dbus now requires at least a basic level of support for C99 variadic
1498 macros, as implemented in gcc >= 3, all versions of Clang, and
1499 MSVC >= 2005. In practice this requirement has existed since version
1500 1.9.2, but it is now official.
1501
1502 • dbus now requires a C99-compatible va_copy() macro (or a __va_copy()
1503 macro with the same behaviour), except when building for Windows using
1504 MSVC and CMake.
1505
1506 • Building documentation using CMake now requires xsltproc, Docbook DTDs
1507 (for example docbook-xml on Debian derivatives), and Docbook XSLT
1508 stylesheets (for example docbook-xsl on Debian derivatives). Using
1509 KDE's meinproc4 documentation processor is no longer supported.
1510
1511 Enhancements:
1512
1513 • Rewrite CONTRIBUTING.md to reflect the current setup
1514 (dbus!8, Simon McVittie)
1515
1516 • D-Bus Specification v0.34:
1517 · Fix an incorrect AddMatch() call in sample code
1518 (dbus#221, dbus!56; Philip Withnall)
1519
1520 • Tarball releases no longer contain pre-2007 changelogs and are now
1521 compressed with xz, so they should be somewhat smaller
1522 (fd.o #107630; Francesco Turco, Simon McVittie)
1523
1524 • Reference the freedesktop.org Code of Conduct (Simon McVittie)
1525
1526 • Build an implementation of dbus-run-session for Windows
1527 (dbus#135, dbus!22; Ralf Habacker)
1528
1529 • On Linux with SELinux, use avc_open() and monitor the AVC netlink fd
1530 in the main event loop, instead of using the deprecated avc_init()
1531 and a thread (dbus#134, dbus!31; Laurent Bigonville)
1532
1533 • On Linux with SELinux, use the SELINUX_CB_POLICYRELOAD callback
1534 to detect policy reloads, instead of monitoring the access vector
1535 cache with AVC_CALLBACK_RESET
1536 (dbus#134, dbus!31; Laurent Bigonville)
1537
1538 • Avoid double slashes in pkg-config paths (dbus!30, Ralf Habacker)
1539
1540 • Improve test coverage and clean up dead code
1541 (fd.o #107739, dbus#222; Simon McVittie)
1542
1543 • Allow --enable-relocation in combination with absolute paths for
1544 --exec-prefix, --libdir (fd.o #107662, Simon McVittie)
1545
1546 • Don't run a test program to check how to copy a va_list, which is
1547 awkward for cross-compiling; instead require that va_copy() or
1548 __va_copy() exists, except in older MSVC versions where we already
1549 know that simple assignment is enough (dbus!35, Simon McVittie)
1550
1551 • Simplify configure checks (dbus!10, Simon McVittie)
1552
1553 • Improve CMake build system parity with Autotools, including:
1554 · Detect inotify, prctl() and getpwnam_r() correctly on Linux
1555 · Use xsltproc instead of meinproc4 for documentation
1556 (dbus#57, dbus#117, dbus#193, dbus#227, dbus!18, dbus!39;
1557 Ralf Habacker, Simon McVittie)
1558
1559 Fixes:
1560
1561 • Stop the dbus-daemon leaking memory (an error message) if delivering
1562 the message that triggered auto-activation is forbidden. This is
1563 technically a denial of service because the dbus-daemon will
1564 run out of memory eventually, but it's a very slow and noisy one,
1565 because all the rejected messages are also very likely to have
1566 been logged to the system log, and its scope is typically limited by
1567 the finite number of activatable services available.
1568 (dbus#234, Simon McVittie)
1569
1570 • Remove __attribute__((__malloc__)) attribute on dbus_realloc(),
1571 which does not meet the criteria for that attribute in gcc 4.7+,
1572 potentially leading to miscompilation (fd.o #107741, Simon McVittie)
1573
1574 • Parse section/group names in .service files according to the syntax
1575 from the Desktop Entry Specification:
1576 · reject control characters and non-ASCII in section/group names
1577 · backslash escapes are not interpreted in section/group names
1578 (dbus#208; David King, Simon McVittie)
1579
1580 • Always use select()-based poll() emulation on Darwin-based OSs
1581 (macOS, etc.) and on Interix, similar to what libcurl does
1582 (dbus#232, dbus!19; Simon McVittie)
1583
1584 • Avoid undefined integer shifts when generating random tokens for
1585 the DBUS_COOKIE_SHA1 mechanism (dbus!45, Simon McVittie)
1586
1587 • Document the max-connections-per-user limit as unimplemented on
1588 Windows, and don't fail tests when it isn't enforced there
1589 (dbus!54, Simon McVittie)
1590
1591 • Avoid unnecessary file descriptors being inherited by dbus-daemon and
1592 dbus-launch subprocesses (dbus!50, Simon McVittie)
1593
1594 • Fix some minor memory leaks
1595 (fd.o #107320, dbus!41, dbus!42; Simon McVittie)
1596
1597 • Don't fail tests if GetConnectionUnixProcessID() succeeds on Windows,
1598 which it normally will since 1.7.x
1599 (dbus#239, dbus!55; Simon McVittie)
1600
1601 • Extend a test timeout to avoid spurious failures in CI
1602 (dbus!26, Simon McVittie)
1603
1604 • Avoid undefined signed integer operations when generating random
1605 message content during regression tests (dbus!46, Simon McVittie)
1606
1607 • Fix build warnings with recent gcc (dbus#208, dbus#225; David King)
1608
1609 • Fix build warnings without libX11 (dbus#228, Simon McVittie)
1610
1611 • Fix whitespace and error behaviour for _dbus_command_from_pid()
1612 (dbus#222, dbus!28; Simon McVittie)
1613
1614 • Fix a race condition in the containers test
1615 (dbus!47, Simon McVittie)
1616
1617 • When built with CMake, install dbus-daemon-launch-helper to
1618 ${CMAKE_INSTALL_LIBEXECDIR}, analogous to ${libexecdir} in
1619 Autotools (dbus!9, Simon McVittie)
1620
1621 • When built with CMake and disabling tests, still install
1622 dbus-daemon-launch-helper (dbus!9, Simon McVittie)
1623
1624 Tests and CI:
1625
1626 • Add Travis-CI builds for 64-bit Windows using mingw-w64
1627 (fd.o #105662, Ralf Habacker)
1628
1629 • Add Gitlab-CI integration (fd.o #108177, Simon McVittie)
1630
1631 dbus 1.13.6 (2018-08-02)
1632 ========================
1633
1634 The “vine cutting” release.
1635
1636 Fixes:
1637
1638 • Prevent reading up to 3 bytes beyond the end of a truncated message.
1639 This could in principle be an information leak or denial of service
1640 on the system bus, but is not believed to be exploitable to crash
1641 the system bus or leak interesting information in practice.
1642 (fd.o #107332, Simon McVittie)
1643
1644 • Fix build with gcc 8 -Werror=cast-function-type
1645 (fd.o #107349, Simon McVittie)
1646
1647 • Fix warning from gcc 8 about suspicious use of strncpy() when
1648 populating struct sockaddr_un (fd.o #107350, Simon McVittie)
1649
1650 • Fix a minor memory leak when a DBusServer listens on a new address
1651 (fd.o #107194, Simon McVittie)
1652
1653 • Fix an invalid NULL argument to rmdir() if a nonce-tcp DBusServer
1654 runs out of memory (fd.o #107194, Simon McVittie)
1655
1656 • Fix various memory leaks during unit tests
1657 (fd.o #107194, Simon McVittie)
1658
1659 • Don't use misleading errno-derived error names if getaddrinfo() or
1660 getnameinfo() fails with a code other than EAI_SYSTEM
1661 (fd.o #106395, Simon McVittie)
1662
1663 • Skip tests that require working TCP if we are in a container environment
1664 where 127.0.0.1 cannot be resolved (fd.o #106812, Simon McVittie)
1665
1666 dbus 1.13.4 (2018-04-30)
1667 ========================
1668
1669 The “parsimonious topping” release.
1670
1671 Dependencies:
1672
1673 • All Windows builds now require Windows Vista or later.
1674 (Note that we do not recommend or support use of dbus on operating
1675 systems outside their vendor's security support lifetime, such as Vista.)
1676
1677 Enhancements:
1678
1679 • D-Bus Specification v0.33
1680 · Be clearer about the security properties of TCP transports, which
1681 have no integrity or confidentiality protection and so should not
1682 normally be used, except via the loopback interface on Windows
1683 (fd.o #106004, Simon McVittie)
1684
1685 • On Linux 4.13 or later, <policy group="…"> now uses the SO_PEERGROUPS
1686 credentials-passing socket option to get the effective group IDs
1687 of the initiator of the connection. On platforms where that socket
1688 option is not available, dbus-daemon continues to look up the
1689 connection's user ID in the system user and group databases and
1690 assume that it has the groups that would have been granted by
1691 initgroups(). (fd.o #103737, #97821; Simon McVittie)
1692
1693 • If the dbus-daemon is compiled for Linux with systemd support, it
1694 now informs systemd that it is ready for use via the sd_notify()
1695 mechanism. (fd.o #104641; Michal Sekletar, Simon McVittie)
1696
1697 • Several environment variables set by systemd are no longer passed
1698 on to activated services (fd.o #104641, Simon McVittie)
1699
1700 • Failing to bind a TCP socket to an address produces better error
1701 messages. (fd.o #61922; Simon McVittie, Ralf Habacker)
1702
1703 • Windows builds now set the SO_REUSEADDR and TCP_NODELAY options on
1704 TCP sockets (as Unix builds already did), which should improve
1705 robustness and performance (fd.o #61922, Ralf Habacker)
1706
1707 • Windows executables built with cmake have version information.
1708 When building for Windows with Autotools, only libdbus-1-3.dll
1709 has version information, matching previous behaviour with cmake.
1710 (fd.o #103387, Ralf Habacker)
1711
1712 • The Devhelp documentation index is now in version 2 format
1713 (fd.o #106186, Simon McVittie)
1714
1715 • Give the dbus-daemon man page some scarier warnings about
1716 <allow_anonymous/> and non-local TCP, which are insecure and should
1717 not be used, particularly for the standard system and session buses
1718 (fd.o #106004, Simon McVittie)
1719
1720 Fixes:
1721
1722 • Listening on TCP sockets copes better with IPv6 being disabled
1723 (fd.o #61922; Ralf Habacker, Simon McVittie)
1724
1725 • Fix installation of Ducktype documentation with newer yelp-build
1726 versions (fd.o #106171, Simon McVittie)
1727
1728 • Fix printf formats for pointer-sized integers on 64-bit Windows
1729 (fd.o #105662, Ralf Habacker)
1730
1731 Internal changes:
1732
1733 • The _DBUS_GNUC_WARN_UNUSED_RESULT macro has been replaced with
1734 _DBUS_WARN_UNUSED_RESULT, which is effective with gcc, clang and MSVC
1735 (with cl.exe /analyze). Note that for MSVC compatibility, it must
1736 appear before the return type in function declarations, whereas the
1737 older macro could also have appeared after the arguments.
1738 (fd.o #105460; Daniel Wendt, Ralf Habacker)
1739
1740 dbus 1.13.2 (2018-03-01)
1741 ========================
1742
1743 The “can break a man's arm” release.
1744
1745 Enhancements:
1746
1747 • When a container manager creates an extra server at runtime, services
1748 can now request that messages from connections to that server are
1749 tagged with the container instance ID, providing a fast-path for
1750 identifying such connections. (fd.o #101899, Simon McVittie)
1751
1752 Fixes:
1753
1754 • Increase system dbus-daemon's RLIMIT_NOFILE rlimit before it drops
1755 privileges, because it won't have permission afterwards. This fixes a
1756 regression in dbus 1.10.18 and 1.11.0 which made the standard system bus
1757 more susceptible to deliberate or accidental denial of service.
1758 (fd.o #105165, David King)
1759
1760 dbus 1.13.0 (2018-02-08)
1761 ========================
1762
1763 The “Citispeed Eco 75” release.
1764
1765 This is a new development branch for the adventurous, and comes with a
1766 risk of regressions. OS distributions should stay with the 1.12.x branch,
1767 unless they can commit to following the 1.13.x branch until it reaches
1768 a 1.14.0 stable release at an unspecified point in the future.
1769
1770 In particular, the new Containers API is subject to change and shouldn't
1771 be enabled in distributions yet, even those aimed at early adopters
1772 (hello, Arch Linux).
1773
1774 Behaviour changes:
1775
1776 • DBusServer (and hence the dbus-daemon) no longer accepts usernames
1777 (login names) for the recommended EXTERNAL authentication mechanism,
1778 only numeric user IDs or the empty string. This is not believed to
1779 affect real D-Bus clients in practice, because most D-Bus clients
1780 send numeric user IDs: the only known client implementation that
1781 sends usernames is dbus-java, and that only when run on a system
1782 where the com.sun.security.auth.module.UnixSystem.getUid() method is
1783 not available. (fd.o #104588, Simon McVittie)
1784
1785 Enhancements:
1786
1787 • D-Bus Specification v0.32
1788 · Deprecate hyphen/minus in reversed domain names, recommending
1789 underscores instead. Recommend prepending an underscore to domain
1790 components that start with a digit, which would not be allowed.
1791 (fd.o #103914, Simon McVittie)
1792 · Clarify how the SASL authentication handshake works
1793 (fd.o #104224, Simon McVittie)
1794 · Recommend that the message bus should remove message header fields
1795 that it does not understand. The new item "HeaderFiltering" in the
1796 message bus' Features property indicates that it promises to do so.
1797 (fd.o #100317, Simon McVittie)
1798
1799 • Add experimental support for creating extra servers at runtime, to
1800 be used by app containers like Flatpak or Snap. This API is still
1801 subject to change and is not compiled in by default.
1802 (fd.o #101354, Simon McVittie)
1803
1804 • Improve automated test logging (fd.o #103601, Simon McVittie)
1805
1806 • The dbus-daemon now filters the messages that it relays, removing
1807 header fields that it does not understand. Clients must not rely on
1808 this behaviour unless they have confirmed that they are connected to
1809 a suitable message bus implementation, for example by querying its
1810 Features property. (fd.o #100317, Simon McVittie)
1811
1812 Fixes:
1813
1814 • When iterating the DBusConnection while blocking on a pending call,
1815 don't wait for I/O if that pending call already has a result; and make
1816 sure that whether it has a result is propagated in a thread-safe way.
1817 This prevents certain multi-threaded calling patterns from blocking
1818 until their timeout even when they should have succeeded sooner.
1819 (fd.o #102839; Manish Narang, Michael Searle)
1820
1821 • Do not look up client-supplied strings in the system user database
1822 (NSS or equivalent) when using the recommended EXTERNAL auth mechanism.
1823 This could previously lead to a deadlock or timeout in the presence of
1824 slow or network-dependent NSS modules. (fd.o #104588, Simon McVittie)
1825
1826 • Report the correct error if OOM is reached while trying to listen
1827 on a TCP socket (fd.o #89104, Simon McVittie)
1828
1829 • Fix a crash and an assertion failure in the server side of the
1830 nonce-tcp: transport under error conditions
1831 (fd.o #89104, Simon McVittie)
1832
1833 • Fix assertion failures in recovery from OOM while setting up a
1834 DBusServer (fd.o #89104, Simon McVittie)
1835
1836 • Don't leak a file descriptor if setting up a launchd server fails
1837 (fd.o #89104, Simon McVittie)
1838
1839 • Add a missing space to a warning message (fd.o #103729, Thomas Zajic)
1840
1841 • Fix some memory leaks in automated tests
1842 (fd.o #103600, Simon McVittie)
1843
1844 • Expand ${bindir} correctly when pkg-config is asked for dbus_daemondir
1845 (fd.o #104265, Benedikt Heine)
1846
1847 • On Linux systems with systemd < 237, if ${localstatedir}/lib/dbus doesn't
1848 exist, create it before trying to create ${localstatedir}/lib/dbus/machine-id
1849 (fd.o #104577, Chris Lesiak)
1850
1851 • Fix escaping in dbus-api-design document (fd.o #104925, Philip Withnall)
1852
1853 Internal changes:
1854
1855 • Harden the nonce-tcp: transport against resource leaks and
1856 use-after-free (fd.o #103597, Simon McVittie)
1857
1858 • Make _DBUS_STRING_DEFINE_STATIC more consistent with
1859 _dbus_string_init_const() (fd.o #89104, Simon McVittie)
1860
1861 • Add _DBUS_STRING_INIT_INVALID, analogous to NULL, and use it to
1862 simplify error unwinding code paths (fd.o #89104, Simon McVittie)
1863
1864 • Make the behaviour of _dbus_string_init_const()/_dbus_string_free()
1865 consistent with _dbus_string_init()/_dbus_string_free(): it now clears
1866 the string to _DBUS_STRING_INIT_INVALID, whereas previously it left
1867 the string untouched (fd.o #89104, Simon McVittie)
1868
1869 • Remove automated test data for wire protocol version 0, which has not
1870 been supported since 2005 (fd.o #103758, Simon McVittie)
1871
1872 • Simplify method calls in automated tests
1873 (fd.o #103600, Simon McVittie)
1874
1875 dbus 1.12.2 (2017-11-13)
1876 ========================
1877
1878 The “spider pumpkin” release.
1879
1880 Enhancements:
1881
1882 • Log a warning if a new connection cannot be accepted due to an
1883 out-of-memory condition or failure to identify its AppArmor or
1884 SELinux context (fd.o #103592, Simon McVittie)
1885
1886 Fixes:
1887
1888 • Make use of $(MKDIR_P) compatible with install-sh, fixing build when a
1889 GNU-compatible `mkdir -p` is not available (fd.o #103521, ilovezfs)
1890
1891 • When building for Windows with Autotools, avoid `echo -e`, fixing
1892 cross-compilation on non-GNU platforms like macOS
1893 (fd.o #103493, Tony Theodore)
1894
1895 • Fix crashes in the server side of the nonce-tcp: transport under
1896 various error conditions. This transport should normally only be used
1897 on Windows, where AF_UNIX sockets are unavailable; the unix: transport
1898 is the only one recommended for production use on Unix platforms.
1899 (fd.o #103597, Simon McVittie)
1900
1901 Internal changes:
1902
1903 • Improve test coverage on Travis-CI (Simon McVittie)
1904
1905 dbus 1.12.0 (2017-10-30)
1906 ========================
1907
1908 The “gingerbread skull” release.
1909
1910 1.12.x is a new stable branch, recommended for use in OS
1911 distributions.
1912
1913 Summary of major changes between 1.10.x and 1.12.0
1914 --------------------------------------------------
1915
1916 Dependencies:
1917
1918 • Expat >= 2.1.0 is required.
1919 • GLib >= 2.40 is required if full test coverage is enabled.
1920 • [Linux] libselinux >= 2.0.86 is required if SELinux support is
1921 enabled.
1922 • [Unix] dbus now requires an <inttypes.h> that defines C99 constants
1923 such as PRId64 and PRIu64, except when building for Windows.
1924 • [Autotools] Building from git (but not from tarballs) with Autotools
1925 now requires macros from the GNU Autoconf Archive.
1926 • [CMake] Builds done using CMake now require CMake 3.0.2.
1927
1928 Build-time configuration changes:
1929
1930 • Expat is now found using pkg-config. See the release notes for
1931 1.11.14.
1932 • The --disable-compiler-optimisations and --enable-compiler-coverage
1933 options no longer exist. See the release notes for 1.11.4 and 1.11.8.
1934 • [Unix] The --enable-abstract-sockets and --disable-abstract-sockets
1935 options no longer exist. See the release notes for 1.11.20.
1936 • [Unix] Flag files in /var/run/console/${username} are no longer
1937 checked for at_console by default. See the release notes for 1.11.18.
1938 • [Unix, Cygwin] Init scripts are no longer provided by upstream dbus,
1939 and packagers will now need to add these downstream (most already do).
1940 See the release notes for 1.11.18.
1941 • [Unix] The process ID file no longer has a different default location
1942 on Red Hat derivatives. See the release notes for 1.11.18.
1943 • [Unix] ${runstatedir} is now independent of ${localstatedir} with
1944 recent Autotools versions. See the release notes for 1.11.16.
1945 • [Windows] The WINDRES variable is no longer used. See the release
1946 notes for 1.11.22.
1947
1948 Deprecations:
1949
1950 • Eavesdropping is officially deprecated in favour of BecomeMonitor.
1951 See the release notes for spec version 0.31 (in dbus 1.11.14).
1952 • [Unix] Flag files in /var/run/console/${username} are deprecated.
1953 See the release notes for 1.11.18.
1954
1955 New APIs:
1956
1957 • <allow> and <deny> rules in dbus-daemon configuration can now
1958 include send_broadcast="true", send_broadcast="false",
1959 max_unix_fds="N", min_unix_fds="N" (for some integer N).
1960 See the release notes for 1.11.18.
1961 • dbus_try_get_local_machine_id() is like
1962 dbus_get_local_machine_id(), but returns a DBusError.
1963 • New APIs around DBusMessageIter to simplify cleanup.
1964 See the release notes for 1.11.16.
1965 • The message bus daemon now implements the standard Introspectable,
1966 Peer and Properties interfaces. See the release notes for
1967 dbus 1.11.14 and spec version 0.31.
1968 • DTDs for introspection XML and bus configuration are installed.
1969 • dbus can be compiled to be relocatable, making it more suitable for
1970 binary bundling with other software. On Windows, this is on by
1971 default.
1972 • [Unix] A new unix:dir=… address family resembles unix:tmpdir=… but
1973 never uses Linux abstract sockets, which is advantageous for
1974 containers. On non-Linux it is equivalent to unix:tmpdir=….
1975 See the release notes for dbus 1.11.14 and spec version 0.31.
1976 • [Unix] New option "dbus-launch --exit-with-x11".
1977 • [Unix] Session managers can create transient .service files in
1978 $XDG_RUNTIME_DIR/dbus-1/services. See the release notes for 1.11.12.
1979 • [Unix] A sysusers.d snippet can create the messagebus user on-demand.
1980
1981 Miscellaneous behaviour changes:
1982
1983 • [Unix] The session bus now logs to syslog if it was started by
1984 dbus-launch.
1985 • [Unix] Internal warnings are logged to syslog if configured.
1986 • [Unix] Exceeding an anti-DoS limit is logged to syslog if configured,
1987 or to stderr.
1988
1989 Changes since 1.11.22 release candidate
1990 ---------------------------------------
1991
1992 Standard stable-branch changes:
1993
1994 • Disable warnings about use of deprecated functions (Simon McVittie)
1995
1996 Fixes:
1997
1998 • Don't distribute files generated by ./configure in the source tarball
1999 (fd.o #103420, Simon McVittie)
2000
2001 Internal changes:
2002
2003 • Remove some unused files from the git repository
2004 (fd.o #103420, Simon McVittie)