RAUC for Rust ✨
Async Rust bindings for the RAUC D-Bus installer API, built with zbus.
Installation · Usage · Examples · API docs · Contributing
Compatibility
| Component | Support |
|---|---|
| Platform | Linux |
| Connection | System bus |
| Interface | de.pengutronix.rauc.Installer |
| RAUC | RAUC_VERSION |
| Rust | 1.89+ |
| zbus | 6.x |
Installation
Usage
Connect to the system bus and query slot status:
use InstallerProxy;
use ;
async
See the API documentation for all available methods and types.
Examples
Inspect and monitor
# Each read-only example is named after its RAUC operation
# Bundle inspection takes a path or URL
# Receives installation progress changes
# Receives the installation-completed signal
Modify the system
[!CAUTION] Installing bundles and marking slots modify the target system.
# Marks a slot as good, bad, or active
# Installs a specified bundle
Initial interface generation
The initial bindings were generated from RAUC's official installer interface for the release in RAUC_VERSION:
RAUC_VERSION=
RAUC_INTERFACE=de.pengutronix.rauc.Installer.xml
[!NOTE] This records the original setup, not an ongoing maintenance workflow.
Contributing
Bug fixes, features, tests, and documentation improvements are welcome. See the contribution guidelines to get started.
License
Licensed under the MIT License or Apache License 2.0, at your option.
The committed RAUC interface XML is licensed under CC0-1.0.