Tmds.DBus.Protocol

Tmds.DBus.Generator

• Fixed DBusHandler code only being generated for the last interface when generating handler types for multiple interfaces (#445).

Tmds.DBus.Protocol

• Func<ValueTask> handler overloads added to avoid async void in user code (#440).

Tmds.DBus.Generator

• [Breaking] IReadableXxxProperties has been replaced with a unified IXxxProperties interface. Write-only properties are uncommon and the separate interface made explicit interface implementations more verbose (#441).
• Fix code generation for single-field D-Bus structs (#439).
• DBusHandler.ParseInterface now ignores missing interface string on Properties requests (#442).

Documentation

• Documentation rewritten into a single guide (#443).

0.93.0

Tmds.DBus.Protocol

• [Breaking] Previously obsoleted types and APIs have been removed (#426):
  • Connection - use DBusConnection instead.
  • ConnectionOptions - use DBusConnectionOptions instead.
  • ClientConnectionOptions - use DBusConnectionOptions instead.
  • ClientSetupResult - use DBusConnectionOptions.SetupResult instead.
  • Address - use DBusAddress instead.
  • ActionException - use ObserverHandler instead.
  • IMethodHandler - use IPathMethodHandler instead.
  • DBusException - use DBusErrorReplyException instead.
  • DisconnectedException - use DBusConnectionClosedException instead.
  • ConnectException - use DBusConnectFailedException instead.
  • ProtocolException - use DBusUnexpectedValueException instead.
  • MethodContext.Connection - use MethodContext.DBusConnection instead.
• AddMatchAsync overloads that accept Action<Exception?, T, object?, object?> are marked Obsolete. Use the new Action<Notification<T>> overloads instead (#427).
• Notification<T> / Notification / NotificationType: new callback API for signal observers, replacing the Action<Exception?, T, ...> pattern. Notifications distinguish between value, owner change, and completion events (#427).
• NameOwnerWatcher: tracks name ownership changes when calling methods and watching signals, enabling detection of service restarts. A DBusOwnerChangedException
  is thrown when a method call targets an owner identifier from NameOwnerWatcher and the owner has changed (#425).
• OnException handler on DBusConnectionOptions: provides exception reporting and disconnect control via the new ExceptionContext / ExceptionSource types (#431).

Tmds.DBus.Generator

• The generator can now produce handler (server-side) types for implementing D-Bus interfaces. To generate handlers, set the DBusGeneratorMode property to Handler, to generate proxies set it to Proxy. (#429, #433)
• [Breaking] Instead of a single action overload that accepts Action<Exception?, T>, the generator generates a simple overload that accepts Action<T> for users that are not interested in completion notifications, and an Action<Notification<T>> overload to be notified of completions. (#427)
• [Breaking] To enable handler code to generate an IXxxProperties interface, the generated proxy code changed as follows:
  • The GetPropertiesAsync method now returns the concrete XxxProperties class. When trying to get properties that were not set the get accessor throws. Alternatively, users can call GetNullablePropertiesAsync which returns an INullableXxxProperties interface which returns null for properties that are not set.
  • The WatchPropertiesChanged methods use a new IChangedXxxProperties interface.

This release addresses vulnerabilities from malicious senders in Tmds.DBus and Tmds.DBus.Protocol:

• Check the signal sender is the owner of the well-known name (fb41b95, b429873)
• Prevent spilling of unix fds to the next message and limit the number to 16 per message (4800917, f90642d)
• Prevent unhandled exceptions on SynchronizationContext due to a malformed body sent by a malicious sender. (f0d9d0b, a64b8b9)

Advisory: GHSA-xrw6-gwf8-vvr9

Tmds.DBus.Generator/Tmds.DBus.Tool:

• ProtocolGenerator: fix alignment when reading structs. (#422)

Changes:

• Protocol: SignatureReader: mark type as Obsolete and remove dead code. (#416)

Bug fixes/improvements:

• Protocol: change send message methods to be void instead of ValueTask. (#404)
• Protocol: Reader: fix ReverseDoubleEndianness returning unreversed value on pre-.NET8 targets. (#407)
• Protocol.Reader: limit array sizes to D-Bus max array length (64 MiB). (#408)
• Protocol.Message: skip unknown header fields. (#409)
• Protocol: enforce D-Bus max message length (128 MiB) (#410)
• Fix DBusType.Signature alignment from 4 to 1. (#411)
• Protocol: AddressReader: fix Unescape and TryGetNext off-by-one errors. (#412)
• Protocol: DBusAddress: improve resource cleanup for X11/Windows, refactor system/session address initialization. (#413)
• Protocol: Reader: enforce max recursion depth (64) when reading variant values. (#415)
• Protocol: Reader: ensure ReadSpan throws DBusReadException when null terminator byte is missing. (#414)
• Protocol: Array/Struct/Dict: fix check for unsupported composite types. (#418)
• Protocol: VariantValue: fix GetDictionaryEntry type check, fix GetStructFieldType out-of-bounds check. (#417)
• Protocol: MessageWriter: use Unsafe.SizeOf for JIT constant size. (#419)
• Protocol: PathNodeDictionary: simplify batch RemoveMethodHandlers. (#420)

This release backports the fixes from 0.92.0 to Tmds.DBus.Protocol.

Advisory: GHSA-xrw6-gwf8-vvr9