Linux command
rauc 命令
文件
复制后可按需替换文件名、目录或参数。
常用示例
Create and sign an update bundle
rauc bundle --cert=[cert.pem] --key=[key.pem] [content_dir/] [update.raucb]
Install a bundle
rauc install [update.raucb]
Show the current update status
rauc status
Show status
rauc status --output-format=json-pretty
Print the metadata
rauc info [update.raucb]
Mark the currently booted slot as good
rauc status mark-good booted
Mark a slot as bad
rauc status mark-bad other
Extract a bundle's contents
rauc extract [update.raucb] [output_dir/]
说明
rauc is both a target update client and a host-side packaging tool for embedded Linux systems. It delivers atomic, fail-safe A/B updates by writing a signed bundle into the inactive slot group and switching the active boot target only after integrity has been verified. If the new system fails to boot or confirm, the bootloader falls back to the previous slot. An update bundle (_.raucb_) is a SquashFS archive of root-filesystem images, kernel/initrd, and a manifest, signed with an x509 certificate. On the target, rauc install validates the signature against a pre-installed keyring, ensures the bundle is compatible with the device, and dispatches each image to its slot (ext4, UBIFS, raw block devices, boot partitions, etc.). A D-Bus service exposes progress and state to other services.
参数
- -c _FILE_, --conf=_FILE_
- Use an alternative _system.conf_.
- -C _SECTION:KEY=VALUE_, --confopt=_SECTION:KEY=VALUE_
- Override a config value at runtime.
- --keyring=_PEM_
- Trust anchor(s) used to verify bundle signatures.
- --mount=_PATH_
- Mount-point prefix for bundles (default _/mnt/rauc_).
- -d, --debug
- Enable debug output.
- -h, --help
- Print usage information.
- --version
- Print RAUC version and exit.
FAQ
What is the rauc command used for?
rauc is both a target update client and a host-side packaging tool for embedded Linux systems. It delivers atomic, fail-safe A/B updates by writing a signed bundle into the inactive slot group and switching the active boot target only after integrity has been verified. If the new system fails to boot or confirm, the bootloader falls back to the previous slot. An update bundle (_.raucb_) is a SquashFS archive of root-filesystem images, kernel/initrd, and a manifest, signed with an x509 certificate. On the target, rauc install validates the signature against a pre-installed keyring, ensures the bundle is compatible with the device, and dispatches each image to its slot (ext4, UBIFS, raw block devices, boot partitions, etc.). A D-Bus service exposes progress and state to other services.
How do I run a basic rauc example?
Run `rauc bundle --cert=[cert.pem] --key=[key.pem] [content_dir/] [update.raucb]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does -c _FILE_, --conf=_FILE_ do in rauc?
Use an alternative _system.conf_.