boot-tree: portable unit, dracut and mkinitcpio hooks, self-quieting console, minimal NixOS module

This commit is contained in:
Willem Vanhulle committed 2026-10-11 15:54:28 +02:00
1 parent 2b1447965a
commit 1482d4437a
13 files changed
+208 -121

No files matched your search

+45 -6
View File
@@ -4,10 +4,27 @@ A live dependency tree of systemd jobs on the boot console, in the spirit of
nix-output-monitor. It replaces the scrolling kernel and systemd lines with a
tree of pending units and a timeline bar per row.
## Requirements
- Linux with **systemd ≥ 246 as PID 1** (private socket `/run/systemd/private`,
`Manager.SetShowStatus`).
- Runs as **root**, from the shipped `boot-tree.service`.
- **libdbus-1** at runtime.
- A **virtual terminal** (`CONFIG_VT`); the unit draws on `/dev/tty12`.
- Optional: a **systemd-based initrd** (NixOS `boot.initrd.systemd`, dracut, or
mkinitcpio's `systemd` hook). Without one the tree starts in stage 2, once the
real root is mounted.
- Optional: a large console font on HiDPI screens, e.g. Terminus `ter-v32n`
through the distro's console font setting.
No kernel parameters are needed: while it runs, boot-tree lowers the kernel
console log level and turns systemd's status output off, and restores both when
it hands the console over.
## How it works
- Starts as an initrd unit (needs `boot.initrd.systemd.enable`), about a second
after the kernel.
- Starts as an initrd unit when the initrd runs systemd, about a second after
the kernel.
- Talks to PID 1 over the private socket `/run/systemd/private` with libdbus:
`Subscribe`, `ListJobs`, unit properties, and the `JobNew`/`JobRemoved`/
`PropertiesChanged` signals.
@@ -18,17 +35,39 @@ tree of pending units and a timeline bar per row.
previous one when the display manager starts or the default target is
reached, so gettys and greeters on tty1 cannot draw over it.
## Usage
## Installing
The package ships everything a system needs under `lib/`:
| File | Purpose |
| --- | --- |
| `lib/systemd/system/boot-tree.service` | the unit, used in both the initrd and stage 2 |
| `lib/dracut/modules.d/90boot-tree/` | dracut module |
| `lib/initcpio/install/sd-boot-tree` | mkinitcpio hook |
### NixOS
```nix
inputs.boot-tree.url = "git+file:/home/wvhulle/Code/boot-tree?ref=refs/heads/main";
# in a host's modules:
# in the host's modules:
boot-tree.nixosModules.default
{ services.boot-tree.enable = true; }
```
Options: `tty`, `holdMs`, `quietConsole` (silences kernel/systemd console
output and loads a Terminus font in the initrd), `consoleFont`.
With `boot.initrd.systemd.enable` the unit is added to the initrd as well.
### Other distributions
1. Install `boot-tree` to `/usr/bin` and the files above under `/usr/lib`.
2. `systemctl enable boot-tree.service`.
3. To start it in the initrd:
- dracut: `add_dracutmodules+=" boot-tree "` in `/etc/dracut.conf.d/boot-tree.conf`,
then `dracut --force`;
- mkinitcpio: add `sd-boot-tree` after `systemd` in `HOOKS`, then
`mkinitcpio -P`.
To draw on another terminal, override `TTYPath=` with
`systemctl edit boot-tree.service`.
## Testing