Failed jobs keep their kind: units that broke or timed out get a failure panel entry with the reason systemd reports (exit status, signal, timeout, start limit, status text) and their last journal lines read through libsystemd. Units that failed only through a dependency are dimmed and left out of the panel, and units that crash after starting count as failed. Restructure the repository around this: - move the library and binary into bootvine/ and the scripted demos into their own unpublished scripted-demos crate, with their VHS tapes - move the crane builds and NixOS module into nix/ - group each sample VM with its check under vm-tests/, adding text-console, scripted-initrd, encrypted-volume and failures machines and a vm-failures check - add docs/guide.md walking through the screen with every recording, keep one recording in the README, and re-render all recordings
2.6 KiB
bootvine
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, in the room the tree leaves, a timeline of the slowest ones that ran.
I started bootvine out of frustration with the boot screen of most Linux distributions: a wall of log lines scrolling past too fast to read, which never gave me any idea of what was going on.
It also follows shutdowns, answers passphrase prompts such as a LUKS unlock in place, and shows why a unit failed with its last journal lines. The guide walks through each part of the screen.
Requirements
- systemd ≥ 246 as PID 1
- libdbus and libsystemd
- a virtual terminal
- a systemd initrd, to show the boot from the initrd as well as stage 2
See Install for each distribution.
Try it without installing
With Nix, boot a sample NixOS machine with slow and failing units in a QEMU window, without touching your system's boot:
nix run git+https://codeberg.org/wvhulle/bootvine#sample-vm-slow-services
It logs in as root; poweroff shows the shutdown. The
guide
lists the other sample machines and the scripted demos that play in a terminal.
Documentation
- Guide to the screen: the tree, the timeline, failures, shutdown and passphrase prompts.
- Install on NixOS, Ubuntu and other distributions.
- Configuration of colours, timing and the console.
- Architecture: how bootvine follows the boot and takes the console.
- Development and the code style.