# kistler-group/sdbus-cpp architecture

> Architecture diagram of the GitHub repository kistler-group/sdbus-cpp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kistler-group/sdbus-cpp
- Repository: https://github.com/kistler-group/sdbus-cpp

## Overview

sdbus-c++ is a high-level C++ D-Bus IPC library over sd-bus. Its principal workflow lets an application create a connection and proxy to call a remote service, or expose an object whose registered methods, properties, and signals are reachable over D-Bus. The repository also includes an optional XML-IDL-to-C++ binding generator. The graph reflects documented capabilities and indexed imports; source excerpts are partial, so some runtime dispatch details are not shown.

Main entry points: [`src/Proxy.cpp`](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Proxy.cpp) (Proxy runtime), [`tools/xml2cpp-codegen/xml2cpp.cpp`](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/xml2cpp.cpp) (xml2cpp tool), [`src/Object.cpp`](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Object.cpp) (Object runtime), [`src/Message.cpp`](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Message.cpp) (Message encoding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["C++ API"]
  node_connection_api["Connection API<br/>[IConnection.h]"]
  node_proxy_api["Proxy API<br/>[IProxy.h]"]
  node_object_api["Object API<br/>[IObject.h]"]
  node_message_api["Message API<br/>[Message.h]"]
  node_type_traits["Type traits<br/>[TypeTraits.h]"]
end

subgraph group_runtime["D-Bus Runtime"]
  node_connection["Connection runtime<br/>[Connection.cpp]"]
  node_proxy["Proxy runtime<br/>[Proxy.cpp]"]
  node_object["Object runtime<br/>[Object.cpp]"]
  node_message["Message encoding<br/>[Message.cpp]"]
  node_runtime_interfaces["Runtime interfaces<br/>[IConnection.h]"]
  node_sd_bus_adapter["sd-bus adapter<br/>[SdBus.cpp]"]
end

subgraph group_codegen["Binding Generator"]
  node_xml2cpp["xml2cpp tool<br/>[xml2cpp.cpp]"]
  node_xml_parser["XML document model<br/>[xml.cpp]"]
  node_base_generator["Generator base<br/>[BaseGenerator.cpp]"]
  node_adaptor_generator["Adaptor generator"]
  node_proxy_generator["Proxy generator<br/>[ProxyGenerator.cpp]"]
end

node_app(("C++ application"))
node_remote_service(("Remote D-Bus service"))
node_generated_bindings["Generated C++ bindings"]

node_app -->|"creates connection"| node_connection_api
node_app -->|"uses proxy"| node_proxy_api
node_app -->|"exposes object"| node_object_api
node_proxy_api -->|"implemented by"| node_proxy
node_object_api -->|"implemented by"| node_object
node_connection_api -->|"implemented by"| node_connection
node_connection -->|"uses"| node_runtime_interfaces
node_proxy -->|"uses"| node_runtime_interfaces
node_object -->|"uses"| node_runtime_interfaces
node_connection -->|"calls sd-bus"| node_sd_bus_adapter
node_proxy -->|"sends calls"| node_message
node_object -->|"emits signals"| node_message
node_message_api -->|"implemented by"| node_message
node_message -->|"uses"| node_runtime_interfaces
node_type_traits -->|"types values"| node_message_api
node_proxy -->|"calls methods"| node_remote_service
node_remote_service -->|"invokes exposed API"| node_object
node_app -->|"runs generator"| node_xml2cpp
node_xml2cpp -->|"parses IDL"| node_xml_parser
node_xml2cpp -->|"selects generator"| node_adaptor_generator
node_xml2cpp -->|"selects generator"| node_proxy_generator
node_adaptor_generator -->|"uses base"| node_base_generator
node_proxy_generator -->|"uses base"| node_base_generator
node_adaptor_generator -->|"writes bindings"| node_generated_bindings
node_proxy_generator -->|"writes bindings"| node_generated_bindings

click node_connection_api "https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IConnection.h"
click node_proxy_api "https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IProxy.h"
click node_object_api "https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IObject.h"
click node_message_api "https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/Message.h"
click node_type_traits "https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/TypeTraits.h"
click node_connection "https://github.com/kistler-group/sdbus-cpp/blob/master/src/Connection.cpp"
click node_proxy "https://github.com/kistler-group/sdbus-cpp/blob/master/src/Proxy.cpp"
click node_object "https://github.com/kistler-group/sdbus-cpp/blob/master/src/Object.cpp"
click node_message "https://github.com/kistler-group/sdbus-cpp/blob/master/src/Message.cpp"
click node_runtime_interfaces "https://github.com/kistler-group/sdbus-cpp/blob/master/src/IConnection.h"
click node_sd_bus_adapter "https://github.com/kistler-group/sdbus-cpp/blob/master/src/SdBus.cpp"
click node_xml2cpp "https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/xml2cpp.cpp"
click node_xml_parser "https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/xml.cpp"
click node_base_generator "https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/BaseGenerator.cpp"
click node_adaptor_generator "https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/AdaptorGenerator.cpp"
click node_proxy_generator "https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/ProxyGenerator.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_connection_api,node_proxy_api,node_object_api,node_message_api,node_type_traits toneBlue
class node_connection,node_proxy,node_object,node_message,node_runtime_interfaces,node_sd_bus_adapter toneAmber
class node_xml2cpp,node_xml_parser,node_base_generator,node_adaptor_generator,node_proxy_generator toneMint
class node_app,node_remote_service,node_generated_bindings toneIndigo
```

## Components

### C++ API

- [Connection API](https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IConnection.h): `include/sdbus-c++/IConnection.h`
- [Proxy API](https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IProxy.h): `include/sdbus-c++/IProxy.h`
- [Object API](https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/IObject.h): `include/sdbus-c++/IObject.h`
- [Message API](https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/Message.h): `include/sdbus-c++/Message.h`
- [Type traits](https://github.com/kistler-group/sdbus-cpp/blob/master/include/sdbus-c%2B%2B/TypeTraits.h): `include/sdbus-c++/TypeTraits.h`

### D-Bus Runtime

- [Connection runtime](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Connection.cpp): `src/Connection.cpp`
- [Proxy runtime](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Proxy.cpp): `src/Proxy.cpp`
- [Object runtime](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Object.cpp): `src/Object.cpp`
- [Message encoding](https://github.com/kistler-group/sdbus-cpp/blob/master/src/Message.cpp): `src/Message.cpp`
- [Runtime interfaces](https://github.com/kistler-group/sdbus-cpp/blob/master/src/IConnection.h): `src/IConnection.h`
- [sd-bus adapter](https://github.com/kistler-group/sdbus-cpp/blob/master/src/SdBus.cpp): `src/SdBus.cpp`

### Binding Generator

- [xml2cpp tool](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/xml2cpp.cpp): `tools/xml2cpp-codegen/xml2cpp.cpp`
- [XML document model](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/xml.cpp): `tools/xml2cpp-codegen/xml.cpp`
- [Generator base](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/BaseGenerator.cpp): `tools/xml2cpp-codegen/BaseGenerator.cpp`
- [Adaptor generator](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/AdaptorGenerator.cpp): `tools/xml2cpp-codegen/AdaptorGenerator.cpp`
- [Proxy generator](https://github.com/kistler-group/sdbus-cpp/blob/master/tools/xml2cpp-codegen/ProxyGenerator.cpp): `tools/xml2cpp-codegen/ProxyGenerator.cpp`

### Other components

- **C++ application**
- **Remote D-Bus service**
- **Generated C++ bindings**

## Connections

- C++ application → Connection API: creates connection (evidence: `README`)
- C++ application → Proxy API: uses proxy (evidence: `README`)
- C++ application → Object API: exposes object (evidence: `README`)
- Proxy API → Proxy runtime: implemented by (evidence: `src/Proxy.cpp`)
- Object API → Object runtime: implemented by (evidence: `src/Object.cpp`)
- Connection API → Connection runtime: implemented by (evidence: `src/Connection.cpp`)
- Connection runtime → Runtime interfaces: uses (evidence: `src/Connection.cpp`)
- Proxy runtime → Runtime interfaces: uses (evidence: `src/Proxy.cpp`)
- Object runtime → Runtime interfaces: uses (evidence: `src/Object.cpp`)
- Connection runtime → sd-bus adapter: calls sd-bus (evidence: `src/Connection.cpp`)
- Proxy runtime → Message encoding: sends calls (evidence: `src/Proxy.cpp`)
- Object runtime → Message encoding: emits signals (evidence: `src/Object.cpp`)
- Message API → Message encoding: implemented by (evidence: `src/Message.cpp`)
- Message encoding → Runtime interfaces: uses (evidence: `src/Message.cpp`)
- Type traits → Message API: types values (evidence: `include/sdbus-c++/Message.h`)
- Proxy runtime → Remote D-Bus service: calls methods (evidence: `README`)
- Remote D-Bus service → Object runtime: invokes exposed API (evidence: `README`)
- C++ application → xml2cpp tool: runs generator (evidence: `README`)
- xml2cpp tool → XML document model: parses IDL (evidence: `tools/xml2cpp-codegen/xml2cpp.cpp`)
- xml2cpp tool → Adaptor generator: selects generator (evidence: `tools/xml2cpp-codegen/xml2cpp.cpp`)
- xml2cpp tool → Proxy generator: selects generator (evidence: `tools/xml2cpp-codegen/xml2cpp.cpp`)
- Adaptor generator → Generator base: uses base (evidence: `tools/xml2cpp-codegen/AdaptorGenerator.cpp`)
- Proxy generator → Generator base: uses base (evidence: `tools/xml2cpp-codegen/ProxyGenerator.cpp`)
- Adaptor generator → Generated C++ bindings: writes bindings (evidence: `README`)
- Proxy generator → Generated C++ bindings: writes bindings (evidence: `README`)
