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

Simon McVittie's avatar
Simon McVittie committed
4 5 6 7 8 9 10 11
Enhancements:

 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
12 13 14
 Improve test coverage and clean up dead code
  (fd.o #107739, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
15 16 17
 Allow --enable-relocation in combination with absolute paths for
  --exec-prefix, --libdir (fd.o #107662, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
18 19 20 21 22 23 24
Fixes:

 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)

 Fix some small O(1) memory leaks (fd.o #107320, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
25

Simon McVittie's avatar
Simon McVittie committed
26
dbus 1.13.6 (2018-08-02)
27 28
========================

Simon McVittie's avatar
Simon McVittie committed
29 30
The vine cutting release.

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

Simon McVittie's avatar
Simon McVittie committed
33 34 35 36 37 38
 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
39 40 41 42 43 44
 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
45 46 47 48 49 50 51 52 53
 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
54 55 56 57 58 59
 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)
60

Simon McVittie's avatar
Simon McVittie committed
61
dbus 1.13.4 (2018-04-30)
Simon McVittie's avatar
Simon McVittie committed
62 63
========================

64 65
The “parsimonious topping” release.

66 67 68 69 70 71
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.)

72 73
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
74
 D-Bus Specification v0.33
Simon McVittie's avatar
Simon McVittie committed
75 76 77 78 79
  · 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)

80 81 82 83 84 85 86 87 88 89 90
 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
91

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

95 96 97 98 99 100 101 102 103 104 105 106
• 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)

107 108 109
• The Devhelp documentation index is now in version 2 format
  (fd.o #106186, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
110
• Give the dbus-daemon man page some scarier warnings about
111 112
  <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
113 114
  (fd.o #106004, Simon McVittie)

115 116 117 118 119
Fixes:

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

120 121 122
• Fix installation of Ducktype documentation with newer yelp-build
  versions (fd.o #106171, Simon McVittie)

123 124 125
• Fix printf formats for pointer-sized integers on 64-bit Windows
  (fd.o #105662, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
126 127 128 129 130 131 132 133 134
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
135
dbus 1.13.2 (2018-03-01)
Simon McVittie's avatar
Simon McVittie committed
136 137
========================

Simon McVittie's avatar
Simon McVittie committed
138 139
The “can break a man's arm release.

140 141 142 143 144 145
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
146

Simon McVittie's avatar
Simon McVittie committed
147 148 149
Fixes:

 Increase system dbus-daemon's RLIMIT_NOFILE rlimit before it drops
150 151 152
  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
153 154
  (fd.o #105165, David King)

Simon McVittie's avatar
Simon McVittie committed
155
dbus 1.13.0 (2018-02-08)
156 157
========================

Simon McVittie's avatar
Simon McVittie committed
158 159
The Citispeed Eco 75 release.

160 161 162 163 164
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
165 166 167 168
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
169 170 171 172 173 174 175 176 177 178 179
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)

180 181
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
182 183 184 185 186
• 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
187 188
  · Clarify how the SASL authentication handshake works
    (fd.o #104224, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
189 190 191 192
  · 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
193

Simon McVittie's avatar
Simon McVittie committed
194 195 196 197 198
 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)

199 200
 Improve automated test logging (fd.o #103601, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
201 202 203 204 205 206
 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
207 208
Fixes:

Simon McVittie's avatar
Simon McVittie committed
209 210 211 212 213 214 215
 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
216 217 218 219 220
• 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
221 222 223 224 225 226 227 228 229 230 231 232 233
• 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
234 235
 Add a missing space to a warning message (fd.o #103729, Thomas Zajic)

Simon McVittie's avatar
Simon McVittie committed
236 237 238
 Fix some memory leaks in automated tests
  (fd.o #103600, Simon McVittie)

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

242 243
 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
244 245
  (fd.o #104577, Chris Lesiak)

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

248 249 250 251 252 253 254
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
255

Simon McVittie's avatar
Simon McVittie committed
256 257 258 259 260 261 262 263
• 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)

264 265 266
• 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
267 268 269
• Simplify method calls in automated tests
  (fd.o #103600, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
270
dbus 1.12.2 (2017-11-13)
271 272
========================

Simon McVittie's avatar
Simon McVittie committed
273
The “spider pumpkin” release.
274

Simon McVittie's avatar
Simon McVittie committed
275 276 277 278 279 280
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
281 282 283 284 285
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
286 287 288 289
• 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
290 291 292 293 294 295
• 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
296 297
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
300
dbus 1.12.0 (2017-10-30)
301 302
========================

Simon McVittie's avatar
Simon McVittie committed
303 304 305 306
The “gingerbread skull” release.

1.12.x is a new stable branch, recommended for use in OS
distributions.
307 308 309 310 311 312

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

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
313
• Expat >= 2.1.0 is required.
314 315 316 317 318 319 320
• 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
321
• [CMake] Builds done using CMake now require CMake 3.0.2.
322 323 324 325 326 327 328 329 330 331 332 333 334 335

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
336 337 338 339
• [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.
340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380
• [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
381 382
• [Unix] Exceeding an anti-DoS limit is logged to syslog if configured,
  or to stderr.
383

Simon McVittie's avatar
Simon McVittie committed
384 385 386 387
Changes since 1.11.22 release candidate
---------------------------------------

Standard stable-branch changes:
388

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

Simon McVittie's avatar
Simon McVittie committed
391 392 393 394 395 396 397 398 399
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)
400

Simon McVittie's avatar
Simon McVittie committed
401
D-Bus 1.11.22 (2017-10-23)
402
==========================
403

Simon McVittie's avatar
Simon McVittie committed
404 405 406 407
The fire surface release.

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

Simon McVittie's avatar
Simon McVittie committed
408 409 410 411 412 413 414 415 416 417 418
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.

419 420 421 422 423
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
424 425 426 427 428 429 430 431 432
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
433 434 435
• 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
436 437 438 439
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
441
D-Bus 1.11.20 (2017-10-03)
442 443
==

444 445
The “wraith stun” release.

Simon McVittie's avatar
Simon McVittie committed
446 447 448
Build-time configuration changes:

• The --enable-abstract-sockets and --disable-abstract-sockets options
Simon McVittie's avatar
Simon McVittie committed
449 450 451
  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
452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473

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

Simon McVittie's avatar
Simon McVittie committed
475
D-Bus 1.11.18 (2017-09-25)
Simon McVittie's avatar
Simon McVittie committed
476 477
==

Simon McVittie's avatar
Simon McVittie committed
478 479
The “vampire conquistador” release.

480 481 482 483 484 485 486 487 488 489 490 491 492
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)

493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517
• 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
518 519 520 521 522 523 524 525
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
526 527 528 529 530 531 532 533 534 535 536
 <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
537 538 539 540 541 542 543 544
 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
545 546 547 548 549 550 551 552 553 554
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
555

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

Simon McVittie's avatar
Simon McVittie committed
559 560 561 562
• 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
563
D-Bus 1.11.16 (2017-07-27)
564 565
==

Simon McVittie's avatar
Simon McVittie committed
566 567
The “south facing garden” release.

Simon McVittie's avatar
Simon McVittie committed
568 569 570 571 572 573 574 575
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)
576

577 578 579 580 581 582 583 584 585 586
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
587 588 589 590
• Fix the implementation of re-enabling a timeout (again) so that its
  countdown is always restarted as intended. (fd.o #95619,
  Michal Koutný)

591 592 593
• 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)

594 595 596 597 598 599 600 601 602 603 604 605 606 607 608
 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
609 610 611
 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
612 613 614
 Make build-time tests cope with finding Python 3, but not Python 2
  (fd.o #101716, Simon McVittie)

615 616 617 618 619 620 621 622 623 624 625 626
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
627
D-Bus 1.11.14 (2017-06-29)
Simon McVittie's avatar
Simon McVittie committed
628 629
==

Simon McVittie's avatar
Simon McVittie committed
630 631
The irrational fear of bees release.

Simon McVittie's avatar
Simon McVittie committed
632 633
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
634 635 636
 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
637

Simon McVittie's avatar
Simon McVittie committed
638 639 640 641 642 643 644 645 646 647 648 649 650 651
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
652

Simon McVittie's avatar
Simon McVittie committed
653 654 655
 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
656

Simon McVittie's avatar
Simon McVittie committed
657 658 659 660 661 662 663 664 665 666 667 668 669 670 671
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)

672 673 674 675 676 677 678
 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
679 680 681 682 683 684 685
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
686
  · Describe all message bus methods in the same section
Simon McVittie's avatar
Simon McVittie committed
687
  · Clarify the correct object path for method calls to the message bus
Simon McVittie's avatar
Simon McVittie committed
688 689 690 691 692
    (/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
693 694
  · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
    abstract sockets
695 696 697
  · 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
698
  (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
Simon McVittie's avatar
Simon McVittie committed
699 700 701 702
  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
703

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

Simon McVittie's avatar
Simon McVittie committed
711 712 713
 Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
  (fd.o #101315, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
714 715 716
 Avoid deprecated API calls when using SELinux
  (fd.o #100912, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
717 718 719 720
 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)

721 722 723 724 725 726 727
 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
728 729 730 731
• 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
732 733
Fixes:

734 735 736
• 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
737 738 739
• 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
740 741 742

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

Simon McVittie's avatar
Simon McVittie committed
743 744 745 746 747 748
 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)

749 750 751 752
Documentation:

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

Simon McVittie's avatar
Simon McVittie committed
754
D-Bus 1.11.12 (2017-04-07)
Simon McVittie's avatar
Simon McVittie committed
755 756
==

Simon McVittie's avatar
Simon McVittie committed
757 758
The it's something humans do” release.

Simon McVittie's avatar
Simon McVittie committed
759 760 761 762 763 764 765 766
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
767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785
• 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
786 787 788 789 790 791 792
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
793

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

Simon McVittie's avatar
Simon McVittie committed
796 797 798
• 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
799 800 801
• Fix some typos in test code
  (fd.o #99999, Coverity #141876, #141877; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
802 803 804
• 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
805
• Fix and enable compiler warnings related to -Wswitch
Simon McVittie's avatar
Simon McVittie committed
806 807
  (fd.o #98191; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
808 809 810
• 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
811
D-Bus 1.11.10 (2017-02-16)
Simon McVittie's avatar
Simon McVittie committed
812 813
==

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

Simon McVittie's avatar
Simon McVittie committed
816 817 818 819 820 821 822 823 824 825
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
826
  the default (fd.o #98889, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
827

Simon McVittie's avatar
Simon McVittie committed
828
• Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
829 830 831 832

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

Simon McVittie's avatar
Simon McVittie committed
833 834 835 836 837 838 839 840 841 842
• 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
843 844
Fixes:

Simon McVittie's avatar
Simon McVittie committed
845 846 847 848 849 850 851 852 853
• 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
854
  transports and authentication mechanisms enabled by default.
Simon McVittie's avatar
Simon McVittie committed
855 856 857 858 859 860

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

Simon McVittie's avatar
Simon McVittie committed
862 863 864 865 866 867 868 869 870 871 872 873 874 875
• 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
876
  for Windows with CMake (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
877 878

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

Simon McVittie's avatar
Simon McVittie committed
881 882 883
• 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
884 885
• 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
886

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

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

Simon McVittie's avatar
Simon McVittie committed
893 894 895
• 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
896 897 898 899 900 901
 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
902
• Improve error handling in unit tests and dbus-send
Simon McVittie's avatar
Simon McVittie committed
903 904 905 906
  (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
907 908 909 910

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

911
D-Bus 1.11.8 (2016-11-28)
Simon McVittie's avatar
Simon McVittie committed
912 913
==

914 915
The panics in the face of breakfast foods release.

Simon McVittie's avatar
Simon McVittie committed
916 917 918 919 920 921 922 923 924 925 926 927 928
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
929 930 931 932 933
 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
934 935
  · Clarify intended behaviour of Properties.GetAll
  (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
936

Simon McVittie's avatar
Simon McVittie committed
937 938 939
 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.
940 941 942 943
  · 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
944 945 946
  (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
  Thomas Zimmermann, Simon McVittie)

947 948 949 950 951 952 953
 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
954 955 956 957 958 959 960 961 962 963 964
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
965

Simon McVittie's avatar
Simon McVittie committed
966 967 968 969
 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)

970
D-Bus 1.11.6 (2016-10-10)
Simon McVittie's avatar
Simon McVittie committed
971 972
==

973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990
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
991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004
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
1005 1006 1007
• Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
  (fd.o #89011, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
1008 1009 1010 1011 1012 1013
• 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)

1014 1015 1016 1017 1018 1019
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
1020

Simon McVittie's avatar
Simon McVittie committed
1021 1022 1023
• 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
1024 1025 1026 1027
• 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
1028

Simon McVittie's avatar
Simon McVittie committed
1029
D-Bus 1.11.4 (2016-08-15)
Simon McVittie's avatar
Simon McVittie committed
1030 1031
==

Simon McVittie's avatar
Simon McVittie committed
1032 1033
The “copper pickaxe” release.

1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044
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
1045 1046 1047 1048 1049 1050 1051 1052 1053
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
1054 1055
• Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1056 1057 1058 1059 1060 1061
• 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
1062 1063 1064
• On Unix, unify the various places that reopen stdin, stdout and/or stderr
  pointing to /dev/null (fd.o #97008, Simon McVittie)

1065 1066 1067
• Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
  (fd.o #88922, Thomas Zimmermann)

Simon McVittie's avatar
Simon McVittie committed
1068 1069
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1073 1074 1075 1076
• 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
1077 1078 1079 1080
• 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
1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091
• 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
1092

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

Simon McVittie's avatar
Simon McVittie committed
1095 1096 1097 1098 1099 1100 1101 1102 1103
• 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
1104 1105 1106
• update-activation-environment: produce better diagnostics on error
  (fd.o #96653, Simon McVittie)

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

Simon McVittie's avatar
Simon McVittie committed
1110 1111 1112 1113 1114 1115
• 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
1116
D-Bus 1.11.2 (2016-03-07)
Simon McVittie's avatar
Simon McVittie committed
1117 1118
==

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

Simon McVittie's avatar
Simon McVittie committed
1121 1122 1123 1124 1125 1126
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
1127 1128 1129 1130 1131 1132 1133 1134
• 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
1135 1136 1137 1138 1139 1140 1141 1142
• 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
1143

Simon McVittie's avatar
Simon McVittie committed
1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167
• 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
1168
D-Bus 1.11.0 (2015-12-02)
Simon McVittie's avatar
Simon McVittie committed
1169 1170
==

Simon McVittie's avatar
Simon McVittie committed
1171 1172
The “peppermint deer” release.

Simon McVittie's avatar
Simon McVittie committed
1173 1174
Dependencies:

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

1178 1179 1180 1181 1182 1183
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
1184 1185 1186 1187 1188 1189 1190 1191
• 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
1192 1193
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1194 1195 1196 1197
• 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)

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

Simon McVittie's avatar
Simon McVittie committed
1200 1201 1202 1203 1204 1205 1206
• 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)

1207 1208 1209 1210
 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
1211 1212
 Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)

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

Simon McVittie's avatar
Simon McVittie committed
1215
D-Bus 1.10.6 (2015-12-01)
Simon McVittie's avatar
Simon McVittie committed
1216 1217
==

Simon McVittie's avatar
Simon McVittie committed
1218 1219
The marzipan beetles release.

Simon McVittie's avatar
Simon McVittie committed
1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232
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
1233
D-Bus 1.10.4 (2015-11-17)
Simon McVittie's avatar
Simon McVittie committed
1234 1235
==

Simon McVittie's avatar
Simon McVittie committed
1236 1237
The Frostburn Canyon release.

Simon McVittie's avatar
Simon McVittie committed
1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259
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
1260 1261 1262
• On Windows, don't crash if <syslog/> or --syslog is used
  (fd.o #92538, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1263 1264 1265 1266 1267 1268 1269
 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
1270 1271 1272 1273 1274 1275 1276 1277 1278
  · 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
1279
  · skip some system bus tests on Windows since they make no sense there
Simon McVittie's avatar
Simon McVittie committed
1280
  (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1281

Simon McVittie's avatar
Simon McVittie committed
1282
D-Bus 1.10.2 (2015-10-26)
Simon McVittie's avatar
Simon McVittie committed
1283 1284
==

Simon McVittie's avatar
Simon McVittie committed
1285 1286
The “worst pies in London” release.

Simon McVittie's avatar
Simon McVittie committed
1287 1288
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1289 1290 1291 1292 1293
• 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
1294 1295 1296 1297 1298
• 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
1299 1300 1301 1302
 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
1303 1304
 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
1305

Simon McVittie's avatar
Simon McVittie committed
1306 1307 1308 1309
• 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
1310 1311 1312
• Make more of the regression tests pass in Windows builds (fd.o #92538,
  Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1313
D-Bus 1.10.0 (2015-08-25)
Simon McVittie's avatar
Simon McVittie committed
1314 1315
==

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

1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368
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
1369 1370
 org.freedesktop.DBus.Verbose interface (not normally compiled)
  · toggles the effect of DBUS_VERBOSE
1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395

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
1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407
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
1408

Simon McVittie's avatar
Simon McVittie committed
1409
D-Bus 1.9.18 (2015-07-21)
Simon McVittie's avatar
Simon McVittie committed
1410 1411
==

Simon McVittie's avatar
Simon McVittie committed
1412 1413
The Pirate Elite release.

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

Simon McVittie's avatar
Simon McVittie committed
1440 1441 1442 1443
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1445 1446
• 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
1447

Simon McVittie's avatar
Simon McVittie committed
1448
D-Bus 1.9.16 (2015-05-14)
1449 1450
==

1451 1452 1453 1454 1455 1456 1457
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
1458 1459 1460 1461 1462 1463 1464
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
1465
  unpredictable pseudo-random numbers.
Simon McVittie's avatar
Simon McVittie committed
1466 1467 1468 1469 1470 1471 1472 1473 1474

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

1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503
• 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
1504 1505 1506 1507 1508 1509 1510 1511 1512
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
1513
  of memory while copying authentication mechanisms (fd.o #90021,
Simon McVittie's avatar
Simon McVittie committed
1514 1515
  Ralf Habacker)

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

1519 1520
 Correctly initialize all fields of DBusTypeReader (fd.o #90021;
  Ralf Habacker, Simon McVittie)
1521

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

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

1528 1529 1530 1531 1532 1533
 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
1534
D-Bus 1.9.14 (2015-03-02)
Simon McVittie's avatar
Simon McVittie committed
1535 1536
==

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

Simon McVittie's avatar
Simon McVittie committed
1539 1540 1541 1542 1543
Dependencies:

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

Simon McVittie's avatar
Simon McVittie committed
1544 1545 1546 1547 1548 1549 1550 1551 1552 1553
• The tests no longer require dbus-glib in order to exercise the libdbus
  shared library; they are always linked to libdbus now.

Build-time configuration:

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

Simon McVittie's avatar
Simon McVittie committed
1554 1555 1556 1557 1558 1559 1560 1561 1562 1563
Enhancements:

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

• On platforms that support them (GNU libc and possibly others),
  libdbus now has versioned symbols for its public API.
  All public symbols (visible in the header files) are currently
  versioned as LIBDBUS_1_3; private symbols starting with _dbus or
  dbus_internal have a version that changes with each release, and
Simon McVittie's avatar
Simon McVittie committed
1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581
  must not be used by applications. (also fd.o #83115)

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

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

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

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

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

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

Simon McVittie's avatar
Simon McVittie committed
1588 1589 1590 1591 1592
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1593
D-Bus 1.9.12 (2015-02-19)
Simon McVittie's avatar
Simon McVittie committed
1594 1595
==

Simon McVittie's avatar
Simon McVittie committed
1596 1597 1598 1599
The monster lasagna release.

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1600 1601
 Ducktype and yelp-tools are now required to build complete documentation
  (they are optional for normal builds).
Simon McVittie's avatar
Simon McVittie committed
1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640

Enhancements:

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

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

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

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

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

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

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

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

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

Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1642
D-Bus 1.9.10 (2015-02-09)
Simon McVittie's avatar
Simon McVittie committed
1643 1644
==

1645
The sad cyborgs release.
1646

Simon McVittie's avatar
Simon McVittie committed
1647
Security fixes merged from 1.8.16:
1648 1649 1650 1651 1652 1653 1654 1655

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

Simon McVittie's avatar
Simon McVittie committed
1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679
Enhancements:

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

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

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

1680
Other fixes:
Simon McVittie's avatar
Simon McVittie committed
1681 1682 1683 1684 1685 1686

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

 On Unix, forcibly terminate regression tests after 60 seconds to
  prevent them from blocking continuous integration frameworks
  (fd.o #46787, Simon)
Simon McVittie's avatar
Simon McVittie committed
1687

1688
D-Bus 1.9.8 (2015-02-03)
Simon McVittie's avatar
Simon McVittie committed
1689 1690
==

1691 1692
The all the types of precipitation release.

Simon McVittie's avatar
Simon McVittie committed
1693 1694
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1695
 full test coverage now requires GLib 2.36
Simon McVittie's avatar
Simon McVittie committed
1696 1697 1698 1699
 full test coverage now requires PyGI (PyGObject 3,
  "import gi.repository.GObject") instead of the
  obsolete PyGObject 2 ("import gobject")

Simon McVittie's avatar
Simon McVittie committed
1700 1701 1702 1703 1704 1705 1706
Enhancements:

 add GLib-style "installed tests" (fd.o #88810, Simon McVittie)

 better regression test coverage, including systemd activation
  (fd.o #57952, #88810; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731
Fixes:

 fatal errors correctly make the dbus-daemon exit even if <syslog/> is
  turned off (fd.o #88808, Simon McVittie)

 TCP sockets on Windows no longer fail to listen approximately 1 time
  in 256, caused by a logic error that should have always made it fail but
  was mitigated by incorrect endianness for the port number
  (fd.o #87999, Ralf Habacker)

 fix some Windows build failures (fd.o #88009, #88010; Ralf Habacker)

 on Windows, allow up to 8K connections to the dbus-daemon instead of the
  previous 64, completing a previous fix which only worked under
  Autotools (fd.o #71297, Ralf Habacker)

 on Windows, if the IP family is unspecified only use IPv4,
  to mitigate IPv6 not working correctly (fd.o #87999, Ralf Habacker)

 fix some unlikely memory leaks on OOM (fd.o #88087, Simon McVittie)

 lcov code coverage analysis works again (fd.o #88808, Simon McVittie)

 fix an unused function error with --disable-embedded-tests (fd.o #87837,
  Thiago Macieira)
Simon McVittie's avatar
Simon McVittie committed
1732

1733
D-Bus 1.9.6 (2015-01-05)
Simon McVittie's avatar
Simon McVittie committed
1734 1735
==

1736
The I do have a bread knife release.
1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762

Security hardening:

 Do not allow calls to UpdateActivationEnvironment from uids other than
  the uid of the dbus-daemon. If a system service installs unsafe
  security policy rules that allow arbitrary method calls
  (such as CVE-2014-8148) then this prevents memory consumption and
  possible privilege escalation via UpdateActivationEnvironment.

  We believe that in practice, privilege escalation here is avoided
  by dbus-daemon-launch-helper sanitizing its environment; but
  it seems better to be safe.

 Do not allow calls to UpdateActivationEnvironment or the Stats interface
  on object paths other than /org/freedesktop/DBus. Some system services
  install unsafe security policy rules that allow arbitrary method calls
  to any destination, method and interface with a specified object path;
  while less bad than allowing arbitrary method calls, these security
  policies are still harmful, since dbus-daemon normally offers the
  same API on all object paths and other system services might behave
  similarly.

Other fixes:

 Add missing initialization so GetExtendedTcpTable doesn't crash on
  Windows Vista SP0 (fd.o #77008, Илья А. Ткаченко)
Simon McVittie's avatar
Simon McVittie committed
1763

Simon McVittie's avatar
Simon McVittie committed
1764
D-Bus 1.9.4 (2014-11-24)
Simon McVittie's avatar
Simon McVittie committed
1765 1766
==

Simon McVittie's avatar
Simon McVittie committed
1767 1768
The “extra-sturdy caramel” release.

Simon McVittie's avatar
Simon McVittie committed
1769 1770
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788
• Partially revert the CVE-2014-3639 patch by increasing the default
  authentication timeout on the system bus from 5 seconds back to 30
  seconds, since this has been reported to cause boot regressions for
  some users, mostly with parallel boot (systemd) on slower hardware.

  On fast systems where local users are considered particularly hostile,
  administrators can return to the 5 second timeout (or any other value
  in milliseconds) by saving this as /etc/dbus-1/system-local.conf:

  <busconfig>
    <limit name="auth_timeout">5000</limit>
  </busconfig>

  (fd.o #86431, Simon McVittie)

• Add a message in syslog/the Journal when the auth_timeout is exceeded
  (fd.o #86431, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1789 1790 1791
• Send back an AccessDenied error if the addressed recipient is not allowed
  to receive a message (and in builds with assertions enabled, don't
  assert under the same conditions). (fd.o #86194, Jacek Bukarewicz)
Simon McVittie's avatar
Simon McVittie committed
1792

Simon McVittie's avatar
Simon McVittie committed
1793
D-Bus 1.9.2 (2014-11-10)
1794 1795
==

Simon McVittie's avatar
Simon McVittie committed
1796 1797
The structurally unsound flapjack release.