NEWS 127 KB
Newer Older
Simon McVittie's avatar
Simon McVittie committed
1 2 3
dbus 1.13.8 (UNRELEASED)
========================

Simon McVittie's avatar
Simon McVittie committed
4 5 6 7 8 9
dbus version control is now hosted on freedesktop.org's Gitlab
installation, and bug reports and feature requests have switched from
Bugzilla bugs (indicated by "fd.o #nnn") to Gitlab issues ("dbus#nnn")
and merge requests ("dbus!nnn"). See README and CONTRIBUTING.md for
more details.

Simon McVittie's avatar
Simon McVittie committed
10 11 12 13 14 15 16
Dependencies:

• dbus now requires at least a basic level of support for C99 variadic
  macros, as implemented in gcc >= 3, all versions of Clang, and
  MSVC >= 2005. In practice this requirement has existed since version
  1.9.2, but it is now official.

17 18 19 20
• dbus now requires a C99-compatible va_copy() macro (or a __va_copy()
  macro with the same behaviour), except when building for Windows using
  MSVC and CMake.

Simon McVittie's avatar
Simon McVittie committed
21 22
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
23 24 25
• Rewrite CONTRIBUTING.md to reflect the current setup
  (dbus!8, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
26 27 28 29
• D-Bus Specification v0.34:
  · Fix an incorrect AddMatch() call in sample code
    (dbus#221, dbus!56; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
30 31 32 33 34 35
• Tarball releases no longer contain pre-2007 changelogs and are now
  compressed with xz, so they should be somewhat smaller
  (fd.o #107630; Francesco Turco, Simon McVittie)

• Reference the freedesktop.org Code of Conduct (Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
36 37 38 39 40 41 42 43 44 45 46 47 48 49
• Build an implementation of dbus-run-session for Windows
  (dbus#135, dbus!22; Ralf Habacker)

• On Linux with SELinux, use avc_open() and monitor the AVC netlink fd
  in the main event loop, instead of using the deprecated avc_init()
  and a thread (dbus#134, dbus!31; Laurent Bigonville)

• On Linux with SELinux, use the SELINUX_CB_POLICYRELOAD callback
  to detect policy reloads, instead of monitoring the access vector
  cache with AVC_CALLBACK_RESET
  (dbus#134, dbus!31; Laurent Bigonville)

• Avoid double slashes in pkg-config paths (dbus!30, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
50
• Improve test coverage and clean up dead code
Simon McVittie's avatar
Simon McVittie committed
51
  (fd.o #107739, dbus#222; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
52

Simon McVittie's avatar
Simon McVittie committed
53 54 55
• Allow --enable-relocation in combination with absolute paths for
  --exec-prefix, --libdir (fd.o #107662, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
56 57 58 59 60
• Don't run a test program to check how to copy a va_list, which is
  awkward for cross-compiling; instead require that va_copy() or
  __va_copy() exists, except in older MSVC versions where we already
  know that simple assignment is enough (dbus!35, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
61 62 63 64 65
 Simplify configure checks (dbus!10, Simon McVittie)

 Improve CMake build system parity with Autotools, including:
  · Detect inotify, prctl() and getpwnam_r() correctly on Linux
  · Use xsltproc instead of meinproc4 for documentation
Simon McVittie's avatar
Simon McVittie committed
66
  (dbus#57, dbus#117, dbus#193, dbus#227, dbus!18, dbus!39;
67
  Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
68

Simon McVittie's avatar
Simon McVittie committed
69 70
Fixes:

Simon McVittie's avatar
Simon McVittie committed
71 72 73 74 75 76 77 78 79
 Stop the dbus-daemon leaking memory (an error message) if delivering
  the message that triggered auto-activation is forbidden. This is
  technically a denial of service because the dbus-daemon will
  run out of memory eventually, but it's a very slow and noisy one,
  because all the rejected messages are also very likely to have
  been logged to the system log, and its scope is typically limited by
  the finite number of activatable services available.
  (dbus#234, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
80 81 82 83
• Remove __attribute__((__malloc__)) attribute on dbus_realloc(),
  which does not meet the criteria for that attribute in gcc 4.7+,
  potentially leading to miscompilation (fd.o #107741, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
84 85 86 87 88 89
• Parse section/group names in .service files according to the syntax
  from the Desktop Entry Specification:
  · reject control characters and non-ASCII in section/group names
  · backslash escapes are not interpreted in section/group names
  (dbus#208; David King, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
90 91 92 93
• Always use select()-based poll() emulation on Darwin-based OSs
  (macOS, etc.) and on Interix, similar to what libcurl does
  (dbus#232, dbus!19; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
94 95 96
• Avoid undefined integer shifts when generating random tokens for
  the DBUS_COOKIE_SHA1 mechanism (dbus!45, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
97 98 99 100 101 102 103
• Document the max-connections-per-user limit as unimplemented on
  Windows, and don't fail tests when it isn't enforced there
  (dbus!54, Simon McVittie)

• Avoid unnecessary file descriptors being inherited by dbus-daemon and
  dbus-launch subprocesses (dbus!50, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
104 105
• Fix some minor memory leaks
  (fd.o #107320, dbus!41, dbus!42; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
106

Simon McVittie's avatar
Simon McVittie committed
107 108 109 110
• Don't fail tests if GetConnectionUnixProcessID() succeeds on Windows,
  which it normally will since 1.7.x
  (dbus#239, dbus!55; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
111 112 113
 Extend a test timeout to avoid spurious failures in CI
  (dbus!26, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
114 115 116
 Avoid undefined signed integer operations when generating random
  message content during regression tests (dbus!46, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
117 118 119 120
 Fix build warnings with recent gcc (dbus#208, dbus#225; David King)

 Fix build warnings without libX11 (dbus#228, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
121 122 123
 Fix whitespace and error behaviour for _dbus_command_from_pid()
  (dbus#222, dbus!28; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
124 125 126
 Fix a race condition in the containers test
  (dbus!47, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
127 128 129 130 131 132 133
 When built with CMake, install dbus-daemon-launch-helper to
  ${CMAKE_INSTALL_LIBEXECDIR}, analogous to ${libexecdir} in
  Autotools (dbus!9, Simon McVittie)

 When built with CMake and disabling tests, still install
  dbus-daemon-launch-helper (dbus!9, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
134 135 136 137 138 139 140
Tests and CI:

 Add Travis-CI builds for 64-bit Windows using mingw-w64
  (fd.o #105662, Ralf Habacker)

 Add Gitlab-CI integration (fd.o #108177, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
141
dbus 1.13.6 (2018-08-02)
142 143
========================

Simon McVittie's avatar
Simon McVittie committed
144 145
The vine cutting release.

Simon McVittie's avatar
Simon McVittie committed
146 147
Fixes:

Simon McVittie's avatar
Simon McVittie committed
148 149 150 151 152 153
 Prevent reading up to 3 bytes beyond the end of a truncated message.
  This could in principle be an information leak or denial of service
  on the system bus, but is not believed to be exploitable to crash
  the system bus or leak interesting information in practice.
  (fd.o #107332, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
154 155 156 157 158 159
 Fix build with gcc 8 -Werror=cast-function-type
  (fd.o #107349, Simon McVittie)

 Fix warning from gcc 8 about suspicious use of strncpy() when
  populating struct sockaddr_un (fd.o #107350, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
160 161 162 163 164 165 166 167 168
 Fix a minor memory leak when a DBusServer listens on a new address
  (fd.o #107194, Simon McVittie)

 Fix an invalid NULL argument to rmdir() if a nonce-tcp DBusServer
  runs out of memory (fd.o #107194, Simon McVittie)

 Fix various memory leaks during unit tests
  (fd.o #107194, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
169 170 171 172 173 174
 Don't use misleading errno-derived error names if getaddrinfo() or
  getnameinfo() fails with a code other than EAI_SYSTEM
  (fd.o #106395, Simon McVittie)

• Skip tests that require working TCP if we are in a container environment
  where 127.0.0.1 cannot be resolved (fd.o #106812, Simon McVittie)
175

Simon McVittie's avatar
Simon McVittie committed
176
dbus 1.13.4 (2018-04-30)
Simon McVittie's avatar
Simon McVittie committed
177 178
========================

179 180
The “parsimonious topping” release.

181 182 183 184 185 186
Dependencies:

• All Windows builds now require Windows Vista or later.
  (Note that we do not recommend or support use of dbus on operating
  systems outside their vendor's security support lifetime, such as Vista.)

187 188
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
189
 D-Bus Specification v0.33
Simon McVittie's avatar
Simon McVittie committed
190 191 192 193 194
  · Be clearer about the security properties of TCP transports, which
    have no integrity or confidentiality protection and so should not
    normally be used, except via the loopback interface on Windows
    (fd.o #106004, Simon McVittie)

195 196 197 198 199 200 201 202 203 204 205
 On Linux 4.13 or later, <policy group="…"> now uses the SO_PEERGROUPS
  credentials-passing socket option to get the effective group IDs
  of the initiator of the connection. On platforms where that socket
  option is not available, dbus-daemon continues to look up the
  connection's user ID in the system user and group databases and
  assume that it has the groups that would have been granted by
  initgroups(). (fd.o #103737, #97821; Simon McVittie)

• If the dbus-daemon is compiled for Linux with systemd support, it
  now informs systemd that it is ready for use via the sd_notify()
  mechanism. (fd.o #104641; Michal Sekletar, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
206

Simon McVittie's avatar
Simon McVittie committed
207 208 209
• Several environment variables set by systemd are no longer passed
  on to activated services (fd.o #104641, Simon McVittie)

210 211 212 213 214 215 216 217 218 219 220 221
• Failing to bind a TCP socket to an address produces better error
  messages. (fd.o #61922; Simon McVittie, Ralf Habacker)

• Windows builds now set the SO_REUSEADDR and TCP_NODELAY options on
  TCP sockets (as Unix builds already did), which should improve
  robustness and performance (fd.o #61922, Ralf Habacker)

• Windows executables built with cmake have version information.
  When building for Windows with Autotools, only libdbus-1-3.dll
  has version information, matching previous behaviour with cmake.
  (fd.o #103387, Ralf Habacker)

222 223 224
• The Devhelp documentation index is now in version 2 format
  (fd.o #106186, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
225
• Give the dbus-daemon man page some scarier warnings about
226 227
  <allow_anonymous/> and non-local TCP, which are insecure and should
  not be used, particularly for the standard system and session buses
Simon McVittie's avatar
Simon McVittie committed
228 229
  (fd.o #106004, Simon McVittie)

230 231 232 233 234
Fixes:

• Listening on TCP sockets copes better with IPv6 being disabled
  (fd.o #61922; Ralf Habacker, Simon McVittie)

235 236 237
• Fix installation of Ducktype documentation with newer yelp-build
  versions (fd.o #106171, Simon McVittie)

238 239 240
• Fix printf formats for pointer-sized integers on 64-bit Windows
  (fd.o #105662, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
241 242 243 244 245 246 247 248 249
Internal changes:

• The _DBUS_GNUC_WARN_UNUSED_RESULT macro has been replaced with
  _DBUS_WARN_UNUSED_RESULT, which is effective with gcc, clang and MSVC
  (with cl.exe /analyze). Note that for MSVC compatibility, it must
  appear before the return type in function declarations, whereas the
  older macro could also have appeared after the arguments.
  (fd.o #105460; Daniel Wendt, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
250
dbus 1.13.2 (2018-03-01)
Simon McVittie's avatar
Simon McVittie committed
251 252
========================

Simon McVittie's avatar
Simon McVittie committed
253 254
The “can break a man's arm release.

255 256 257 258 259 260
Enhancements:

 When a container manager creates an extra server at runtime, services
  can now request that messages from connections to that server are
  tagged with the container instance ID, providing a fast-path for
  identifying such connections. (fd.o #101899, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
261

Simon McVittie's avatar
Simon McVittie committed
262 263 264
Fixes:

 Increase system dbus-daemon's RLIMIT_NOFILE rlimit before it drops
265 266 267
  privileges, because it won't have permission afterwards. This fixes a
  regression in dbus 1.10.18 and 1.11.0 which made the standard system bus
  more susceptible to deliberate or accidental denial of service.
Simon McVittie's avatar
Simon McVittie committed
268 269
  (fd.o #105165, David King)

Simon McVittie's avatar
Simon McVittie committed
270
dbus 1.13.0 (2018-02-08)
271 272
========================

Simon McVittie's avatar
Simon McVittie committed
273 274
The Citispeed Eco 75 release.

275 276 277 278 279
This is a new development branch for the adventurous, and comes with a
risk of regressions. OS distributions should stay with the 1.12.x branch,
unless they can commit to following the 1.13.x branch until it reaches
a 1.14.0 stable release at an unspecified point in the future.

Simon McVittie's avatar
Simon McVittie committed
280 281 282 283
In particular, the new Containers API is subject to change and shouldn't
be enabled in distributions yet, even those aimed at early adopters
(hello, Arch Linux).

Simon McVittie's avatar
Simon McVittie committed
284 285 286 287 288 289 290 291 292 293 294
Behaviour changes:

• DBusServer (and hence the dbus-daemon) no longer accepts usernames
  (login names) for the recommended EXTERNAL authentication mechanism,
  only numeric user IDs or the empty string. This is not believed to
  affect real D-Bus clients in practice, because most D-Bus clients
  send numeric user IDs: the only known client implementation that
  sends usernames is dbus-java, and that only when run on a system
  where the com.sun.security.auth.module.UnixSystem.getUid() method is
  not available. (fd.o #104588, Simon McVittie)

295 296
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
297 298 299 300 301
• D-Bus Specification v0.32
  · Deprecate hyphen/minus in reversed domain names, recommending
    underscores instead. Recommend prepending an underscore to domain
    components that start with a digit, which would not be allowed.
    (fd.o #103914, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
302 303
  · Clarify how the SASL authentication handshake works
    (fd.o #104224, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
304 305 306 307
  · Recommend that the message bus should remove message header fields
    that it does not understand. The new item "HeaderFiltering" in the
    message bus' Features property indicates that it promises to do so.
    (fd.o #100317, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
308

Simon McVittie's avatar
Simon McVittie committed
309 310 311 312 313
 Add experimental support for creating extra servers at runtime, to
  be used by app containers like Flatpak or Snap. This API is still
  subject to change and is not compiled in by default.
  (fd.o #101354, Simon McVittie)

314 315
 Improve automated test logging (fd.o #103601, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
316 317 318 319 320 321
 The dbus-daemon now filters the messages that it relays, removing
  header fields that it does not understand. Clients must not rely on
  this behaviour unless they have confirmed that they are connected to
  a suitable message bus implementation, for example by querying its
  Features property. (fd.o #100317, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
322 323
Fixes:

Simon McVittie's avatar
Simon McVittie committed
324 325 326 327 328 329 330
 When iterating the DBusConnection while blocking on a pending call,
  don't wait for I/O if that pending call already has a result; and make
  sure that whether it has a result is propagated in a thread-safe way.
  This prevents certain multi-threaded calling patterns from blocking
  until their timeout even when they should have succeeded sooner.
  (fd.o #102839; Manish Narang, Michael Searle)

Simon McVittie's avatar
Simon McVittie committed
331 332 333 334 335
• Do not look up client-supplied strings in the system user database
  (NSS or equivalent) when using the recommended EXTERNAL auth mechanism.
  This could previously lead to a deadlock or timeout in the presence of
  slow or network-dependent NSS modules. (fd.o #104588, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
336 337 338 339 340 341 342 343 344 345 346 347 348
• Report the correct error if OOM is reached while trying to listen
  on a TCP socket (fd.o #89104, Simon McVittie)

• Fix a crash and an assertion failure in the server side of the
  nonce-tcp: transport under error conditions
  (fd.o #89104, Simon McVittie)

• Fix assertion failures in recovery from OOM while setting up a
  DBusServer (fd.o #89104, Simon McVittie)

• Don't leak a file descriptor if setting up a launchd server fails
  (fd.o #89104, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
349 350
 Add a missing space to a warning message (fd.o #103729, Thomas Zajic)

Simon McVittie's avatar
Simon McVittie committed
351 352 353
 Fix some memory leaks in automated tests
  (fd.o #103600, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
354 355 356
 Expand ${bindir} correctly when pkg-config is asked for dbus_daemondir
  (fd.o #104265, Benedikt Heine)

357 358
 On Linux systems with systemd < 237, if ${localstatedir}/dbus doesn't
  exist, create it before trying to create ${localstatedir}/dbus/machine-id
Simon McVittie's avatar
Simon McVittie committed
359 360
  (fd.o #104577, Chris Lesiak)

Simon McVittie's avatar
Simon McVittie committed
361 362
• Fix escaping in dbus-api-design document (fd.o #104925, Philip Withnall)

363 364 365 366 367 368 369
Internal changes:

• Harden the nonce-tcp: transport against resource leaks and
  use-after-free (fd.o #103597, Simon McVittie)

• Make _DBUS_STRING_DEFINE_STATIC more consistent with
  _dbus_string_init_const() (fd.o #89104, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
370

Simon McVittie's avatar
Simon McVittie committed
371 372 373 374 375 376 377 378
• Add _DBUS_STRING_INIT_INVALID, analogous to NULL, and use it to
  simplify error unwinding code paths (fd.o #89104, Simon McVittie)

• Make the behaviour of _dbus_string_init_const()/_dbus_string_free()
  consistent with _dbus_string_init()/_dbus_string_free(): it now clears
  the string to _DBUS_STRING_INIT_INVALID, whereas previously it left
  the string untouched (fd.o #89104, Simon McVittie)

379 380 381
• Remove automated test data for wire protocol version 0, which has not
  been supported since 2005 (fd.o #103758, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
382 383 384
• Simplify method calls in automated tests
  (fd.o #103600, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
385
dbus 1.12.2 (2017-11-13)
386 387
========================

Simon McVittie's avatar
Simon McVittie committed
388
The “spider pumpkin” release.
389

Simon McVittie's avatar
Simon McVittie committed
390 391 392 393 394 395
Enhancements:

• Log a warning if a new connection cannot be accepted due to an
  out-of-memory condition or failure to identify its AppArmor or
  SELinux context (fd.o #103592, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
396 397 398 399 400
Fixes:

• Make use of $(MKDIR_P) compatible with install-sh, fixing build when a
  GNU-compatible `mkdir -p` is not available (fd.o #103521, ilovezfs)

Simon McVittie's avatar
Simon McVittie committed
401 402 403 404
• When building for Windows with Autotools, avoid `echo -e`, fixing
  cross-compilation on non-GNU platforms like macOS
  (fd.o #103493, Tony Theodore)

Simon McVittie's avatar
Simon McVittie committed
405 406 407 408 409 410
• Fix crashes in the server side of the nonce-tcp: transport under
  various error conditions. This transport should normally only be used
  on Windows, where AF_UNIX sockets are unavailable; the unix: transport
  is the only one recommended for production use on Unix platforms.
  (fd.o #103597, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
411 412
Internal changes:

Simon McVittie's avatar
Simon McVittie committed
413 414
• Improve test coverage on Travis-CI (Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
415
dbus 1.12.0 (2017-10-30)
416 417
========================

Simon McVittie's avatar
Simon McVittie committed
418 419 420 421
The “gingerbread skull” release.

1.12.x is a new stable branch, recommended for use in OS
distributions.
422 423 424 425 426 427

Summary of major changes between 1.10.x and 1.12.0
--------------------------------------------------

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
428
• Expat >= 2.1.0 is required.
429 430 431 432 433 434 435
• GLib >= 2.40 is required if full test coverage is enabled.
• [Linux] libselinux >= 2.0.86 is required if SELinux support is
  enabled.
• [Unix] dbus now requires an <inttypes.h> that defines C99 constants
  such as PRId64 and PRIu64, except when building for Windows.
• [Autotools] Building from git (but not from tarballs) with Autotools
  now requires macros from the GNU Autoconf Archive.
Simon McVittie's avatar
Simon McVittie committed
436
• [CMake] Builds done using CMake now require CMake 3.0.2.
437 438 439 440 441 442 443 444 445 446 447 448 449 450

Build-time configuration changes:

• Expat is now found using pkg-config. See the release notes for
  1.11.14.
• The --disable-compiler-optimisations and --enable-compiler-coverage
  options no longer exist.  See the release notes for 1.11.4 and 1.11.8.
• [Unix] The --enable-abstract-sockets and --disable-abstract-sockets
  options no longer exist. See the release notes for 1.11.20.
• [Unix] Flag files in /var/run/console/${username} are no longer
  checked for at_console by default. See the release notes for 1.11.18.
• [Unix, Cygwin] Init scripts are no longer provided by upstream dbus,
  and packagers will now need to add these downstream (most already do).
  See the release notes for 1.11.18.
Simon McVittie's avatar
Simon McVittie committed
451 452 453 454
• [Unix] The process ID file no longer has a different default location
  on Red Hat derivatives. See the release notes for 1.11.18.
• [Unix] ${runstatedir} is now independent of ${localstatedir} with
  recent Autotools versions. See the release notes for 1.11.16.
455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495
• [Windows] The WINDRES variable is no longer used. See the release
  notes for 1.11.22.

Deprecations:

• Eavesdropping is officially deprecated in favour of BecomeMonitor.
  See the release notes for spec version 0.31 (in dbus 1.11.14).
• [Unix] Flag files in /var/run/console/${username} are deprecated.
  See the release notes for 1.11.18.

New APIs:

• <allow> and <deny> rules in dbus-daemon configuration can now
  include send_broadcast="true", send_broadcast="false",
  max_unix_fds="N", min_unix_fds="N" (for some integer N).
  See the release notes for 1.11.18.
• dbus_try_get_local_machine_id() is like
  dbus_get_local_machine_id(), but returns a DBusError.
• New APIs around DBusMessageIter to simplify cleanup.
  See the release notes for 1.11.16.
• The message bus daemon now implements the standard Introspectable,
  Peer and Properties interfaces. See the release notes for
  dbus 1.11.14 and spec version 0.31.
• DTDs for introspection XML and bus configuration are installed.
• dbus can be compiled to be relocatable, making it more suitable for
  binary bundling with other software. On Windows, this is on by
  default.
• [Unix] A new unix:dir=… address family resembles unix:tmpdir=… but
  never uses Linux abstract sockets, which is advantageous for
  containers. On non-Linux it is equivalent to unix:tmpdir=….
  See the release notes for dbus 1.11.14 and spec version 0.31.
• [Unix] New option "dbus-launch --exit-with-x11".
• [Unix] Session managers can create transient .service files in
  $XDG_RUNTIME_DIR/dbus-1/services. See the release notes for 1.11.12.
• [Unix] A sysusers.d snippet can create the messagebus user on-demand.

Miscellaneous behaviour changes:

• [Unix] The session bus now logs to syslog if it was started by
  dbus-launch.
• [Unix] Internal warnings are logged to syslog if configured.
Simon McVittie's avatar
Simon McVittie committed
496 497
• [Unix] Exceeding an anti-DoS limit is logged to syslog if configured,
  or to stderr.
498

Simon McVittie's avatar
Simon McVittie committed
499 500 501 502
Changes since 1.11.22 release candidate
---------------------------------------

Standard stable-branch changes:
503

Simon McVittie's avatar
Simon McVittie committed
504
• Disable warnings about use of deprecated functions (Simon McVittie)
505

Simon McVittie's avatar
Simon McVittie committed
506 507 508 509 510 511 512 513 514
Fixes:

• Don't distribute files generated by ./configure in the source tarball
  (fd.o #103420, Simon McVittie)

Internal changes:

 Remove some unused files from the git repository
  (fd.o #103420, Simon McVittie)
515

Simon McVittie's avatar
Simon McVittie committed
516
D-Bus 1.11.22 (2017-10-23)
517
==========================
518

Simon McVittie's avatar
Simon McVittie committed
519 520 521 522
The fire surface release.

This is the first release-candidate for the 1.12.0 stable release.

Simon McVittie's avatar
Simon McVittie committed
523 524 525 526 527 528 529 530 531 532 533
Build-time configuration changes:

 When building for Windows with Autotools, setting the WINDRES variable
  no longer works to select a non-standard resource compiler. Use
  libtool's standard RC variable instead, for example
  "./configure RC=i686-w64-mingw32-windres"

Dependencies:

• Builds done using CMake now require CMake 3.0.2.

534 535 536 537 538
Enhancements:

• When building for Windows, improve quality of metadata in
  libdbus-1-3.dll (fd.o #103015, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
539 540 541 542 543 544 545 546 547
Fixes:

• Fix a typo "uint 16" in dbus-send(1) man page
  (fd.o #103075, David King)

• When building for Windows, libdbus-1-3.dll always includes version
  information. Previously, this was missing if using CMake and any
  non-MSVC compiler. (fd.o #103015, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
548 549 550
• Fix the build with MSVC, which regressed with the #102558 fix in
  1.11.20. (fd.o #102558, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
551 552 553 554
Internal changes:

• Simplify Windows resource embedding
  (fd.o #103015, Simon McVittie)
555

Simon McVittie's avatar
Simon McVittie committed
556
D-Bus 1.11.20 (2017-10-03)
557 558
==

559 560
The “wraith stun” release.

Simon McVittie's avatar
Simon McVittie committed
561 562 563
Build-time configuration changes:

• The --enable-abstract-sockets and --disable-abstract-sockets options
Simon McVittie's avatar
Simon McVittie committed
564 565 566
  no longer exist. Support for Linux's abstract AF_UNIX sockets is now
  unconditionally enabled on Linux and disabled everywhere else.
  (fd.o #34905, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588

Enhancements:

 Make slower tests less likely to time out, and improve diagnostics if
  tests do time out (fd.o #103009, Simon McVittie)

 On Windows, don't compile an unused stub implementation of
  _dbus_set_signal_handler() (fd.o #103010, Simon McVittie)

Fixes:

• Be more careful to save and restore errno in POSIX async signal
  handlers (fd.o #103010, Simon McVittie)

• On Windows, embed a manifest in dbus-update-activation-environment.exe
  so that the heuristics used for UAC do not assume it needs elevated
  privileges due to its name containing "update"
  (fd.o #102558, Ralf Habacker)

• On Windows with Automake, embed version information in libdbus-1,
  as was meant to happen in all versions since 2009
  (fd.o #103015, Simon McVittie)
589

Simon McVittie's avatar
Simon McVittie committed
590
D-Bus 1.11.18 (2017-09-25)
Simon McVittie's avatar
Simon McVittie committed
591 592
==

Simon McVittie's avatar
Simon McVittie committed
593 594
The “vampire conquistador” release.

595 596 597 598 599 600 601 602 603 604 605 606 607
Build-time configuration changes:

• By default, dbus-daemon on Unix no longer checks for flag files
  /var/run/console/${username} created by the obsolete pam_console and
  pam_foreground PAM modules when deciding whether ${username} is
  currently at the console. The old default behaviour can be restored
  by specifying --with-console-auth-dir=/var/run/console in the
  recommended Autotools build system, or
  -DDBUS_CONSOLE_AUTH_DIR=/var/run/console in CMake. This feature is
  now deprecated, and will be removed in dbus 1.13 unless feedback via
  fd.o #101629 indicates that this would be problematic.
  (fd.o #101629, Simon McVittie)

608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632
• LSB-style init scripts for Red Hat and Slackware, and a non-LSB init
  script for Cygwin, are no longer provided in the upstream dbus
  source. We recommend that distributors who support non-systemd service
  management should maintain their own init scripts or other service
  manager integration as part of their downstream packaging, similar to
  the way Debian distributes a Debian-specific LSB init script for dbus.

  The systemd unit continues to be maintained as part of the upstream
  dbus source, because it receives regular testing and maintenance.

  (fd.o #101706, Simon McVittie)

• The process ID file created by the system bus is no longer influenced
  by the --with-init-scripts=redhat configure option or the presence of
  /etc/redhat-release at build time. If your OS's init script or other
  service management relies on the Red Hat-style pid file, it can be
  restored by specifying --with-system-pid-file=/run/messagebus.pid at
  configure time or using the <pidfile> directive in bus configuration.

  Note that the upstream-supplied systemd unit runs dbus-daemon with
  the --nopidfile option, so it does not normally write a pid file,
  regardless of whether the OS is Red-Hat-derived or not.

  (fd.o #101706, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
633 634 635 636 637 638 639 640
Enhancements:

 <allow> and <deny> rules in dbus-daemon configuration can now
  include send_broadcast="true" or send_broadcast="false", which make
  the rule only match broadcast signals, or only match messages that
  are not broadcast signals, respectively.
  (fd.o #29853, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
641 642 643 644 645 646 647 648 649 650 651
 <allow> and <deny> rules can now be configured to apply only to
  messages with or without Unix file descriptors attached. This would
  typically be used in rules like these:
  <allow send_destination="..." max_unix_fds="0"/>
  <deny send_destination="..." min_unix_fds="1"/>
  <deny receive_sender="..." min_unix_fds="1"/>
  but can also be used to set a nonzero upper limit on the number of
  file descriptors:
  <allow send_destination="..." max_unix_fds="4"/>
  (fd.o #101848, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
652 653 654 655 656 657 658 659
 On Unix platforms, the DBUS_COOKIE_SHA1 authentication mechanism
  now respects the HOME environment variable on the client side, and
  on the server side when the uid attempting to connect is the same
  as the uid of the server. This allows the automated tests to pass in
  environments where the user's "official" home directory in /etc/passwd
  is nonexistent, such as Debian autobuilders.
  (fd.o #101960, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
660 661 662 663 664 665 666 667 668 669
Fixes:

• When parsing dbus-daemon configuration, tell Expat not to use
  cryptographic-quality entropy as a salt for its hash tables: we trust
  the configuration files, so we are not concerned about algorithmic
  complexity attacks via hash table collisions. This prevents
  dbus-daemon --system from holding up the boot process (and causing
  early-boot system services like systemd, logind, networkd to time
  out) on entropy-starved embedded systems.
  (fd.o #101858, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
670

Simon McVittie's avatar
Simon McVittie committed
671 672 673
• Avoid a -Werror=declaration-after-statement build failure on Solaris
  (fd.o #102145, Alan Coopersmith)

Simon McVittie's avatar
Simon McVittie committed
674 675 676 677
• On Unix platform, drop DBUS_SYSTEM_LOG_INFO messages from LOG_NOTICE
  to LOG_INFO, matching how we use this log level in practice
  (fd.o #102686, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
678
D-Bus 1.11.16 (2017-07-27)
679 680
==

Simon McVittie's avatar
Simon McVittie committed
681 682
The “south facing garden” release.

Simon McVittie's avatar
Simon McVittie committed
683 684 685 686 687 688 689 690
Build-time configuration changes:

• The Autotools build system now supports varying ${runstatedir}
  independently of ${localstatedir}, if using an Autoconf version
  that has that feature; version 2.70 will eventually have this, but
  many Linux distributions add it to version 2.69 as a patch.
  A typical use is to set prefix=/usr, sysconfdir=/etc, localstatedir=/var
  and runstatedir=/run. (fd.o #101569, Simon McVittie)
691

692 693 694 695 696 697 698 699 700 701
Enhancements:

• New APIs DBUS_MESSAGE_ITER_INIT_CLOSED, dbus_message_iter_init_closed()
  and dbus_message_iter_abandon_container_if_open() simplify the
  single-exit-point ("goto out") style of resource cleanup. The API
  documentation around DBusMessageIter and containers has also been
  clarified. (fd.o #101568, Simon McVittie)

Fixes:

Simon McVittie's avatar
Simon McVittie committed
702 703 704 705
• Fix the implementation of re-enabling a timeout (again) so that its
  countdown is always restarted as intended. (fd.o #95619,
  Michal Koutný)

706 707 708
• Make the dbus-daemon's Properties interface, as introduced in 1.11.14,
  available to all users on the system bus (fd.o #101700, Simon McVittie)

709 710 711 712 713 714 715 716 717 718 719 720 721 722 723
 dbus_message_iter_append_basic() no longer leaks memory if it fails to
  append a file descriptor to a message. (fd.o #101568, Simon McVittie)

 dbus_message_iter_open_container() no longer leaks memory if it runs out
  of memory. (fd.o #101568, Simon McVittie)

 dbus_message_append_args_valist() no longer leaks memory if given an
  unsupported type. This situation is still considered to be a programming
  error which needs to be corrected by the user of libdbus.
  (fd.o #101568, Simon McVittie)

 dbus_message_iter_append_basic() and dbus_message_iter_open_container()
  will no longer report that their arguments were invalid if they run out
  of memory at exactly the wrong time. (fd.o #101568, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
724 725 726
 Ensure that tests fail if they would otherwise have tried to connect to
  the real session bus (fd.o #101698, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
727 728 729
 Make build-time tests cope with finding Python 3, but not Python 2
  (fd.o #101716, Simon McVittie)

730 731 732 733 734 735 736 737 738 739 740 741
Internal changes relevant to dbus developers:

 DBusVariant is a new mechanism to copy single values from a message into
  a buffer without copying the entire message (fd.o #101568, Simon McVittie)

 DBUS_SYSTEM_LOG_FATAL has been replaced by DBUS_SYSTEM_LOG_ERROR.
  Logging an ERROR message does not make the process exit; the caller
  is responsible for calling abort() or exit(), whichever is more appropriate.
  (fd.o #101568, Simon McVittie)

 Better test coverage (fd.o #101568, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
742
D-Bus 1.11.14 (2017-06-29)
Simon McVittie's avatar
Simon McVittie committed
743 744
==

Simon McVittie's avatar
Simon McVittie committed
745 746
The irrational fear of bees release.

Simon McVittie's avatar
Simon McVittie committed
747 748
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
749 750 751
 Expat >= 2.1.0 is always required
 libselinux >= 2.0.86 is required if SELinux support is enabled
 GLib >= 2.40 is required if full test coverage is enabled
Simon McVittie's avatar
Simon McVittie committed
752

Simon McVittie's avatar
Simon McVittie committed
753 754 755 756 757 758 759 760 761 762 763 764 765 766
Build-time configuration changes:

 We now use pkg-config to find libexpat in Autotools builds. This requires
  Expat 2.1.0 (March 2012) or later. In particular, this should remove the
  need to configure with LDFLAGS=-L/usr/local/lib on OpenBSD, which can
  itself cause compilation failures.

  As with all pkg-config-based configure checks, you can use
  PKG_CONFIG_PATH=/whatever/lib/pkgconfig to find expat.pc in a
  non-standard prefix, or EXPAT_CFLAGS="-I/whatever/include" and
  EXPAT_LIBS="-L/whatever/lib -lexpat" to avoid needing a .pc file
  at all.

  (fd.o #69801, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
767

Simon McVittie's avatar
Simon McVittie committed
768 769 770
 Similarly, we now use pkg-config to find libselinux. Version 2.0.86
  is required due to the removal of explicit refcounting for SIDs.
  (fd.o #100912, Laurent Bigonville)
Simon McVittie's avatar
Simon McVittie committed
771

Simon McVittie's avatar
Simon McVittie committed
772 773 774 775 776 777 778 779 780 781 782 783 784 785 786
Behaviour changes:

 Previously, /etc/machine-id could be copied to /var/lib/dbus/machine-id
  as a side-effect of a sufficiently privileged process merely reading the
  machine ID. It is no longer copied as a side-effect of reading.
  Running dbus-uuidgen --ensure, which should be done after installing dbus,
  continues to copy /etc/machine-id to /var/lib/dbus/machine-id if the
  former exists and the latter does not.
  (fd.o #101257, Simon McVittie)

 The undocumented Verbose interface, and the GetAllMatchRules method on
  the undocumented Stats interface, must now be used via the object path
  /org/freedesktop/DBus. Previously, they existed on all object paths.
  (fd.o #101257, Simon McVittie)

787 788 789 790 791 792 793
 AddMatch() with a match rule containing eavesdrop='true' will now fail
  unless called by either the same user as the dbus-daemon, or Unix uid 0
  (root), matching the restrictions applied to the newer BecomeMonitor()
  method. On the session bus this has no practical effect. On the system
  bus this will prevent certain configurations that already did not
  work well in practice. (fd.o #101567, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
794 795 796 797 798 799 800
Enhancements:

 D-Bus Specification version 0.31
  · Don't require implementation-specific search paths to be lowest
    priority
  · Correct regex syntax for optionally-escaped bytes in addresses so it
    includes hyphen-minus, forward slash and underscore as intended
Simon McVittie's avatar
Simon McVittie committed
801
  · Describe all message bus methods in the same section
Simon McVittie's avatar
Simon McVittie committed
802
  · Clarify the correct object path for method calls to the message bus
Simon McVittie's avatar
Simon McVittie committed
803 804 805 806 807
    (/org/freedesktop/DBus, DBUS_PATH_DBUS in the reference implementation)
  · Document that the message bus implements Introspectable, Peer and
    Properties
  · Add new Features and Interfaces properties for message bus
    feature-discovery
Simon McVittie's avatar
Simon McVittie committed
808 809
  · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
    abstract sockets
810 811 812
  · Don't require eavesdrop='true' to be accepted from connections not
    sufficiently privileged to use it successfully
  · Formally deprecate eavesdropping in favour of BecomeMonitor
Simon McVittie's avatar
Simon McVittie committed
813
  (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
Simon McVittie's avatar
Simon McVittie committed
814 815 816 817
  Simon McVittie, Tom Gundersen)

 Implement the Properties and Peer interfaces in dbus-daemon
  (fd.o #101257, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
818

Simon McVittie's avatar
Simon McVittie committed
819 820 821
 New function dbus_try_get_local_machine_id() is like
  dbus_get_local_machine_id(), but returning a DBusError. Other code
  that needs the machine ID will now report a recoverable error (instead
Simon McVittie's avatar
Simon McVittie committed
822 823 824
  of logging to stderr and aborting) if no machine ID is available.
  Generating a machine ID is still considered to be a required part of
  installing dbus correctly. (fd.o #13194, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
825

Simon McVittie's avatar
Simon McVittie committed
826 827 828
 Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
  (fd.o #101315, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
829 830 831
 Avoid deprecated API calls when using SELinux
  (fd.o #100912, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
832 833 834 835
 Switch a test from the deprecated g_test_trap_fork() to
  g_test_trap_subprocess(), for Windows support and better robustness
  on Unix (fd.o #101362, Simon McVittie)

836 837 838 839 840 841 842
 On systemd systems, if ${localstatedir}/dbus/machine-id doesn't exist,
  instruct systemd-tmpfiles to make it a symbolic link to /etc/machine-id.
  This prevents the two files from going out of sync on stateless or live
  images without needing to run dbus-uuidgen, and supports older D-Bus
  implementations that do not necessarily read /etc/machine-id themselves.
  (fd.o #101570, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
843 844 845 846
• Implement unix:dir=..., which resembles unix:tmpdir=... but never uses
  abstract sockets. This is preferable when used with Linux containers.
  (fd.o #101567, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
847 848
Fixes:

849 850 851
• Fix a reference leak when blocking on a pending call on a connection
  that has been disconnected (fd.o #101481, Shin-ichi MORITA)

Simon McVittie's avatar
Simon McVittie committed
852 853 854
• Don't put timestamps in the Doxygen-generated documentation,
  or hard-code the build directory into builds with embedded tests,
  for reproducible builds (fd.o #100692, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
855 856 857

 Fix some integration test issues (fd.o #100686, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
858 859 860 861 862 863
 Fix memory leaks in the tests (fd.o #101257, Simon McVittie)

 If we somehow get an autolaunch address with multiple semicolon-separated
  components, and they don't work, don't invalidly "pile up" errors
  (fd.o #101257, Simon McVittie)

864 865 866 867
Documentation:

 Update git URIs in HACKING document to sync up with cgit.freedesktop.org
  (fd.o #100715, Simon McVittie)
868

Simon McVittie's avatar
Simon McVittie committed
869
D-Bus 1.11.12 (2017-04-07)
Simon McVittie's avatar
Simon McVittie committed
870 871
==

Simon McVittie's avatar
Simon McVittie committed
872 873
The it's something humans do” release.

Simon McVittie's avatar
Simon McVittie committed
874 875 876 877 878 879 880 881
Enhancements:

• The session dbus-daemon now supports transient .service files
  in $XDG_RUNTIME_DIR/dbus-1/services. Unlike the other standard
  service directories, this directory is not monitored with inotify
  or similar, and the service files must be named exactly
  ${bus_name}.service. (fd.o #99825, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900
• dbus can be configured with --enable-relocation when building with
  Autotools, or with -DDBUS_RELOCATABLE=ON when building with cmake,
  to make the pkg-config metadata relocatable. This is useful for
  non-standard prefixes, and in particular for Windows installations.
  However, it is not recommended for system-wide installations into
  /usr, because it interferes with pkg-config's ability to filter out
  compiler default linker directories.

  With Autotools, the default is --enable-relocation when building
  for Windows or --disable-relocation otherwise. With CMake, the default
  is -DDBUS_RELOCATABLE=ON.

  (fd.o #99721; Ralf Habacker, Simon McVittie)

 Users of CMake  2.6 can now link to libdbus without providing their
  own FindDBus.cmake macros, whether dbus was compiled with Autotools
  or with CMake. See the end of README.cmake for more information.
  (fd.o #99721; Ralf Habacker, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
901 902 903 904 905 906 907
Fixes:

 Always read service file directories in the intended order
  (fd.o #99825, Simon McVittie)

 When tests are skipped, don't try to kill nonexistent process 0
  (fd.o #99825, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
908

Simon McVittie's avatar
Simon McVittie committed
909 910
• Avoid valgrind false positives (fd.o #88808, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
911 912 913
• Fix a harmless read overflow and some memory leaks in a unit test
  (fd.o #100568, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
914 915 916
• Fix some typos in test code
  (fd.o #99999, Coverity #141876, #141877; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
917 918 919
• Clarify the roles of /etc/dbus-1/s*.d and /usr/share/dbus-1/s*.d
  in documentation (fd.o #99901, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
920
• Fix and enable compiler warnings related to -Wswitch
Simon McVittie's avatar
Simon McVittie committed
921 922
  (fd.o #98191; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
923 924 925
• Fix writing off the end of a fd_set when testing with valgrind
  (fd.o #99839, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
926
D-Bus 1.11.10 (2017-02-16)
Simon McVittie's avatar
Simon McVittie committed
927 928
==

Simon McVittie's avatar
Simon McVittie committed
929 930
The “purple hair gives you telekinesis?” release.

Simon McVittie's avatar
Simon McVittie committed
931 932 933 934 935 936 937 938 939 940
Dependencies:

• AppArmor support requires at least libapparmor 2.8.95, reduced
  from 2.10 in previous versions. One test requires 2.10 and is
  skipped if building with an older version.

Enhancements:

• Do the Travis-CI build in Docker containers for Ubuntu LTS, Debian
  stable and Debian testing in addition to the older Ubuntu that is
Simon McVittie's avatar
Simon McVittie committed
941
  the default (fd.o #98889, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
942

Simon McVittie's avatar
Simon McVittie committed
943
• Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
944 945 946 947

• Silence many -Wswitch-enum and -Wswitch-default warnings
  (fd.o #98191; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
948 949 950 951 952 953 954 955 956 957
• Install a sysusers.d snippet so `dbus-daemon --system` can be used
  with an unpopulated /etc (fd.o #99162, Lennart Poettering)

• Install pkg-config metadata on Unix even if building with CMake
  (fd.o #99752, Ralf Habacker)

• Exclude auth mechanisms from REJECTED message if they are supported
  in the code but but configured to be disallowed (fd.o #99621,
  Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
958 959
Fixes:

Simon McVittie's avatar
Simon McVittie committed
960 961 962 963 964 965 966 967 968
• Prevent symlink attacks in the nonce-tcp transport on Unix that could
  allow an attacker to overwrite a file named "nonce", in a directory
  that the user running dbus-daemon can write, with a random value
  known only to the user running dbus-daemon. This is unlikely to be
  exploitable in practice, particularly since the nonce-tcp transport
  is really only useful on Windows.

  On Unix systems we strongly recommend using only the unix: and systemd:
  transports, together with EXTERNAL authentication. These are the only
Simon McVittie's avatar
Simon McVittie committed
969
  transports and authentication mechanisms enabled by default.
Simon McVittie's avatar
Simon McVittie committed
970 971 972 973 974 975

  (fd.o #99828, Simon McVittie)

• Avoid symlink attacks in the "embedded tests", which are not enabled
  by default and should never be enabled in production builds of dbus.
  (fd.o #99828, Simon McVittie)
976

Simon McVittie's avatar
Simon McVittie committed
977 978 979 980 981 982 983 984 985 986 987 988 989 990
• Fix the implementation of re-enabling a timeout so that its
  countdown is restarted as intended, instead of continually
  decreasing. (fd.o #95619; Michal Koutný, Simon McVittie)

• When receiving a message with file descriptors, do not start reading
  the beginning of the next message, so that only one such message
  is processed at a time. In conjunction with the fix for #95619
  this means that processes sending many file descriptors, such as
  systemd-logind on a system that receives very rapid ssh connections,
  are not treated as abusive and kicked off the bus. Revert the previous
  workaround that special-cased uid 0.
  (fd.o #95263, LP#1591411; Simon McVittie)

• Do not require TMPDIR, TEMP or TMP to be set when cross-compiling
Simon McVittie's avatar
Simon McVittie committed
991
  for Windows with CMake (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
992 993

• Do not set Unix-specific variables when targeting Windows
Simon McVittie's avatar
Simon McVittie committed
994
  (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
995

Simon McVittie's avatar
Simon McVittie committed
996 997 998
• Install Unix executables to ${CMAKE_INSTALL_PREFIX}/bin as intended,
  not ${CMAKE_INSTALL_PREFIX}/lib (fd.o #99752, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
999 1000
• Use relative install locations in CMake on Unix to respect DESTDIR,
  and use GNU-style install layout (fd.o #99721, #99752; Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1001

Simon McVittie's avatar
Simon McVittie committed
1002
• Install dbus-arch-deps.h correctly when using CMake
Simon McVittie's avatar
Simon McVittie committed
1003
  (fd.o #99586, #99721; Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1004

Simon McVittie's avatar
Simon McVittie committed
1005 1006 1007
• Improve argument validation for `dbus-test-tool spam`
  (ffd.o #99693, Coverity #54759; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1008 1009 1010
• Don't shift by a negative integer if a hash table becomes monstrously
  large (fd.o #99641, Coverity #54682; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1011 1012 1013 1014 1015 1016
 Don't leak LSM label if dbus-daemon runs out of memory when dealing with
  a new connection (fd.o #99612, Coverity #141058; Philip Withnall)

• Remove an unnecessary NULL check
  (fd.o #99642, Coverity #141062; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1017
• Improve error handling in unit tests and dbus-send
Simon McVittie's avatar
Simon McVittie committed
1018 1019 1020 1021
  (fd.o #99643, #99694, #99712, #99722, #99723, #99724, #99758,
  #99759, #99793, Coverity #54688, #54692, #54693, #54697, #54701,
  #54710, #54711, #54714, #54715, #54718, #54721, #54724, #54726,
  #54730, #54740, #54822, #54823, #54824, #54825; Philip Withnall)
Simon McVittie's avatar
Simon McVittie committed
1022 1023 1024 1025

• Do not print verbose messages' timestamps to stderr if the actual message
  has been redirected to the Windows debug port (fd.o #99749, Ralf Habacker)

1026
D-Bus 1.11.8 (2016-11-28)
Simon McVittie's avatar
Simon McVittie committed
1027 1028
==

1029 1030
The panics in the face of breakfast foods release.

Simon McVittie's avatar
Simon McVittie committed
1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043
Build-time configuration:

 The new --enable-debug configure option provides an easy way to
  enable debug symbols, disable optimization and/or enable profiling.

 The --enable-compile-warnings configure option can be used to control
  compiler warnings.

 The --disable-compiler-optimisations configure option is no longer
  supported. Use --enable-debug=yes or CFLAGS=-O0 instead.

Enhancements:

Simon McVittie's avatar
Simon McVittie committed
1044 1045 1046 1047 1048
 D-Bus Specification version 0.30
  · Define the jargon term "activation" more clearly
  · Define the jargon term "auto-starting", which is one form of activation
  · Document the optional SystemdService key in service files
  · Use versioned interface and bus names in most examples
Simon McVittie's avatar
Simon McVittie committed
1049 1050
  · Clarify intended behaviour of Properties.GetAll
  (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1051

Simon McVittie's avatar
Simon McVittie committed
1052 1053 1054
 Fix and enable a lot of compiler warnings to improve future code
  quality. This might incidentally also fix some environment variable
  accesses on OS X.
1055 1056 1057 1058
  · In particular, printf-style functions in the libdbus API are now annotated
    with __attribute__((__format__(__printf__, *, *))) when compiling with
    gcc or clang. This might make printf bugs in other software visible
    at compile time.
Simon McVittie's avatar
Simon McVittie committed
1059 1060 1061
  (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
  Thomas Zimmermann, Simon McVittie)

1062 1063 1064 1065 1066 1067 1068
 When running with AppArmor mediation (for example using Ubuntu's patched
  Linux kernel), clients can no longer auto-start services unless they would
  have been able to send the auto-starting message to the service after it
  starts. StartServiceByName() is unaffected, and continues to be allowed by
  default in AppArmor's <abstractions/dbus-strict> and
  <abstractions/dbus-session-strict>. (fd.o #98666, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079
Fixes:

 Work around an undesired effect of the fix for CVE-2014-3637
  (fd.o #80559), in which processes that frequently send fds, such as
  logind during a flood of new PAM sessions, can get disconnected for
  continuously having at least one fd "in flight" for too long;
  dbus-daemon interprets that as a potential denial of service attack.
  The workaround is to disable that check for uid 0 process such as
  logind, with a message in the system log. The bug remains open while
  we look for a more general solution.
  (fd.o #95263, LP#1591411; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1080

Simon McVittie's avatar
Simon McVittie committed
1081 1082 1083 1084
 Don't run the test test-dbus-launch-x11.sh if X11 autolaunching
  was disabled at compile time. That test is not expected to work
  in that configuration. (fd.o #98665, Simon McVittie)

1085
D-Bus 1.11.6 (2016-10-10)
Simon McVittie's avatar
Simon McVittie committed
1086 1087
==

1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105
The “darkly whimsical” release.

Security fixes:

• Do not treat ActivationFailure message received from root-owned systemd
  name as a format string. In principle this is a security vulnerability,
  but we do not believe it is exploitable in practice, because only
  privileged processes can own the org.freedesktop.systemd1 bus name, and
  systemd does not appear to send activation failures that contain "%".

  Please note that this probably *was* exploitable in dbus versions
  older than 1.6.30, 1.8.16 and 1.9.10 due to a missing check which at
  the time was only thought to be a denial of service vulnerability
  (CVE-2015-0245). If you are still running one of those versions,
  patch or upgrade immediately.

  (fd.o #98157, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119
Enhancements:

• D-Bus Specification version 0.29
  · Recommend not using '/' for object paths (fd.o #37095, Philip Withnall)
  · Allow <annotation> in <arg> elements (fd.o #86162, Philip Withnall)

• Log to syslog when we exceed various anti-DoS limits, and add test
  coverage for them (fd.o #86442, Simon McVittie)

• Improve syslog handling so that _dbus_warn() and similar warnings
  go to syslog, add dbus-daemon --syslog|--nosyslog|--syslog-only options,
  and log to syslog (instead of /dev/null) when dbus-daemon is started by
  dbus-launch. (fd.o #97009, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1120 1121 1122
• Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
  (fd.o #89011, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1123 1124 1125 1126 1127 1128
• When logging messages about service activation, mention which peer
  requested the activation (fd.o #68212, Philip Withnall)

• On Linux, mention the LSM label (if available) whenever we print
  debug information about a peer (fd.o #68212, Philip Withnall)

1129 1130 1131 1132 1133 1134
Other fixes:

• Harden dbus-daemon against malicious or incorrect ActivationFailure
  messages by rejecting them if they do not come from a privileged
  process, or if systemd activation is not enabled
  (fd.o #98157, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1135

Simon McVittie's avatar
Simon McVittie committed
1136 1137 1138
• Avoid undefined behaviour when setting reply serial number without going
  via union DBusBasicValue (fd.o #98035, Marc Mutz)

Simon McVittie's avatar
Simon McVittie committed
1139 1140 1141 1142
• Fix CMake build for Unix platforms that do not have -lrt, such as Android,
  or that do need -lsocket, such as QNX (fd.o #94096, Ralf Habacker)

• autogen.sh: fail cleanly if autoconf fails (Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1143

Simon McVittie's avatar
Simon McVittie committed
1144
D-Bus 1.11.4 (2016-08-15)
Simon McVittie's avatar
Simon McVittie committed
1145 1146
==

Simon McVittie's avatar
Simon McVittie committed
1147 1148
The “copper pickaxe” release.

1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159
Dependencies:

• Building from git (but not from tarballs) now requires
  macros from the GNU Autoconf Archive, for example the autoconf-archive
  package in Debian or Fedora derivatives.

Build-time configuration:

• The option to enable coverage instrumentation has changed from
  --enable-compiler-coverage to --enable-code-coverage.

Simon McVittie's avatar
Simon McVittie committed
1160 1161 1162 1163 1164 1165 1166 1167 1168
Enhancements:

• D-Bus Specification version 0.28
  · Clarify some details of serialization (fd.o #93382, Philip Withnall)

• Increase listen() backlog of AF_UNIX sockets to the maximum possible,
  minimizing failed connections under heavy load
  (fd.o #95264, Lennart Poettering)

Simon McVittie's avatar
Simon McVittie committed
1169 1170
• Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1171 1172 1173 1174 1175 1176
• Use the same regression tests for subprocess starting on Unix and Windows
  (fd.o #95191, Ralf Habacker)

• Print timestamps and thread IDs in verbose messages
  (fd.o #95191, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1177 1178 1179
• On Unix, unify the various places that reopen stdin, stdout and/or stderr
  pointing to /dev/null (fd.o #97008, Simon McVittie)

1180 1181 1182
• Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
  (fd.o #88922, Thomas Zimmermann)

Simon McVittie's avatar
Simon McVittie committed
1183 1184
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1185 1186 1187
• On Windows, fix a memory leak in replacing the installation prefix
  (fd.o #95191, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1188 1189 1190 1191
• On Linux, when dbus-daemon is run with reduced susceptibility to the
  OOM killer (typically via systemd), do not let child processes inherit
  that setting (fd.o #32851; Kimmo Hämäläinen, WaLyong Cho)

Simon McVittie's avatar
Simon McVittie committed
1192 1193 1194 1195
• On Unix, make dbus-launch and dbus-daemon --fork work as intended
  even if a parent process incorrectly starts them with stdin, stdout
  and/or stderr closed (fd.o #97008, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206
• Output valid shell syntax in ~/.dbus/session-bus/ if the bus address
  contains a semicolon (fd.o #94746, Thiago Macieira)

• Fix memory leaks and thread safety in subprocess starting on Windows
  (fd.o #95191, Ralf Habacker)

• Stop test-dbus-daemon incorrectly failing on platforms that cannot
  discover the process ID of clients (fd.o #96653, Руслан Ижбулатов)

• In tests that exercise correct handling of crashing D-Bus services,
  suppress Windows crash handler (fd.o #95155; Yiyang Fei, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1207

Simon McVittie's avatar
Simon McVittie committed
1208 1209
• Explicitly check for stdint.h (Ioan-Adrian Ratiu)

Simon McVittie's avatar
Simon McVittie committed
1210 1211 1212 1213 1214 1215 1216 1217 1218
• In tests, add an invalid DBusAuthState to avoid undefined behaviour
  in some test cases (fd.o #93909, Nick Lewycky)

• Add assertions to reassure a static analysis tool
  (fd.o #93210, Deepika Aggarwal)

• Be explicit about enum comparison when loading XML
  (fd.o #93205, Deepika Aggarwal)

Simon McVittie's avatar
Simon McVittie committed
1219 1220 1221
• update-activation-environment: produce better diagnostics on error
  (fd.o #96653, Simon McVittie)

1222
• Avoid various compiler warnings with gcc 6
Simon McVittie's avatar
Simon McVittie committed
1223 1224
  (fd.o #97282; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1225 1226 1227 1228 1229 1230
• On Unix when configured to use the system log, report as "dbus-daemon",
  not as "dbus" (fd.o #97009, Simon McVittie)

• During unit tests, reduce the amount we write to the system log
  (fd.o #97009, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1231
D-Bus 1.11.2 (2016-03-07)
Simon McVittie's avatar
Simon McVittie committed
1232 1233
==

Simon McVittie's avatar
Simon McVittie committed
1234 1235
The “pneumatic drill vs. Iron Maiden” release.

Simon McVittie's avatar
Simon McVittie committed
1236 1237 1238 1239 1240 1241
Fixes:

• Enable "large file support" on systems where it exists: dbus-daemon
  is not expected to open large files, but it might need to stat files
  that happen to have large inode numbers (fd.o #93545, Hongxu Jia)

Simon McVittie's avatar
Simon McVittie committed
1242 1243 1244 1245 1246 1247 1248 1249
• Eliminate padding inside DBusMessageIter on 64-bit platforms,
  which might result in a pedantic C compiler not copying the entire contents
  of a DBusMessageIter; statically assert that this is not an ABI change
  in practice (fd.o #94136, Simon McVittie)

• Document dbus-test-tool echo --sleep-ms=N instead of incorrect --sleep=N
  (fd.o #94244, Dmitri Iouchtchenko)

Simon McVittie's avatar
Simon McVittie committed
1250 1251 1252 1253 1254 1255 1256 1257
• Correctly report test failures in C tests from run-test.sh
  (fd.o #93379; amit tewari, Simon McVittie)

• When tests are enabled, run all the marshal-validate tests, not just
  the even-numbered ones (fd.o #93908, Nick Lewycky)

• Correct the expected error from one marshal-validate test, which was
  previously not run due to the above bug (fd.o #93908, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1258

Simon McVittie's avatar
Simon McVittie committed
1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282
• Fix compilation under CMake when embedded tests are disabled
  (fd.o #94094, eric.hyer)

Internal changes:

• Fix all -Wpointer-sign (signed/unsigned mismatch) warnings, and enable the
  warning (fd.o #93069; Ralf Habacker, Simon McVittie)

• When building with CMake, use the same gcc/clang warnings as under Autotools,
  or MSVC warnings that are broadly similar (fd.o #93069, Ralf Habacker)

• test/name-test: make C tests produce TAP output and run them directly, not
  via run-test.sh (fd.o #92899, Simon McVittie)

• Under CMake when cross-compiling for Windows on Unix, run the tests
  under Wine even if binfmt_misc support is not available
  (fd.o #88966, Ralf Habacker)

• The DBUS_USE_TEST_BINARY environment variable is no longer used by builds with
  embedded tests; DBUS_TEST_DBUS_LAUNCH replaces it (fd.o #92899, Simon McVittie)

• Factor out some functions that will be needed in future for a Windows
  implementation of dbus-run-session (fd.o #92899, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1283
D-Bus 1.11.0 (2015-12-02)
Simon McVittie's avatar
Simon McVittie committed
1284 1285
==

Simon McVittie's avatar
Simon McVittie committed
1286 1287
The “peppermint deer” release.

Simon McVittie's avatar
Simon McVittie committed
1288 1289
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1290
• On non-Windows platforms, dbus now requires an <inttypes.h> that defines
Simon McVittie's avatar
Simon McVittie committed
1291 1292
  C99 constants such as PRId64 and PRIu64.

1293 1294 1295 1296 1297 1298
Enhancements:

• D-Bus Specification version 0.27
  · Specify that services should not reply if NO_REPLY_EXPECTED was used
    (fd.o #75749, Lars Uebernickel)

Simon McVittie's avatar
Simon McVittie committed
1299 1300 1301 1302 1303 1304 1305 1306
• Add a script to do continuous-integration builds, and metadata to run it
  on travis-ci.org. To use this, clone the dbus git repository on GitHub
  and set it up with travis-ci.org; the only special setting needed is
  "only build branches with a .travis.yml". (fd.o #93194, Simon McVittie)

• If dbus-daemon is run with --systemd-activation, do not require
  org.freedesktop.systemd1.service to exist (fd.o #93194, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1307 1308
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1309 1310 1311 1312
• Re-order dbus-daemon startup so that on SELinux systems, the thread
  that reads AVC notifications retains the ability to write to the
  audit log (fd.o #92832, Laurent Bigonville)

1313 1314
• Print 64-bit integers on non-GNU Unix platforms (fd.o #92043, Natanael Copa)

Simon McVittie's avatar
Simon McVittie committed
1315 1316 1317 1318 1319 1320 1321
• When using the Monitoring interface, match messages' destinations
  (fd.o #92074, Simon McVittie)

 On Linux with systemd, stop installing a reference to the obsolete
  dbus.target, and enable dbus.socket statically (fd.o #78412, #92402;
  Simon McVittie)

1322 1323 1324 1325
 On Windows, when including configuration files with <include> or
  <includedir>, apply the same relocation as for the Exec paths
  in .service files (fd.o #92028, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1326 1327
 Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)

1328
 Fix many -Wpointer-sign warnings (fd.o #93069, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1329

Simon McVittie's avatar
Simon McVittie committed
1330
D-Bus 1.10.6 (2015-12-01)
Simon McVittie's avatar
Simon McVittie committed
1331 1332
==

Simon McVittie's avatar
Simon McVittie committed
1333 1334
The marzipan beetles release.

Simon McVittie's avatar
Simon McVittie committed
1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347
Fixes:

 On Unix when running tests as root, don't assert that root and
  the dbus-daemon user can still call UpdateActivationEnvironment;
  assert that those privileged users can call BecomeMonitor instead
  (fd.o #93036, Simon McVittie)

• On Windows, fix a memory leak in the autolaunch transport (fd.o #92899,
  Simon McVittie)

• On Windows Autotools builds, don't run tests that rely on
  dbus-run-session and other Unix-specifics (fd.o #92899, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1348
D-Bus 1.10.4 (2015-11-17)
Simon McVittie's avatar
Simon McVittie committed
1349 1350
==

Simon McVittie's avatar
Simon McVittie committed
1351 1352
The Frostburn Canyon release.

Simon McVittie's avatar
Simon McVittie committed
1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374
Enhancements:

 GetConnectionCredentials, GetConnectionUnixUser and
  GetConnectionUnixProcessID with argument "org.freedesktop.DBus"
  will now return details of the dbus-daemon itself. This is required
  to be able to call SetEnvironment on systemd.
  (fd.o #92857, Jan Alexander Steffens)

Fixes:

 Make UpdateActivationEnvironment always fail with AccessDenied on the
  system bus. Previously, it was possible to configure it so root could
  call it, but the environment variables were not actually used,
  because the launch helper would discard them.
  (fd.o #92857, Jan Alexander Steffens)

 On Unix with --systemd-activation on a user bus, make
  UpdateActivationEnvironment pass on its arguments to systemd's
  SetEnvironment method, solving inconsistency between the environments
  used for traditional activation and systemd user-service activation.
  (fd.o #92857, Jan Alexander Steffens)

Simon McVittie's avatar
Simon McVittie committed
1375 1376 1377
• On Windows, don't crash if <syslog/> or --syslog is used
  (fd.o #92538, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1378 1379 1380 1381 1382 1383 1384
 On Windows, fix a memory leak when setting a DBusError from a Windows
  error (fd.o #92721, Ralf Habacker)

 On Windows, don't go into infinite recursion if we abort the process
  with backtraces enabled (fd.o #92721, Ralf Habacker)

• Fix various failing tests, variously on Windows and cross-platform:
Simon McVittie's avatar
Simon McVittie committed
1385 1386 1387 1388 1389 1390 1391 1392 1393
  · don't test system.conf features (users, groups) that only make sense
    on the system bus, which is not supported on Windows
  · don't call _dbus_warn() when we skip a test, since it is fatal
  · fix computation of expected <standard_session_servicedirs/>
  · when running TAP tests, translate newlines to Unix format, fixing
    cross-compiled tests under Wine on Linux
  · don't stress-test refcounting under Wine, where it's really slow
  · stop assuming that a message looped-back to the test will be received
    immediately
Simon McVittie's avatar
Simon McVittie committed
1394
  · skip some system bus tests on Windows since they make no sense there
Simon McVittie's avatar
Simon McVittie committed
1395
  (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1396

Simon McVittie's avatar
Simon McVittie committed
1397
D-Bus 1.10.2 (2015-10-26)
Simon McVittie's avatar
Simon McVittie committed
1398 1399
==

Simon McVittie's avatar
Simon McVittie committed
1400 1401
The “worst pies in London” release.

Simon McVittie's avatar
Simon McVittie committed
1402 1403
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1404 1405 1406 1407 1408
• Correct error handling for activation: if there are multiple attempts
  to activate the same service and it fails immediately, the first attempt
  would get the correct reply, but the rest would time out. We now send
  the same error reply to each attempt. (fd.o #92200, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1409 1410 1411 1412 1413
• If BecomeMonitor is called with a syntactically invalid match rule,
  don't crash with an assertion failure, fixing a regression in 1.9.10.
  This was not exploitable as a denial of service, because the check
  for a privileged user is done first. (fd.o #92298, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1414 1415 1416 1417
 On Linux with --enable-user-session, add the bus address to the
  environment of systemd services for better backwards compatibility
  (fd.o #92612, Jan Alexander Steffens)

Simon McVittie's avatar
Simon McVittie committed
1418 1419
 On Windows, fix the logic for replacing the installation prefix
  in service files' Exec lines (fd.o #83539; Milan Crha, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1420

Simon McVittie's avatar
Simon McVittie committed
1421 1422 1423 1424
• On Windows, if installed in the conventional layout with ${prefix}/etc
  and ${prefix}/share, use relative paths between bus configuration files
  to allow the tree to be relocated (fd.o #92028, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1425 1426 1427
• Make more of the regression tests pass in Windows builds (fd.o #92538,
  Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1428
D-Bus 1.10.0 (2015-08-25)
Simon McVittie's avatar
Simon McVittie committed
1429 1430
==

Simon McVittie's avatar
Simon McVittie committed
1431 1432 1433 1434 1435 1436 1437 1438 1439 1440
The “0x20” release.

This is a new stable branch, recommended for use in OS distributions.

Fixes since 1.9.20:

• distribute test/tap-test.sh.in, even if the tarball was built without
  tests enabled (fd.o #91684, Simon McVittie)
• work around a fd leak in libcap-ng < 0.7.7 (fd.o #91684, Simon McVittie)

1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483
Summary of major changes since 1.8.0:

• The basic setup for the well-known system and session buses is
  now done in read-only files in ${datadir} (normally /usr/share).
  See the NEWS entry for 1.9.18 for details.

• AppArmor integration has been merged, with features similar to the
  pre-existing SELinux integration. It is mostly compatible with the
  patches previously shipped by Ubuntu, with one significant change:
  Ubuntu's GetConnectionAppArmorSecurityContext method has been superseded
  by GetConnectionCredentials and was not included.

 The --enable-user-session configure option can be enabled
  by OS integrators intending to use systemd to provide a session bus
  per user (in effect, treating all concurrent graphical and non-graphical
  login sessions as one large session).

 The new listenable address mode "unix:runtime=yes" listens on
  $XDG_RUNTIME_DIR/bus, the same AF_UNIX socket used by the systemd
  user session. libdbus and "dbus-launch --autolaunch" will connect to
  this address by default. GLib  2.45.3 and sd-bus  209 have a
  matching default.

 All executables are now dynamically linked to libdbus-1.
  Previously, some executables, most notably dbus-daemon, were statically
  linked to a specially-compiled variant of libdbus. This results in
  various private functions in the _dbus namespace being exposed by the
  shared library. These are not API, and must not be used outside
  the dbus source tree.

 On platforms with ELF symbol versioning, all public symbols
  are versioned LIBDBUS_1_3.

New bus APIs:

 org.freedesktop.DBus.GetConnectionCredentials returns
  LinuxSecurityLabel where supported
 org.freedesktop.DBus.Monitoring interface (privileged)
  · BecomeMonitor method supersedes match rules with eavesdrop=true,
    which are now deprecated
 org.freedesktop.DBus.Stats interface (semi-privileged)
  · now enabled by default
  · new GetAllMatchRules method
1484 1485
 org.freedesktop.DBus.Verbose interface (not normally compiled)
  · toggles the effect of DBUS_VERBOSE
1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510

New executables:

 dbus-test-tool
 dbus-update-activation-environment

New optional dependencies:

 The systemd: pseudo-transport requires libsystemd or libsd-daemon
 Complete documentation requires Ducktype and yelp-tools
 Full test coverage requires GLib 2.36 and PyGI
 AppArmor integration requires libapparmor and optionally libaudit

Dependencies removed:

 dbus-glib

D-Bus 1.9.20 (2015-08-06)
==

The Remember Tomorrow release.

This is a release-candidate for D-Bus 1.10.0. OS distribution vendors
should test it.

Simon McVittie's avatar
Simon McVittie committed
1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522
Fixes:

 Don't second-guess what the ABI of poll() is, allowing it to be used
  on Integrity RTOS and other unusual platforms (fd.o #90314;
  Rolland Dudemaine, Simon McVittie)

• Don't duplicate audit subsystem integration if AppArmor and SELinux are
  both enabled (fd.o #89225, Simon McVittie)

 Log audit events for AppArmor/SELinux policy violations whenever
  we have CAP_AUDIT_WRITE, even if not the system bus
  (fd.o #83856, Laurent Bigonville)
Simon McVittie's avatar
Simon McVittie committed
1523

Simon McVittie's avatar
Simon McVittie committed
1524
D-Bus 1.9.18 (2015-07-21)
Simon McVittie's avatar
Simon McVittie committed
1525 1526
==

Simon McVittie's avatar
Simon McVittie committed
1527 1528
The Pirate Elite release.

Simon McVittie's avatar
Simon McVittie committed
1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553
Configuration changes:

 The basic setup for the well-known system and session buses is now done
  in read-only files in ${datadir}, moving a step closer to systems
  that can operate with an empty /etc directory. In increasing order
  of precedence:

  · ${datadir}/dbus-1/s*.conf now perform the basic setup such as setting
    the default message policies.
  · ${sysconfdir}/dbus-1/s*.conf are now optional. By default
    dbus still installs a trivial version of each, for documentation
    purposes; putting configuration directives in these files is deprecated.
  · ${datadir}/dbus-1/s*.d/ are now available for third-party software
    to install "drop-in" configuration snippets (any packages
    using those directories should explicitly depend on at least this
    version of dbus).
  · ${sysconfdir}/dbus-1/s*.d/ are also still available for sysadmins
    or third-party software to install "drop-in" configuration snippets
  · ${sysconfdir}/dbus-1/s*-local.conf are still available for sysadmins'
    overrides

  ${datadir} is normally /usr/share, ${sysconfdir} is normally /etc,
  and "s*" refers to either system or session as appropriate.

  (fd.o #89280, Dimitri John Ledkov)
Simon McVittie's avatar
Simon McVittie committed
1554

Simon McVittie's avatar
Simon McVittie committed
1555 1556 1557 1558
Fixes:

• Fix a memory leak when GetConnectionCredentials() succeeds
  (fd.o #91008, Jacek Bukarewicz)
Simon McVittie's avatar
Simon McVittie committed
1559

Simon McVittie's avatar
Simon McVittie committed
1560 1561
• Ensure that dbus-monitor does not reply to messages intended for others,
  resulting in its own disconnection (fd.o #90952, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1562

Simon McVittie's avatar
Simon McVittie committed
1563
D-Bus 1.9.16 (2015-05-14)
1564 1565
==

1566 1567 1568 1569 1570 1571 1572
The “titanium barns” release.

Dependencies:

• Automake 1.13 is now required when compiling from git or modifying
  the build system.

Simon McVittie's avatar
Simon McVittie committed
1573 1574 1575 1576 1577 1578 1579
Security hardening:

• On Unix platforms, change the default configuration for the session bus
  to only allow EXTERNAL authentication (secure kernel-mediated
  credentials-passing), as was already done for the system bus.

  This avoids falling back to DBUS_COOKIE_SHA1, which relies on strongly
Simon McVittie's avatar
Simon McVittie committed
1580
  unpredictable pseudo-random numbers.
Simon McVittie's avatar
Simon McVittie committed
1581 1582 1583 1584 1585 1586 1587 1588 1589

  If you are using D-Bus over the (unencrypted!) tcp: or nonce-tcp: transport,
  in conjunction with DBUS_COOKIE_SHA1 and a shared home directory using
  NFS or similar, you will need to reconfigure the session bus to accept
  DBUS_COOKIE_SHA1 by commenting out the <auth> element. This configuration
  is not recommended.

  (fd.o #90414, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1590 1591 1592 1593 1594 1595
• When asked for random numbers for DBUS_COOKIE_SHA1, the nonce-tcp:
  transport, UUIDs or any other reason, fail if we cannot obtain entropy
  (from /dev/urandom or CryptGenRandom()) or an out-of-memory condition
  occurs, instead of silently falling back to low-entropy pseudorandom
  numbers from rand(). (fd.o #90414; Simon McVittie, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606
Enhancements:

• Add dbus_message_iter_get_element_count()
  (fd.o #30350; Christian Dywan, Simon McVittie)

• Introduce new internal DBusSocket and DBusPollable types so we can
  stop treating the Windows SOCKET type as if it was int. DBusSocket
  is specifically a socket, cross-platform. DBusPollable is whatever
  _dbus_poll() can act on, i.e. a fd on Unix or a SOCKET on Windows.
  (fd.o #89444; Ralf Habacker, Simon McVittie)

1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618
• All regression tests now output TAP <https://testanything.org/>
  (fd.o #89846, Simon McVittie)

• Internal APIs consistently use signed values for timestamps
  (fd.o #18494, Peter McCurdy)

• Improve diagnostics when UpdateActivationEnvironment calls are rejected
  (fd.o #88812, Simon McVittie)

• Clean up a lot of compiler warnings
  (fd.o #17289, fd.o #89284; Ralf Habacker, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1619 1620 1621 1622 1623 1624 1625 1626 1627
Fixes:

• Add locking to DBusCounter's reference count and notify function
  (fd.o #89297, Adrian Szyndela)

 Ensure that DBusTransport's reference count is protected by the
  corresponding DBusConnection's lock (fd.o #90312, Adrian Szyndela)

 Correctly release DBusServer mutex before early-return if we run out
1628
  of memory while copying authentication mechanisms (fd.o #90021,
Simon McVittie's avatar
Simon McVittie committed
1629 1630
  Ralf Habacker)

1631
 Make dbus-test-tool and dbus-update-activation-environment portable
Simon McVittie's avatar
Simon McVittie committed
1632 1633
  to Windows (fd.o #90089, Ralf Habacker)

1634 1635
 Correctly initialize all fields of DBusTypeReader (fd.o #90021;
  Ralf Habacker, Simon McVittie)
1636

Simon McVittie's avatar
Simon McVittie committed
1637 1638 1639
 Fix some missing \n in verbose (debug log) messages (fd.o #90004,
  Ralf Habacker)

1640
 Clean up some memory and fd leaks in test code and tools
Simon McVittie's avatar
Simon McVittie committed
1641
  (fd.o #90021, Ralf Habacker)
1642

1643 1644 1645 1646 1647 1648
 Fix a NULL dereference if the dbus-daemon cannot read a configuration
  directory for a reason that is not ENOENT (fd.o #90021, Ralf Habacker)

 CMake generates a versioned shared library even if the revision is 0,
  as it usually is on the development branch. (fd.o #89450, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1649
D-Bus 1.9.14 (2015-03-02)
Simon McVittie's avatar
Simon McVittie committed
1650 1651
==

Simon McVittie's avatar
Simon McVittie committed
1652 1653
The don't stand in the poison cloud” release.

Simon McVittie's avatar
Simon McVittie committed
1654 1655 1656 1657 1658
Dependencies:

• dbus-daemon and dbus-daemon-launch-helper now require libdbus. They
  were previously linked to a static version of libdbus.

Simon McVittie's avatar
Simon McVittie committed
1659 1660 1661 1662 1663 1664 1665 1666 1667 1668
• The tests no longer require dbus-glib in order to exercise the libdbus
  shared library; they are always linked to libdbus now.

Build-time configuration:

• The new --enable-user-session option, off by default, can be enabled
  by OS integrators intending to use systemd to provide a session bus
  per user (in effect, treating all concurrent graphical and non-graphical
  login sessions as one large session)

Simon McVittie's avatar
Simon McVittie committed
1669 1670 1671 1672 1673 1674 1675 1676 1677 1678
Enhancements:

• All executables are now linked dynamically to libdbus.
  (fd.o #83115; Bertrand SIMONNET, Simon McVittie, Ralf Habacker)

• On platforms that support them (GNU libc and possibly others),
  libdbus now has versioned symbols for its public API.
  All public symbols (visible in the header files) are currently
  versioned as LIBDBUS_1_3; private symbols starting with _dbus or
  dbus_internal have a version that changes with each release, and
Simon McVittie's avatar
Simon McVittie committed
1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696
  must not be used by applications. (also fd.o #83115)

• New listenable address mode "unix:runtime=yes" which listens on
  a real filesystem (non-abstract) socket $XDG_RUNTIME_DIR/bus
  (fd.o #61303; Colin Walters, Alexander Larsson, Simon McVittie)

• Add optional systemd units for a per-user bus listening on
  $XDG_RUNTIME_DIR/bus (fd.o #61301; Simon McVittie, Colin Walters)

• On Unix platforms, both libdbus and "dbus-launch --autolaunch"
  default to connecting to $XDG_RUNTIME_DIR/bus if it is a socket
  (also fd.o #61301)

• New dbus-update-activation-environment tool uploads environment
  variables to "dbus-daemon --session" and optionally "systemd --user",
  primarily as a way to keep the per-user bus compatible with
  distributions' existing X11 login scripts (also fd.o #61301)

Simon McVittie's avatar
Simon McVittie committed
1697 1698 1699
 <includedir/> elements in dbus-daemon configuration are now silently
  ignored if the directory does not exist. (fd.o #89280, Dimitri John Ledkov)

Simon McVittie's avatar
Simon McVittie committed
1700 1701
 Add microsecond-resolution timestamps to the default output of
  dbus-monitor and dbus-send (fd.o #88896; Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1702

Simon McVittie's avatar
Simon McVittie committed
1703 1704 1705 1706 1707
Fixes:

 Fix a race condition in the 'monitor' test introduced in 1.9.10
  (fd.o #89222, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1708
D-Bus 1.9.12 (2015-02-19)
Simon McVittie's avatar
Simon McVittie committed
1709 1710
==

Simon McVittie's avatar
Simon McVittie committed
1711 1712 1713 1714
The monster lasagna release.

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1715 1716
 Ducktype and yelp-tools are now required to build complete documentation
  (they are optional for normal builds).
Simon McVittie's avatar
Simon McVittie committed
1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755

Enhancements:

 D-Bus Specification version 0.26
  · GetConnectionCredentials can return LinuxSecurityLabel or WindowsSID
  · document the BecomeMonitor method

 On Linux, add LinuxSecurityLabel to GetConnectionCredentials
  (fd.o #89041; Tyler Hicks, Simon McVittie)

 On Linux, add support for AppArmor mediation of message sending and
  receiving and name ownership (paralleling existing SELinux mediation
  support), and eavesdropping (a new check, currently AppArmor-specific)
  (fd.o #75113; John Johansen, Tyler Hicks, Simon McVittie)

 In dbus-send and dbus-monitor, pretty-print \0-terminated bytestrings
  that have printable ASCII contents; we previously only did this for
  unterminated bytestrings (fd.o #89109, Simon McVittie)

 Add a guide to designing good D-Bus APIs (fd.o #88994, Philip Withnall)

 On Windows, add WindowsSID to GetConnectionCredentials
  (fd.o #54445, Ralf Habacker)

 Improve clarity of dbus-monitor --profile output and add more columns
  (fd.o #89165, Ralf Habacker)

 Add a man page for dbus-test-tool, and build it under CMake as well
  as Autotools (fd.o#89086, Simon McVittie)

 If dbus-daemon was compiled with --enable-verbose, add a D-Bus API
  to control it at runtime, overriding the DBUS_VERBOSE environment variable
  (fd.o #88896, Ralf Habacker)

Fixes:

 Reduce the number of file descriptors used in the fd-passing test,
  avoiding failure under the default Linux fd limit, and automatically
  skip it if the rlimit is too small (fd.o #88998, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1756

Simon McVittie's avatar
Simon McVittie committed
1757
D-Bus 1.9.10 (2015-02-09)
Simon McVittie's avatar
Simon McVittie committed
1758 1759
==

1760
The sad cyborgs release.
1761

Simon McVittie's avatar
Simon McVittie committed
1762
Security fixes merged from 1.8.16:
1763 1764 1765 1766 1767 1768 1769 1770

 Do not allow non-uid-0 processes to send forged ActivationFailure
  messages. On Linux systems with systemd activation, this would
  allow a local denial of service: unprivileged processes could
  flood the bus with these forged messages, winning the race with
  the actual service activation and causing an error reply
  to be sent back when service auto-activation was requested.
  This does not prevent the real service from being started,
Simon McVittie's avatar
Simon McVittie committed
1771
  so the attack only works while the real service is not running.
1772 1773
  (CVE-2015-0245, fd.o #88811; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794
Enhancements:

 The new Monitoring interface in the dbus-daemon lets dbus-monitor and
  similar tools receive messages without altering the security properties
  of the system bus, by calling the new BecomeMonitor method on a
  private connection. This bypasses the normal <allow> and <deny> rules
  entirely, so to preserve normal message-privacy assumptions, only root
  is allowed to do this on the system bus. Restricted environments,
  such as Linux with LSMs, should lock down access to the Monitoring
  interface. (fd.o #46787, Simon McVittie)

 dbus-monitor uses BecomeMonitor to capture more traffic, if the
  dbus-daemon supports it and access permissions allow it.
  It still supports the previous approach ("eavesdropping" match rules)
  for compatibility with older bus daemons. (fd.o #46787, Simon)

 dbus-monitor can now log the message stream as binary data for later
  analysis, with either no extra framing beyond the normal D-Bus headers,
  or libpcap-compatible framing treating each D-Bus message
  as a captured packet. (fd.o #46787, Simon)

1795
Other fixes:
Simon McVittie's avatar
Simon McVittie committed
1796 1797 1798 1799 1800 1801

 Fix some CMake build regressions (fd.o #88964, Ralf Habacker)

 On Unix, forcibly terminate regression tests after 60 seconds to
  prevent them from blocking continuous