NEWS 134 KB
Newer Older
1 2 3 4 5
dbus 1.13.12 (UNRELEASED)
=========================

...

6
dbus 1.13.10 (2019-05-13)
7 8
=========================

9 10
The engineering brick release.

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

 GLib >= 2.38 is required if full test coverage is enabled
  (reduced from 2.40 in dbus 1.12.x.)

16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
Deprecations:

 Third-party software should install default dbus policies for the system
  bus into ${datadir}/dbus-1/system.d (this has been supported since dbus
  1.10, released in August 2015). Installing default dbus policies in
  ${sysconfdir}/dbus-1/system.d is now considered to be deprecated. Policy
  files in ${sysconfdir}/dbus-1/system.d continue to be read, but this
  directory should only be used by system administrators wishing to
  override the default policies.

  The ${datadir} applicable to dbus is usually /usr/share and the
  ${sysconfdir} is usually /etc.

 A similar pattern applies to the session bus policies in session.d.

Simon McVittie's avatar
Simon McVittie committed
31 32
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
33 34 35 36 37 38
 D-Bus Specification 0.35:
  · Add UnixGroupIDs to GetConnectionCredentials()
    (dbus#196, dbus!105; Matthijs van Duin)
  · Remove some redundancies from the spec for interface names
    (dbus!102, Felipe Gasper)

Simon McVittie's avatar
Simon McVittie committed
39 40 41 42 43
 Raise soft fd limit to match hard limit, even if unprivileged.
  This makes session buses with many clients, or with clients that make
  heavy use of fd-passing, less likely to suffer from fd exhaustion.
  (dbus!103, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
44 45 46 47 48
 On Linux 4.13 or later when built against a suitable glibc version,
  GetConnectionCredentials() now includes UnixGroupIDs, the effective
  group IDs of the initiator of the connection, taken from
  SO_PEERGROUPS. (dbus#196, dbus!105; Matthijs van Duin)

Simon McVittie's avatar
Simon McVittie committed
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
 Embedded/special-purpose builds of dbus can now be configured with
  --disable-traditional-activation, to disable services being launched
  as a subprocess of the dbus-daemon. This allows the system dbus-daemon
  to be run in a more tightly restricted security profile (an example
  "drop-in" for systemd is provided).

  If systemd support is enabled, then services with a SystemdService
  configured can still be activated in these builds, via IPC to systemd.
  Otherwise, services will not be activatable at all.

  Please note that this option is not suitable for general-purpose
  Linux distributions that are intended to support running third-party
  D-Bus services.

  (dbus!107, Topi Miettinen)

 Move CMake build system to top level, matching normal practice for
  CMake projects (dbus!84, Ralf Habacker)

 Reformat CMake files (dbus#252, dbus!82, dbus!91; Ralf Habacker)

 Avoid GLib 2.40 dependencies (dbus!79, Ralf Habacker)

 Officially deprecate packaged XML policies in ${sysconfdir}, and
  document how to install system services correctly
  (dbus!76, Simon McVittie)

 Add AddressSanitizer and ubsan support (dbus!57, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
78 79
Fixes:

Simon McVittie's avatar
Simon McVittie committed
80 81 82 83 84 85 86 87 88 89 90 91 92 93
 If a privileged dbus-daemon has a hard fd limit greater than 64K, don't
  reduce it to 64K, ensuring that we can put back the original fd limits
  when carrying out traditional (non-systemd) activation. This fixes a
  regression with systemd >= 240 in which system services inherited
  dbus-daemon's hard and soft limit of 64K fds, instead of the intended
  soft limit of 1K and hard limit of 512K or 1M.
  (dbus!103, Debian#928877; Simon McVittie)

 Fix build failures caused by an AX_CODE_COVERAGE API change in newer
  autoconf-archive versions (dbus#249, dbus!88; Simon McVittie)

 Fix build failures with newer autoconf-archive versions that include
  AX_-prefixed shell variable names (dbus#249, dbus!86; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
94 95 96 97 98 99 100
 Avoid possible memory corruption in certain DBusHashTableIter use
  patterns, which in practice were never used (dbus!44, Simon McVittie)

 Avoid a test failure on Linux when built in a container as uid 0, but
  without the necessary privileges to increase resource limits
  (dbus!58, Debian #908092; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
 Don't overwrite PKG_CONFIG_PATH and related environment variables when
  the pkg-config-based version of DBus1Config is used in a CMake project
  (dbus#267, dbus!96; Clemens Lang)

• In CMake builds, respect GNUInstallDirs variables
  (dbus!77, Ralf Habacker)

• In CMake builds, don't rebuild documentation every time
  (dbus!94, Ralf Habacker)

 In CMake builds for Windows, don't require libiconv
  (dbus#262, dbus!100; Ralf Habacker)

• Fix intermittent build failures with parallel CMake
  (dbus#266, dbus!113; Simon McVittie)

• Don't assume we can set permissions on a directory, for the benefit of
  MSYS and Cygwin builds (dbus#216, dbus!110; Simon McVittie)

 Avoid test failures with non-trivial NSS modules
  (dbus#256, dbus!93; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
123 124 125
 Fix test failures in test-syslog and test-sysdeps under Windows
  (dbus#238, dbus#243, dbus!61, dbus!62; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143
 Ensure that CTest build-time tests on Windows use the just-built
  libdbus-1-3.dll (dbus!83, Ralf Habacker)

 Don't take so long to run test-refs on Windows
  (dbus#244, dbus!65; Ralf Habacker)

• Fix memory leaks in tests (dbus!68, Simon McVittie)

• Avoid casting user-supplied pointers to DBusBasicValue *, which is
  formally undefined behaviour (dbus!69, Simon McVittie)

• Fix a non-exploitable stack array overrun in dbus-run-session on Windows
  (Ralf Habacker)

Tests and CI enhancements:

• Verify that the result of an Autotools `make dist` can be used for a
  successful CMake build (dbus#255, dbus!87; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
144 145 146 147

• Rewrite Python tests into C to reduce circular dependencies and
  facilitate use of AddressSanitizer (dbus!37, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
148 149 150 151 152
• Refactor tests to extract most of their code from the bus/ and dbus/
  directories, and break them up into smaller modules
  (dbus#223, dbus#240, dbus!1, dbus!99, dbus!73, dbus!74, dbus!75;
  Simon McVittie, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
153
• Do CI builds in a more minimal environment (dbus!63, Simon McVittie)
154

Simon McVittie's avatar
Simon McVittie committed
155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174
• Improve test coverage with CMake (dbus#135, dbus!23; Ralf Habacker)

• Avoid firewall exception requests when running build-time tests on
  Windows (dbus!64, Ralf Habacker)

• Allow use of Wine to run cross-compiled Windows tests on Linux
  (dbus!60, Ralf Habacker)

Internal changes:

• Rename DBusSocketSet to the more accurate DBusPollableSet
  (dbus!81, Ralf Habacker)

• Refactor Windows implementation of dbus-spawn
  (dbus!80; Ralf Habacker, Simon McVittie)

• Delete unused code from userdb module (dbus!92, Simon McVittie)

• Remove unnecessary _dbus_threads_init_debug() (dbus!72, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
175
dbus 1.13.8 (2018-12-04)
Simon McVittie's avatar
Simon McVittie committed
176 177
========================

Simon McVittie's avatar
Simon McVittie committed
178 179
The “demanding dragon” release.

Simon McVittie's avatar
Simon McVittie committed
180 181 182 183 184 185
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
186 187 188 189 190 191 192
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.

193 194 195 196
 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.

197 198 199 200 201
 Building documentation using CMake now requires xsltproc, Docbook DTDs
  (for example docbook-xml on Debian derivatives), and Docbook XSLT
  stylesheets (for example docbook-xsl on Debian derivatives). Using
  KDE's meinproc4 documentation processor is no longer supported.

Simon McVittie's avatar
Simon McVittie committed
202 203
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
204 205 206
• Rewrite CONTRIBUTING.md to reflect the current setup
  (dbus!8, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
207 208 209 210
• 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
211 212 213 214 215 216
• 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
217 218 219 220 221 222 223 224 225 226 227 228 229 230
• 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
231
• Improve test coverage and clean up dead code
Simon McVittie's avatar
Simon McVittie committed
232
  (fd.o #107739, dbus#222; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
233

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

Simon McVittie's avatar
Simon McVittie committed
237 238 239 240 241
• 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
242 243 244 245 246
 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
247
  (dbus#57, dbus#117, dbus#193, dbus#227, dbus!18, dbus!39;
248
  Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
249

Simon McVittie's avatar
Simon McVittie committed
250 251
Fixes:

Simon McVittie's avatar
Simon McVittie committed
252 253 254 255 256 257 258 259 260
 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
261 262 263 264
• 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
265 266 267 268 269 270
• 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
271 272 273 274
• 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
275 276 277
• 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
278 279 280 281 282 283 284
• 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
285 286
• Fix some minor memory leaks
  (fd.o #107320, dbus!41, dbus!42; Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
287

Simon McVittie's avatar
Simon McVittie committed
288 289 290 291
• 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
292 293 294
 Extend a test timeout to avoid spurious failures in CI
  (dbus!26, Simon McVittie)

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

Simon McVittie's avatar
Simon McVittie committed
298 299 300 301
 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
302 303 304
 Fix whitespace and error behaviour for _dbus_command_from_pid()
  (dbus#222, dbus!28; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
305 306 307
 Fix a race condition in the containers test
  (dbus!47, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
308 309 310 311 312 313 314
 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
315 316 317 318 319 320 321
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
322
dbus 1.13.6 (2018-08-02)
323 324
========================

Simon McVittie's avatar
Simon McVittie committed
325 326
The vine cutting release.

Simon McVittie's avatar
Simon McVittie committed
327 328
Fixes:

Simon McVittie's avatar
Simon McVittie committed
329 330 331 332 333 334
 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
335 336 337 338 339 340
 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
341 342 343 344 345 346 347 348 349
 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
350 351 352 353 354 355
 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)
356

Simon McVittie's avatar
Simon McVittie committed
357
dbus 1.13.4 (2018-04-30)
Simon McVittie's avatar
Simon McVittie committed
358 359
========================

360 361
The “parsimonious topping” release.

362 363 364 365 366 367
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.)

368 369
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
370
 D-Bus Specification v0.33
Simon McVittie's avatar
Simon McVittie committed
371 372 373 374 375
  · 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)

376 377 378 379 380 381 382 383 384 385 386
 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
387

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

391 392 393 394 395 396 397 398 399 400 401 402
• 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)

403 404 405
• The Devhelp documentation index is now in version 2 format
  (fd.o #106186, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
406
• Give the dbus-daemon man page some scarier warnings about
407 408
  <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
409 410
  (fd.o #106004, Simon McVittie)

411 412 413 414 415
Fixes:

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

416 417 418
• Fix installation of Ducktype documentation with newer yelp-build
  versions (fd.o #106171, Simon McVittie)

419 420 421
• Fix printf formats for pointer-sized integers on 64-bit Windows
  (fd.o #105662, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
422 423 424 425 426 427 428 429 430
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
431
dbus 1.13.2 (2018-03-01)
Simon McVittie's avatar
Simon McVittie committed
432 433
========================

Simon McVittie's avatar
Simon McVittie committed
434 435
The “can break a man's arm release.

436 437 438 439 440 441
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
442

Simon McVittie's avatar
Simon McVittie committed
443 444 445
Fixes:

 Increase system dbus-daemon's RLIMIT_NOFILE rlimit before it drops
446 447 448
  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
449 450
  (fd.o #105165, David King)

Simon McVittie's avatar
Simon McVittie committed
451
dbus 1.13.0 (2018-02-08)
452 453
========================

Simon McVittie's avatar
Simon McVittie committed
454 455
The Citispeed Eco 75 release.

456 457 458 459 460
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
461 462 463 464
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
465 466 467 468 469 470 471 472 473 474 475
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)

476 477
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
478 479 480 481 482
• 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
483 484
  · Clarify how the SASL authentication handshake works
    (fd.o #104224, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
485 486 487 488
  · 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
489

Simon McVittie's avatar
Simon McVittie committed
490 491 492 493 494
 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)

495 496
 Improve automated test logging (fd.o #103601, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
497 498 499 500 501 502
 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
503 504
Fixes:

Simon McVittie's avatar
Simon McVittie committed
505 506 507 508 509 510 511
 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
512 513 514 515 516
• 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
517 518 519 520 521 522 523 524 525 526 527 528 529
• 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
530 531
 Add a missing space to a warning message (fd.o #103729, Thomas Zajic)

Simon McVittie's avatar
Simon McVittie committed
532 533 534
 Fix some memory leaks in automated tests
  (fd.o #103600, Simon McVittie)

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

538 539
 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
540 541
  (fd.o #104577, Chris Lesiak)

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

544 545 546 547 548 549 550
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
551

Simon McVittie's avatar
Simon McVittie committed
552 553 554 555 556 557 558 559
• 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)

560 561 562
• 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
563 564 565
• Simplify method calls in automated tests
  (fd.o #103600, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
566
dbus 1.12.2 (2017-11-13)
567 568
========================

Simon McVittie's avatar
Simon McVittie committed
569
The “spider pumpkin” release.
570

Simon McVittie's avatar
Simon McVittie committed
571 572 573 574 575 576
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
577 578 579 580 581
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
582 583 584 585
• 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
586 587 588 589 590 591
• 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
592 593
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
596
dbus 1.12.0 (2017-10-30)
597 598
========================

Simon McVittie's avatar
Simon McVittie committed
599 600 601 602
The “gingerbread skull” release.

1.12.x is a new stable branch, recommended for use in OS
distributions.
603 604 605 606 607 608

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

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
609
• Expat >= 2.1.0 is required.
610 611 612 613 614 615 616
• 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
617
• [CMake] Builds done using CMake now require CMake 3.0.2.
618 619 620 621 622 623 624 625 626 627 628 629 630 631

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
632 633 634 635
• [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.
636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676
• [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
677 678
• [Unix] Exceeding an anti-DoS limit is logged to syslog if configured,
  or to stderr.
679

Simon McVittie's avatar
Simon McVittie committed
680 681 682 683
Changes since 1.11.22 release candidate
---------------------------------------

Standard stable-branch changes:
684

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

Simon McVittie's avatar
Simon McVittie committed
687 688 689 690 691 692 693 694 695
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)
696

Simon McVittie's avatar
Simon McVittie committed
697
D-Bus 1.11.22 (2017-10-23)
698
==========================
699

Simon McVittie's avatar
Simon McVittie committed
700 701 702 703
The fire surface release.

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

Simon McVittie's avatar
Simon McVittie committed
704 705 706 707 708 709 710 711 712 713 714
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.

715 716 717 718 719
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
720 721 722 723 724 725 726 727 728
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
729 730 731
• 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
732 733 734 735
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
737
D-Bus 1.11.20 (2017-10-03)
738 739
==

740 741
The “wraith stun” release.

Simon McVittie's avatar
Simon McVittie committed
742 743 744
Build-time configuration changes:

• The --enable-abstract-sockets and --disable-abstract-sockets options
Simon McVittie's avatar
Simon McVittie committed
745 746 747
  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
748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769

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)
770

Simon McVittie's avatar
Simon McVittie committed
771
D-Bus 1.11.18 (2017-09-25)
Simon McVittie's avatar
Simon McVittie committed
772 773
==

Simon McVittie's avatar
Simon McVittie committed
774 775
The “vampire conquistador” release.

776 777 778 779 780 781 782 783 784 785 786 787 788
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)

789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813
• 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
814 815 816 817 818 819 820 821
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
822 823 824 825 826 827 828 829 830 831 832
 <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
833 834 835 836 837 838 839 840
 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
841 842 843 844 845 846 847 848 849 850
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
851

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

Simon McVittie's avatar
Simon McVittie committed
855 856 857 858
• 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
859
D-Bus 1.11.16 (2017-07-27)
860 861
==

Simon McVittie's avatar
Simon McVittie committed
862 863
The “south facing garden” release.

Simon McVittie's avatar
Simon McVittie committed
864 865 866 867 868 869 870 871
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)
872

873 874 875 876 877 878 879 880 881 882
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
883 884 885 886
• Fix the implementation of re-enabling a timeout (again) so that its
  countdown is always restarted as intended. (fd.o #95619,
  Michal Koutný)

887 888 889
• 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)

890 891 892 893 894 895 896 897 898 899 900 901 902 903 904
 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
905 906 907
 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
908 909 910
 Make build-time tests cope with finding Python 3, but not Python 2
  (fd.o #101716, Simon McVittie)

911 912 913 914 915 916 917 918 919 920 921 922
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
923
D-Bus 1.11.14 (2017-06-29)
Simon McVittie's avatar
Simon McVittie committed
924 925
==

Simon McVittie's avatar
Simon McVittie committed
926 927
The irrational fear of bees release.

Simon McVittie's avatar
Simon McVittie committed
928 929
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
930 931 932
 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
933

Simon McVittie's avatar
Simon McVittie committed
934 935 936 937 938 939 940 941 942 943 944 945 946 947
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
948

Simon McVittie's avatar
Simon McVittie committed
949 950 951
 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
952

Simon McVittie's avatar
Simon McVittie committed
953 954 955 956 957 958 959 960 961 962 963 964 965 966 967
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)

968 969 970 971 972 973 974
 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
975 976 977 978 979 980 981
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
982
  · Describe all message bus methods in the same section
Simon McVittie's avatar
Simon McVittie committed
983
  · Clarify the correct object path for method calls to the message bus
Simon McVittie's avatar
Simon McVittie committed
984 985 986 987 988
    (/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
989 990
  · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
    abstract sockets
991 992 993
  · 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
994
  (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
Simon McVittie's avatar
Simon McVittie committed
995 996 997 998
  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
999

Simon McVittie's avatar
Simon McVittie committed
1000 1001 1002
 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
1003 1004 1005
  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
1006

Simon McVittie's avatar
Simon McVittie committed
1007 1008 1009
 Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
  (fd.o #101315, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
1010 1011 1012
 Avoid deprecated API calls when using SELinux
  (fd.o #100912, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
1013 1014 1015 1016
 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)

1017 1018 1019 1020 1021 1022 1023
 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
1024 1025 1026 1027
• 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
1028 1029
Fixes:

1030 1031 1032
• 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
1033 1034 1035
• 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
1036 1037 1038

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

Simon McVittie's avatar
Simon McVittie committed
1039 1040 1041 1042 1043 1044
 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)

1045 1046 1047 1048
Documentation:

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

Simon McVittie's avatar
Simon McVittie committed
1050
D-Bus 1.11.12 (2017-04-07)
Simon McVittie's avatar
Simon McVittie committed
1051 1052
==

Simon McVittie's avatar
Simon McVittie committed
1053 1054
The it's something humans do” release.

Simon McVittie's avatar
Simon McVittie committed
1055 1056 1057 1058 1059 1060 1061 1062
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
1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081
• 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
1082 1083 1084 1085 1086 1087 1088
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
1089

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

Simon McVittie's avatar
Simon McVittie committed
1092 1093 1094
• 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
1095 1096 1097
• Fix some typos in test code
  (fd.o #99999, Coverity #141876, #141877; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1098 1099 1100
• 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
1101
• Fix and enable compiler warnings related to -Wswitch
Simon McVittie's avatar
Simon McVittie committed
1102 1103
  (fd.o #98191; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1104 1105 1106
• 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
1107
D-Bus 1.11.10 (2017-02-16)
Simon McVittie's avatar
Simon McVittie committed
1108 1109
==

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

Simon McVittie's avatar
Simon McVittie committed
1112 1113 1114 1115 1116 1117 1118 1119 1120 1121
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
1122
  the default (fd.o #98889, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1123

Simon McVittie's avatar
Simon McVittie committed
1124
• Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1125 1126 1127 1128

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

Simon McVittie's avatar
Simon McVittie committed
1129 1130 1131 1132 1133 1134 1135 1136 1137 1138
• 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
1139 1140
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1141 1142 1143 1144 1145 1146 1147 1148 1149
• 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
1150
  transports and authentication mechanisms enabled by default.
Simon McVittie's avatar
Simon McVittie committed
1151 1152 1153 1154 1155 1156

  (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)
1157

Simon McVittie's avatar
Simon McVittie committed
1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171
• 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
1172
  for Windows with CMake (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
1173 1174

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

Simon McVittie's avatar
Simon McVittie committed
1177 1178 1179
• 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
1180 1181
• 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
1182

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

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

Simon McVittie's avatar
Simon McVittie committed
1189 1190 1191
• 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
1192 1193 1194 1195 1196 1197
 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
1198
• Improve error handling in unit tests and dbus-send
Simon McVittie's avatar
Simon McVittie committed
1199 1200 1201 1202
  (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
1203 1204 1205 1206

• 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)

1207
D-Bus 1.11.8 (2016-11-28)
Simon McVittie's avatar
Simon McVittie committed
1208 1209
==

1210 1211
The panics in the face of breakfast foods release.

Simon McVittie's avatar
Simon McVittie committed
1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224
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
1225 1226 1227 1228 1229
 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
1230 1231
  · Clarify intended behaviour of Properties.GetAll
  (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1232

Simon McVittie's avatar
Simon McVittie committed
1233 1234 1235
 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.
1236 1237 1238 1239
  · 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
1240 1241 1242
  (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
  Thomas Zimmermann, Simon McVittie)

1243 1244 1245 1246 1247 1248 1249
 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
1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260
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
1261

Simon McVittie's avatar
Simon McVittie committed
1262 1263 1264 1265
 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)

1266
D-Bus 1.11.6 (2016-10-10)
Simon McVittie's avatar
Simon McVittie committed
1267 1268
==

1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286
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
1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300
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
1301 1302 1303
• Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
  (fd.o #89011, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1304 1305 1306 1307 1308 1309
• 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)

1310 1311 1312 1313 1314 1315
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
1316

Simon McVittie's avatar
Simon McVittie committed
1317 1318 1319
• 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
1320 1321 1322 1323
• 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
1324

Simon McVittie's avatar
Simon McVittie committed
1325
D-Bus 1.11.4 (2016-08-15)
Simon McVittie's avatar
Simon McVittie committed
1326 1327
==

Simon McVittie's avatar
Simon McVittie committed
1328 1329
The “copper pickaxe” release.

1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340
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
1341 1342 1343 1344 1345 1346 1347 1348 1349
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
1350 1351
• Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1352 1353 1354 1355 1356 1357
• 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
1358 1359 1360
• On Unix, unify the various places that reopen stdin, stdout and/or stderr
  pointing to /dev/null (fd.o #97008, Simon McVittie)

1361 1362 1363
• Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
  (fd.o #88922, Thomas Zimmermann)

Simon McVittie's avatar
Simon McVittie committed
1364 1365
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1369 1370 1371 1372
• 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
1373 1374 1375 1376
• 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
1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387
• 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
1388

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

Simon McVittie's avatar
Simon McVittie committed
1391 1392 1393 1394 1395 1396 1397 1398 1399
• 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
1400 1401 1402
• update-activation-environment: produce better diagnostics on error
  (fd.o #96653, Simon McVittie)

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

Simon McVittie's avatar
Simon McVittie committed
1406 1407 1408 1409 1410 1411
• 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
1412
D-Bus 1.11.2 (2016-03-07)
Simon McVittie's avatar
Simon McVittie committed
1413 1414
==

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

Simon McVittie's avatar
Simon McVittie committed
1417 1418 1419 1420 1421 1422
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
1423 1424 1425 1426 1427 1428 1429 1430
• 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
1431 1432 1433 1434 1435 1436 1437 1438
• 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
1439

Simon McVittie's avatar
Simon McVittie committed
1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463
• 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
1464
D-Bus 1.11.0 (2015-12-02)
Simon McVittie's avatar
Simon McVittie committed
1465 1466
==

Simon McVittie's avatar
Simon McVittie committed
1467 1468
The “peppermint deer” release.

Simon McVittie's avatar
Simon McVittie committed
1469 1470
Dependencies:

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

1474 1475 1476 1477 1478 1479
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
1480 1481 1482 1483 1484 1485 1486 1487
• 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
1488 1489
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1490 1491 1492 1493
• 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)

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

Simon McVittie's avatar
Simon McVittie committed
1496 1497 1498 1499 1500 1501 1502
• 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)

1503 1504 1505 1506
 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
1507 1508
 Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)

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

Simon McVittie's avatar
Simon McVittie committed
1511
D-Bus 1.10.6 (2015-12-01)
Simon McVittie's avatar
Simon McVittie committed
1512 1513
==

Simon McVittie's avatar
Simon McVittie committed
1514 1515
The marzipan beetles release.

Simon McVittie's avatar
Simon McVittie committed
1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528
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
1529
D-Bus 1.10.4 (2015-11-17)
Simon McVittie's avatar
Simon McVittie committed
1530 1531
==

Simon McVittie's avatar
Simon McVittie committed
1532 1533
The Frostburn Canyon release.

Simon McVittie's avatar
Simon McVittie committed
1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555
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
1556 1557 1558
• On Windows, don't crash if <syslog/> or --syslog is used
  (fd.o #92538, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1559 1560 1561 1562 1563 1564 1565
 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
1566 1567 1568 1569 1570 1571 1572 1573 1574
  · 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
1575
  · skip some system bus tests on Windows since they make no sense there
Simon McVittie's avatar
Simon McVittie committed
1576
  (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1577

Simon McVittie's avatar
Simon McVittie committed
1578
D-Bus 1.10.2 (2015-10-26)
Simon McVittie's avatar
Simon McVittie committed
1579 1580
==

Simon McVittie's avatar
Simon McVittie committed
1581 1582
The “worst pies in London” release.

Simon McVittie's avatar
Simon McVittie committed
1583 1584
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1585 1586 1587 1588 1589
• 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
1590 1591 1592 1593 1594
• 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
1595 1596 1597 1598
 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
1599 1600
 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
1601

Simon McVittie's avatar
Simon McVittie committed
1602 1603 1604 1605
• 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
1606 1607 1608
• Make more of the regression tests pass in Windows builds (fd.o #92538,
  Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1609
D-Bus 1.10.0 (2015-08-25)
Simon McVittie's avatar
Simon McVittie committed
1610 1611
==

Simon McVittie's avatar
Simon McVittie committed
1612 1613 1614 1615 1616 1617 1618 1619 1620 1621
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)

1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664
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
1665 1666
 org.freedesktop.DBus.Verbose interface (not normally compiled)
  · toggles the effect of DBUS_VERBOSE
1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691

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
1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703
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
1704

Simon McVittie's avatar
Simon McVittie committed
1705
D-Bus 1.9.18 (2015-07-21)
Simon McVittie's avatar
Simon McVittie committed
1706 1707
==

Simon McVittie's avatar
Simon McVittie committed
1708 1709
The Pirate Elite release.

Simon McVittie's avatar
Simon McVittie committed
1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734
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
1735

Simon McVittie's avatar
Simon McVittie committed
1736 1737 1738 1739
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1741 1742
• 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
1743

Simon McVittie's avatar
Simon McVittie committed
1744
D-Bus 1.9.16 (2015-05-14)
1745 1746
==

1747 1748 1749 1750 1751 1752 1753
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
1754 1755 1756 1757 1758 1759 1760
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
1761
  unpredictable pseudo-random numbers.
Simon McVittie's avatar
Simon McVittie committed
1762 1763 1764 1765 1766 1767 1768 1769 1770

  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
1771 1772 1773 1774 1775 1776
• 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
1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787
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)

1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799
• 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
1800 1801 1802 1803 1804 1805 1806 1807 1808
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
1809
  of memory while copying authentication mechanisms (fd.o #90021,
Simon McVittie's avatar
Simon McVittie committed
1810 1811
  Ralf Habacker)

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

1815 1816
 Correctly initialize all fields of DBusTypeReader (fd.o #90021;
  Ralf Habacker, Simon McVittie)
1817

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

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

1824 1825 1826 1827 1828 1829
 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
1830
D