Documentation
rec* Tooling Overview
Inventory of the rec* tools: what each one does and where it runs.
Context
The install tools (recpart, recstrap, recfstab, recsetup, recchroot) are the manual install path, and the backends of the install screen's step apps. recab manages the two roots of an A/B installation. The rest build the boot artifacts and drive the test VMs.
Tool Matrix
Ordered canonically by tool name.
| Tool | Surface | Primary Use | Runs On |
|---|---|---|---|
| recab | CLI | The two A/B roots: locked booted root, unlocked other root | Installed system |
| recchroot | CLI | Chroot with bind mounts | Live ISO |
| recfstab | CLI | Generate fstab entries | Live ISO |
| recinit | CLI + library | Initramfs builder | Build host |
| reciso | CLI + library | UEFI ISO builder | Build host |
| recpart | CLI + backend | Disk inspect/plan/apply backend | Live ISO |
| recqemu | Library | Scenario VMs as libvirt domains, serial console | Build host |
| recsetup | CLI + backend | Configure and boot the installed system | Live ISO |
| recshuttle | Library | SSH transport to scenario VMs | Build host |
| recstrap | CLI | Extract the system image | Live ISO and installed system |
Boundaries
- Installer-facing:
recstrap,recfstab,recchroot,recsetup - Partition backend:
recpart(inspect/plan/apply and handoff only) - Build pipeline:
recinit,reciso - Test VMs:
recqemu,recshuttle - A/B roots:
recab; Recipe writes system software into the unlocked other root
See Also
- Installation Tools Overview - The install tools in order
- recipe CLI Reference - Package manager CLI