From 63d76d96306e70a5b3fc4900a1ffd41a4b547a98 Mon Sep 17 00:00:00 2001 From: Willem Vanhulle Date: Sun, 11 Oct 2026 16:04:39 +0200 Subject: [PATCH] docs: add boot screenshots --- CONTRIBUTING.md | 1 + README.md | 3 +++ docs/initrd.png | Bin 0 -> 3604 bytes docs/stage-2.png | Bin 0 -> 5832 bytes 4 files changed, 4 insertions(+) create mode 100644 docs/initrd.png create mode 100644 docs/stage-2.png diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d2de60f..f807413 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -16,6 +16,7 @@ Work inside the dev shell (`direnv allow` once). Run `cargo clippy - `nix build .#checks.x86_64-linux.boot`: boots a VM and reads the screen with OCR; screenshots land in `result/`. Run it by hand with `nix run .#checks.x86_64-linux.boot.driverInteractive`, then `test_script()`. + The images in `docs/` are crops of these screenshots. Prefix the VM commands with `env -u LD_LIBRARY_PATH` when the shell exports libraries that clash with QEMU's. diff --git a/README.md b/README.md index 5b20db5..b88b2f6 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,9 @@ A live tree of systemd jobs on the boot console, in the spirit of nix-output-monitor. It replaces the scrolling kernel and systemd lines with the units still pending and a timeline of the ones that ran. +![The initrd: pending units on top, the timeline below](docs/initrd.png) +![Stage 2: the initrd collapsed, a failed unit, three still running](docs/stage-2.png) + It needs systemd ≥ 246 as PID 1, libdbus and a virtual terminal (it draws on tty12). With a systemd initrd it starts about a second after the kernel and follows the boot through the switch to the real root; without one it starts in diff --git a/docs/initrd.png b/docs/initrd.png new file mode 100644 index 0000000000000000000000000000000000000000..4f7205ef6cfc033948c71de8cad5769eef2aa1b9 GIT binary patch literal 3604 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 E0OXutGynhq literal 0 HcmV?d00001 diff --git a/docs/stage-2.png b/docs/stage-2.png new file mode 100644 index 0000000000000000000000000000000000000000..fef27683ee2100d957f42417d944c2ef7750b830 GIT binary patch literal 5832 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 i?pvG;*%x(I|C3kPvZe7_ijNs6b$hz{xvX