NEWS 121 KB
Newer Older
1 2 3
dbus 1.13.6 (UNRELEASED)
========================

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

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

Simon McVittie's avatar
Simon McVittie committed
13
dbus 1.13.4 (2018-04-30)
Simon McVittie's avatar
Simon McVittie committed
14 15
========================

16 17
The “parsimonious topping” release.

18 19 20 21 22 23
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.)

24 25
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
26
 D-Bus Specification v0.33
Simon McVittie's avatar
Simon McVittie committed
27 28 29 30 31
  · 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)

32 33 34 35 36 37 38 39 40 41 42
 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
43

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

47 48 49 50 51 52 53 54 55 56 57 58
• 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)

59 60 61
• The Devhelp documentation index is now in version 2 format
  (fd.o #106186, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
62
• Give the dbus-daemon man page some scarier warnings about
63 64
  <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
65 66
  (fd.o #106004, Simon McVittie)

67 68 69 70 71
Fixes:

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

72 73 74
• Fix installation of Ducktype documentation with newer yelp-build
  versions (fd.o #106171, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
75 76 77 78 79 80 81 82 83
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
84
dbus 1.13.2 (2018-03-01)
Simon McVittie's avatar
Simon McVittie committed
85 86
========================

Simon McVittie's avatar
Simon McVittie committed
87 88
The “can break a man's arm release.

89 90 91 92 93 94
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
95

Simon McVittie's avatar
Simon McVittie committed
96 97 98
Fixes:

 Increase system dbus-daemon's RLIMIT_NOFILE rlimit before it drops
99 100 101
  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
102 103
  (fd.o #105165, David King)

Simon McVittie's avatar
Simon McVittie committed
104
dbus 1.13.0 (2018-02-08)
105 106
========================

Simon McVittie's avatar
Simon McVittie committed
107 108
The Citispeed Eco 75 release.

109 110 111 112 113
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
114 115 116 117
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
118 119 120 121 122 123 124 125 126 127 128
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)

129 130
Enhancements:

Simon McVittie's avatar
Simon McVittie committed
131 132 133 134 135
• 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
136 137
  · Clarify how the SASL authentication handshake works
    (fd.o #104224, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
138 139 140 141
  · 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
142

Simon McVittie's avatar
Simon McVittie committed
143 144 145 146 147
 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)

148 149
 Improve automated test logging (fd.o #103601, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
150 151 152 153 154 155
 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
156 157
Fixes:

Simon McVittie's avatar
Simon McVittie committed
158 159 160 161 162 163 164
 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
165 166 167 168 169
• 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
170 171 172 173 174 175 176 177 178 179 180 181 182
• 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
183 184
 Add a missing space to a warning message (fd.o #103729, Thomas Zajic)

Simon McVittie's avatar
Simon McVittie committed
185 186 187
 Fix some memory leaks in automated tests
  (fd.o #103600, Simon McVittie)

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

191 192
 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
193 194
  (fd.o #104577, Chris Lesiak)

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

197 198 199 200 201 202 203
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
204

Simon McVittie's avatar
Simon McVittie committed
205 206 207 208 209 210 211 212
• 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)

213 214 215
• 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
216 217 218
• Simplify method calls in automated tests
  (fd.o #103600, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
219
dbus 1.12.2 (2017-11-13)
220 221
========================

Simon McVittie's avatar
Simon McVittie committed
222
The “spider pumpkin” release.
223

Simon McVittie's avatar
Simon McVittie committed
224 225 226 227 228 229
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
230 231 232 233 234
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
235 236 237 238
• 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
239 240 241 242 243 244
• 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
245 246
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
249
dbus 1.12.0 (2017-10-30)
250 251
========================

Simon McVittie's avatar
Simon McVittie committed
252 253 254 255
The “gingerbread skull” release.

1.12.x is a new stable branch, recommended for use in OS
distributions.
256 257 258 259 260 261

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

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
262
• Expat >= 2.1.0 is required.
263 264 265 266 267 268 269
• 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
270
• [CMake] Builds done using CMake now require CMake 3.0.2.
271 272 273 274 275 276 277 278 279 280 281 282 283 284

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
285 286 287 288
• [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.
289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329
• [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
330 331
• [Unix] Exceeding an anti-DoS limit is logged to syslog if configured,
  or to stderr.
332

Simon McVittie's avatar
Simon McVittie committed
333 334 335 336
Changes since 1.11.22 release candidate
---------------------------------------

Standard stable-branch changes:
337

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

Simon McVittie's avatar
Simon McVittie committed
340 341 342 343 344 345 346 347 348
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)
349

Simon McVittie's avatar
Simon McVittie committed
350
D-Bus 1.11.22 (2017-10-23)
351
==========================
352

Simon McVittie's avatar
Simon McVittie committed
353 354 355 356
The fire surface release.

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

Simon McVittie's avatar
Simon McVittie committed
357 358 359 360 361 362 363 364 365 366 367
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.

368 369 370 371 372
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
373 374 375 376 377 378 379 380 381
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
382 383 384
• 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
385 386 387 388
Internal changes:

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

Simon McVittie's avatar
Simon McVittie committed
390
D-Bus 1.11.20 (2017-10-03)
391 392
==

393 394
The “wraith stun” release.

Simon McVittie's avatar
Simon McVittie committed
395 396 397
Build-time configuration changes:

• The --enable-abstract-sockets and --disable-abstract-sockets options
Simon McVittie's avatar
Simon McVittie committed
398 399 400
  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
401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422

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

Simon McVittie's avatar
Simon McVittie committed
424
D-Bus 1.11.18 (2017-09-25)
Simon McVittie's avatar
Simon McVittie committed
425 426
==

Simon McVittie's avatar
Simon McVittie committed
427 428
The “vampire conquistador” release.

429 430 431 432 433 434 435 436 437 438 439 440 441
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)

442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466
• 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
467 468 469 470 471 472 473 474
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
475 476 477 478 479 480 481 482 483 484 485
 <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
486 487 488 489 490 491 492 493
 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
494 495 496 497 498 499 500 501 502 503
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
504

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

Simon McVittie's avatar
Simon McVittie committed
508 509 510 511
• 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
512
D-Bus 1.11.16 (2017-07-27)
513 514
==

Simon McVittie's avatar
Simon McVittie committed
515 516
The “south facing garden” release.

Simon McVittie's avatar
Simon McVittie committed
517 518 519 520 521 522 523 524
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)
525

526 527 528 529 530 531 532 533 534 535
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
536 537 538 539
• Fix the implementation of re-enabling a timeout (again) so that its
  countdown is always restarted as intended. (fd.o #95619,
  Michal Koutný)

540 541 542
• 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)

543 544 545 546 547 548 549 550 551 552 553 554 555 556 557
 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
558 559 560
 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
561 562 563
 Make build-time tests cope with finding Python 3, but not Python 2
  (fd.o #101716, Simon McVittie)

564 565 566 567 568 569 570 571 572 573 574 575
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
576
D-Bus 1.11.14 (2017-06-29)
Simon McVittie's avatar
Simon McVittie committed
577 578
==

Simon McVittie's avatar
Simon McVittie committed
579 580
The irrational fear of bees release.

Simon McVittie's avatar
Simon McVittie committed
581 582
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
583 584 585
 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
586

Simon McVittie's avatar
Simon McVittie committed
587 588 589 590 591 592 593 594 595 596 597 598 599 600
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
601

Simon McVittie's avatar
Simon McVittie committed
602 603 604
 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
605

Simon McVittie's avatar
Simon McVittie committed
606 607 608 609 610 611 612 613 614 615 616 617 618 619 620
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)

621 622 623 624 625 626 627
 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
628 629 630 631 632 633 634
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
635
  · Describe all message bus methods in the same section
Simon McVittie's avatar
Simon McVittie committed
636
  · Clarify the correct object path for method calls to the message bus
Simon McVittie's avatar
Simon McVittie committed
637 638 639 640 641
    (/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
642 643
  · Add unix:dir=..., which resembles unix:tmpdir=... but never uses
    abstract sockets
644 645 646
  · 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
647
  (fd.o #99825, #100686, #100795, #101256, #101257, #101567;
Simon McVittie's avatar
Simon McVittie committed
648 649 650 651
  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
652

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

Simon McVittie's avatar
Simon McVittie committed
660 661 662
 Implement GetConnectionSELinuxSecurityContext("org.freedesktop.DBus")
  (fd.o #101315, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
663 664 665
 Avoid deprecated API calls when using SELinux
  (fd.o #100912, Laurent Bigonville)

Simon McVittie's avatar
Simon McVittie committed
666 667 668 669
 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)

670 671 672 673 674 675 676
 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
677 678 679 680
• 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
681 682
Fixes:

683 684 685
• 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
686 687 688
• 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
689 690 691

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

Simon McVittie's avatar
Simon McVittie committed
692 693 694 695 696 697
 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)

698 699 700 701
Documentation:

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

Simon McVittie's avatar
Simon McVittie committed
703
D-Bus 1.11.12 (2017-04-07)
Simon McVittie's avatar
Simon McVittie committed
704 705
==

Simon McVittie's avatar
Simon McVittie committed
706 707
The it's something humans do” release.

Simon McVittie's avatar
Simon McVittie committed
708 709 710 711 712 713 714 715
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
716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734
• 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
735 736 737 738 739 740 741
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
742

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

Simon McVittie's avatar
Simon McVittie committed
745 746 747
• 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
748 749 750
• Fix some typos in test code
  (fd.o #99999, Coverity #141876, #141877; Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
751 752 753
• 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
754
• Fix and enable compiler warnings related to -Wswitch
Simon McVittie's avatar
Simon McVittie committed
755 756
  (fd.o #98191; Thomas Zimmermann, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
757 758 759
• 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
760
D-Bus 1.11.10 (2017-02-16)
Simon McVittie's avatar
Simon McVittie committed
761 762
==

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

Simon McVittie's avatar
Simon McVittie committed
765 766 767 768 769 770 771 772 773 774
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
775
  the default (fd.o #98889, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
776

Simon McVittie's avatar
Simon McVittie committed
777
• Avoid some deprecated CMake functions (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
778 779 780 781

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

Simon McVittie's avatar
Simon McVittie committed
782 783 784 785 786 787 788 789 790 791
• 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
792 793
Fixes:

Simon McVittie's avatar
Simon McVittie committed
794 795 796 797 798 799 800 801 802
• 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
803
  transports and authentication mechanisms enabled by default.
Simon McVittie's avatar
Simon McVittie committed
804 805 806 807 808 809

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

Simon McVittie's avatar
Simon McVittie committed
811 812 813 814 815 816 817 818 819 820 821 822 823 824
• 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
825
  for Windows with CMake (fd.o #99586, Ralf Habacker)
Simon McVittie's avatar
Simon McVittie committed
826 827

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

Simon McVittie's avatar
Simon McVittie committed
830 831 832
• 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
833 834
• 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
835

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

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

Simon McVittie's avatar
Simon McVittie committed
842 843 844
• 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
845 846 847 848 849 850
 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
851
• Improve error handling in unit tests and dbus-send
Simon McVittie's avatar
Simon McVittie committed
852 853 854 855
  (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
856 857 858 859

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

860
D-Bus 1.11.8 (2016-11-28)
Simon McVittie's avatar
Simon McVittie committed
861 862
==

863 864
The panics in the face of breakfast foods release.

Simon McVittie's avatar
Simon McVittie committed
865 866 867 868 869 870 871 872 873 874 875 876 877
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
878 879 880 881 882
 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
883 884
  · Clarify intended behaviour of Properties.GetAll
  (fd.o #36190, fd.o #98671; Philip Withnall, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
885

Simon McVittie's avatar
Simon McVittie committed
886 887 888
 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.
889 890 891 892
  · 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
893 894 895
  (fd.o #97357, fd.o #98192, fd.o #98195, fd.o #98658;
  Thomas Zimmermann, Simon McVittie)

896 897 898 899 900 901 902
 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
903 904 905 906 907 908 909 910 911 912 913
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
914

Simon McVittie's avatar
Simon McVittie committed
915 916 917 918
 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)

919
D-Bus 1.11.6 (2016-10-10)
Simon McVittie's avatar
Simon McVittie committed
920 921
==

922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939
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
940 941 942 943 944 945 946 947 948 949 950 951 952 953
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
954 955 956
• Install introspect.dtd and busconfig.dtd to ${datadir}/xml/dbus-1
  (fd.o #89011, Philip Withnall)

Simon McVittie's avatar
Simon McVittie committed
957 958 959 960 961 962
• 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)

963 964 965 966 967 968
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
969

Simon McVittie's avatar
Simon McVittie committed
970 971 972
• 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
973 974 975 976
• 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
977

Simon McVittie's avatar
Simon McVittie committed
978
D-Bus 1.11.4 (2016-08-15)
Simon McVittie's avatar
Simon McVittie committed
979 980
==

Simon McVittie's avatar
Simon McVittie committed
981 982
The “copper pickaxe” release.

983 984 985 986 987 988 989 990 991 992 993
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
994 995 996 997 998 999 1000 1001 1002
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
1003 1004
• Add a new dbus-launch --exit-with-x11 option (fd.o #39197, Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1005 1006 1007 1008 1009 1010
• 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
1011 1012 1013
• On Unix, unify the various places that reopen stdin, stdout and/or stderr
  pointing to /dev/null (fd.o #97008, Simon McVittie)

1014 1015 1016
• Use AX_CODE_COVERAGE instead of our own COMPILER_COVERAGE
  (fd.o #88922, Thomas Zimmermann)

Simon McVittie's avatar
Simon McVittie committed
1017 1018
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1022 1023 1024 1025
• 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
1026 1027 1028 1029
• 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
1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040
• 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
1041

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

Simon McVittie's avatar
Simon McVittie committed
1044 1045 1046 1047 1048 1049 1050 1051 1052
• 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
1053 1054 1055
• update-activation-environment: produce better diagnostics on error
  (fd.o #96653, Simon McVittie)

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

Simon McVittie's avatar
Simon McVittie committed
1059 1060 1061 1062 1063 1064
• 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
1065
D-Bus 1.11.2 (2016-03-07)
Simon McVittie's avatar
Simon McVittie committed
1066 1067
==

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

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

Simon McVittie's avatar
Simon McVittie committed
1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116
• 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
1117
D-Bus 1.11.0 (2015-12-02)
Simon McVittie's avatar
Simon McVittie committed
1118 1119
==

Simon McVittie's avatar
Simon McVittie committed
1120 1121
The “peppermint deer” release.

Simon McVittie's avatar
Simon McVittie committed
1122 1123
Dependencies:

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

1127 1128 1129 1130 1131 1132
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
1133 1134 1135 1136 1137 1138 1139 1140
• 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
1141 1142
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1143 1144 1145 1146
• 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)

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

Simon McVittie's avatar
Simon McVittie committed
1149 1150 1151 1152 1153 1154 1155
• 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)

1156 1157 1158 1159
 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
1160 1161
 Add support for backtraces on Windows (fd.o #92721, Ralf Habacker)

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

Simon McVittie's avatar
Simon McVittie committed
1164
D-Bus 1.10.6 (2015-12-01)
Simon McVittie's avatar
Simon McVittie committed
1165 1166
==

Simon McVittie's avatar
Simon McVittie committed
1167 1168
The marzipan beetles release.

Simon McVittie's avatar
Simon McVittie committed
1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181
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
1182
D-Bus 1.10.4 (2015-11-17)
Simon McVittie's avatar
Simon McVittie committed
1183 1184
==

Simon McVittie's avatar
Simon McVittie committed
1185 1186
The Frostburn Canyon release.

Simon McVittie's avatar
Simon McVittie committed
1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208
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
1209 1210 1211
• On Windows, don't crash if <syslog/> or --syslog is used
  (fd.o #92538, Ralf Habacker)

Simon McVittie's avatar
Simon McVittie committed
1212 1213 1214 1215 1216 1217 1218
 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
1219 1220 1221 1222 1223 1224 1225 1226 1227
  · 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
1228
  · skip some system bus tests on Windows since they make no sense there
Simon McVittie's avatar
Simon McVittie committed
1229
  (fd.o #92538, fd.o #92721; Ralf Habacker, Simon McVittie)
Simon McVittie's avatar
Simon McVittie committed
1230

Simon McVittie's avatar
Simon McVittie committed
1231
D-Bus 1.10.2 (2015-10-26)
Simon McVittie's avatar
Simon McVittie committed
1232 1233
==

Simon McVittie's avatar
Simon McVittie committed
1234 1235
The “worst pies in London” release.

Simon McVittie's avatar
Simon McVittie committed
1236 1237
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1238 1239 1240 1241 1242
• 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
1243 1244 1245 1246 1247
• 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
1248 1249 1250 1251
 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
1252 1253
 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
1254

Simon McVittie's avatar
Simon McVittie committed
1255 1256 1257 1258
• 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
1259 1260 1261
• Make more of the regression tests pass in Windows builds (fd.o #92538,
  Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1262
D-Bus 1.10.0 (2015-08-25)
Simon McVittie's avatar
Simon McVittie committed
1263 1264
==

Simon McVittie's avatar
Simon McVittie committed
1265 1266 1267 1268 1269 1270 1271 1272 1273 1274
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)

1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317
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
1318 1319
 org.freedesktop.DBus.Verbose interface (not normally compiled)
  · toggles the effect of DBUS_VERBOSE
1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344

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
1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356
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
1357

Simon McVittie's avatar
Simon McVittie committed
1358
D-Bus 1.9.18 (2015-07-21)
Simon McVittie's avatar
Simon McVittie committed
1359 1360
==

Simon McVittie's avatar
Simon McVittie committed
1361 1362
The Pirate Elite release.

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

Simon McVittie's avatar
Simon McVittie committed
1389 1390 1391 1392
Fixes:

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

Simon McVittie's avatar
Simon McVittie committed
1394 1395
• 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
1396

Simon McVittie's avatar
Simon McVittie committed
1397
D-Bus 1.9.16 (2015-05-14)
1398 1399
==

1400 1401 1402 1403 1404 1405 1406
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
1407 1408 1409 1410 1411 1412 1413
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
1414
  unpredictable pseudo-random numbers.
Simon McVittie's avatar
Simon McVittie committed
1415 1416 1417 1418 1419 1420 1421 1422 1423

  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
1424 1425 1426 1427 1428 1429
• 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
1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440
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)

1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452
• 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
1453 1454 1455 1456 1457 1458 1459 1460 1461
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
1462
  of memory while copying authentication mechanisms (fd.o #90021,
Simon McVittie's avatar
Simon McVittie committed
1463 1464
  Ralf Habacker)

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

1468 1469
 Correctly initialize all fields of DBusTypeReader (fd.o #90021;
  Ralf Habacker, Simon McVittie)
1470

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

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

1477 1478 1479 1480 1481 1482
 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
1483
D-Bus 1.9.14 (2015-03-02)
Simon McVittie's avatar
Simon McVittie committed
1484 1485
==

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

Simon McVittie's avatar
Simon McVittie committed
1488 1489 1490 1491 1492
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
1493 1494 1495 1496 1497 1498 1499 1500 1501 1502
• 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
1503 1504 1505 1506 1507 1508 1509 1510 1511 1512
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
1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530
  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
1531 1532 1533
 <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
1534 1535
 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
1536

Simon McVittie's avatar
Simon McVittie committed
1537 1538 1539 1540 1541
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
1542
D-Bus 1.9.12 (2015-02-19)
Simon McVittie's avatar
Simon McVittie committed
1543 1544
==

Simon McVittie's avatar
Simon McVittie committed
1545 1546 1547 1548
The monster lasagna release.

Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1549 1550
 Ducktype and yelp-tools are now required to build complete documentation
  (they are optional for normal builds).
Simon McVittie's avatar
Simon McVittie committed
1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589

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
1590

Simon McVittie's avatar
Simon McVittie committed
1591
D-Bus 1.9.10 (2015-02-09)
Simon McVittie's avatar
Simon McVittie committed
1592 1593
==

1594
The sad cyborgs release.
1595

Simon McVittie's avatar
Simon McVittie committed
1596
Security fixes merged from 1.8.16:
1597 1598 1599 1600 1601 1602 1603 1604

 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
1605
  so the attack only works while the real service is not running.
1606 1607
  (CVE-2015-0245, fd.o #88811; Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628
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)

1629
Other fixes:
Simon McVittie's avatar
Simon McVittie committed
1630 1631 1632 1633 1634 1635

 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
1636

1637
D-Bus 1.9.8 (2015-02-03)
Simon McVittie's avatar
Simon McVittie committed
1638 1639
==

1640 1641
The all the types of precipitation release.

Simon McVittie's avatar
Simon McVittie committed
1642 1643
Dependencies:

Simon McVittie's avatar
Simon McVittie committed
1644
 full test coverage now requires GLib 2.36
Simon McVittie's avatar
Simon McVittie committed
1645 1646 1647 1648
 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
1649 1650 1651 1652 1653 1654 1655
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
1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680
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
1681

1682
D-Bus 1.9.6 (2015-01-05)
Simon McVittie's avatar
Simon McVittie committed
1683 1684
==

1685
The I do have a bread knife release.
1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711

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
1712

Simon McVittie's avatar
Simon McVittie committed
1713
D-Bus 1.9.4 (2014-11-24)
Simon McVittie's avatar
Simon McVittie committed
1714 1715
==

Simon McVittie's avatar
Simon McVittie committed
1716 1717
The “extra-sturdy caramel” release.

Simon McVittie's avatar
Simon McVittie committed
1718 1719
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737
• 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
1738 1739 1740
• 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
1741

Simon McVittie's avatar
Simon McVittie committed
1742
D-Bus 1.9.2 (2014-11-10)
1743 1744
==

Simon McVittie's avatar
Simon McVittie committed
1745 1746
The structurally unsound flapjack release.

1747 1748 1749 1750 1751 1752
Security fixes:

 Increase dbus-daemon's RLIMIT_NOFILE rlimit to 65536
  so that CVE-2014-3636 part A cannot exhaust the system bus'
  file descriptors, completing the incomplete fix in 1.8.8.
  (CVE-2014-7824, fd.o #85105; Simon McVittie, Alban Crequy)
Simon McVittie's avatar
Simon McVittie committed
1753

1754 1755
Enhancements:

1756
 D-Bus Specification version 0.25
Simon McVittie's avatar
Simon McVittie committed
1757 1758 1759 1760
  · new value 'const' for EmitsChangedSignal annotation
    (fd.o #72958, Lennart Poettering)
  · new ALLOW_INTERACTIVE_AUTHORIZATION flag, for PolicyKit and similar
    (fd.o #83449; Lennart Poettering, Simon McVittie)
1761 1762 1763
  · annotate table of types with reserved/basic/container, and for
    basic types, fixed/string-like
  · clarify arbitrary limits by quoting them in mebibytes
Simon McVittie's avatar
Simon McVittie committed
1764 1765 1766

 New API: add accessors for the ALLOW_INTERACTIVE_AUTHORIZATION flag
  (fd.o #83449, Simon McVittie)
1767

Simon McVittie's avatar
Simon McVittie committed
1768 1769 1770 1771 1772 1773 1774
 Add dbus-test-tool, a D-Bus swiss army knife with multiple subcommands,
  useful for debugging and performance testing:
  · dbus-test-tool spam: send repeated messages
  · dbus-test-tool echo: send an empty reply for all method calls
  · dbus-test-tool black-hole: do not reply to method calls
  (fd.o #34140; Alban Crequy, Simon McVittie, Will Thompson)

Simon McVittie's avatar
Simon McVittie committed
1775 1776 1777
 Add support for process ID in credentials-passing on NetBSD
  (fd.o #69702, Patrick Welche)

1778 1779 1780
 Add an example script to find potentially undesired match rules
  (fd.o #84598, Alban Crequy)

Simon McVittie's avatar
Simon McVittie committed
1781 1782 1783 1784 1785 1786 1787
 Document the central assumption that makes our use of credentials-passing
  secure (fd.o #83499, Simon McVittie)

 Replace the dbus-glib section of the tutorial with a GDBus recommendation,
  and add some links to GDBus and QtDBus documentation (fd.o #25140,
  Simon McVittie)

Simon McVittie's avatar
Simon McVittie committed
1788 1789
Fixes:

Simon McVittie's avatar
Simon McVittie committed
1790 1791 1792
 Use a less confusing NoReply message when disconnected with a reply pending
  (fd.o #76112, Simon</