From 04219bb58e4123d9bf0830d1e2dd4413907e0308 Mon Sep 17 00:00:00 2001 From: Willem Vanhulle Date: Fri, 16 Oct 2026 10:55:22 +0200 Subject: [PATCH] docs: automate gif generation --- CONTRIBUTING.md | 14 +++++--- README.md | 5 +++ demo/luks-test.nix | 57 -------------------------------- demo/test.nix | 66 ------------------------------------- docs/boot.tape | 21 ++++++++++++ docs/initrd.png | Bin 5993 -> 0 bytes docs/passphrase.png | Bin 0 -> 9933 bytes docs/shutdown.png | Bin 14178 -> 0 bytes docs/shutdown.tape | 21 ++++++++++++ docs/stage-2.png | Bin 10889 -> 0 bytes flake.nix | 77 +++++++++++++++++++++++++++++++++----------- src/console.rs | 21 +++++++----- src/run.rs | 11 +++++++ tests/boot.nix | 31 ++++++++++++++++++ tests/boot.py | 54 +++++++++++++++++++++++++++++++ tests/console.py | 69 +++++++++++++++++++++++++++++++++++++++ tests/luks.nix | 50 ++++++++++++++++++++++++++++ tests/luks.py | 31 ++++++++++++++++++ 18 files changed, 375 insertions(+), 153 deletions(-) delete mode 100644 demo/luks-test.nix delete mode 100644 demo/test.nix create mode 100644 docs/boot.tape delete mode 100644 docs/initrd.png create mode 100644 docs/passphrase.png delete mode 100644 docs/shutdown.png create mode 100644 docs/shutdown.tape delete mode 100644 docs/stage-2.png create mode 100644 tests/boot.nix create mode 100644 tests/boot.py create mode 100644 tests/console.py create mode 100644 tests/luks.nix create mode 100644 tests/luks.py diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 72c6b61..f1e081a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -13,10 +13,16 @@ Work inside the dev shell (`direnv allow` once). Run `cargo clippy - `nix run .#demo-units -- start`, then `cargo run -- --user --target bootvine-demo.target --hold 3s`: live against your user manager. -- `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 copies of these screenshots. +- `nix build .#checks.x86_64-linux.`: each `tests/.nix` boots a VM + and runs `tests/console.py` followed by `tests/.py`. `boot` follows + the initrd, stage 2 and a poweroff; `luks` answers a passphrase prompt in + the initrd. They read tty12 as text from `/dev/vcsu12`, hold the boot with + the initrd backdoor and gate files under `/run` instead of sleeping. Run one + by hand with `nix run .#checks.x86_64-linux.boot.driverInteractive`, then + `test_script()`. +- `nix run .#docs`, from the repository root: renders `docs/boot.tape` and + `docs/shutdown.tape` with VHS against the scripted examples into the README + GIFs, and copies the passphrase screenshot from the `luks` check. 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 655895f..6cd1a74 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,11 @@ the units that have to stop first, until systemd hands over to A poweroff: units stopping under the targets waiting on them +Passphrase prompts, such as a LUKS unlock in the initrd, are answered in place +over the tree. + +A LUKS passphrase prompt floating over the initrd tree + ## Try ```sh diff --git a/demo/luks-test.nix b/demo/luks-test.nix deleted file mode 100644 index 0ead19b..0000000 --- a/demo/luks-test.nix +++ /dev/null @@ -1,57 +0,0 @@ -{ bootvineModule }: -{ - name = "bootvine-luks"; - enableOCR = true; - - nodes.machine = - { lib, pkgs, ... }: - { - imports = [ bootvineModule ]; - - services.bootvine.enable = true; - - boot.loader.systemd-boot.enable = true; - boot.initrd.systemd.enable = true; - environment.systemPackages = [ pkgs.cryptsetup ]; - - virtualisation = { - emptyDiskImages = [ 64 ]; - useBootLoader = true; - useEFIBoot = true; - mountHostNixStore = true; - }; - - specialisation.unlock.configuration = { - boot.initrd.luks.devices = lib.mkVMOverride { - secret.device = "/dev/vdb"; - }; - }; - }; - - testScript = '' - import time - - passphrase = "quietly unlocked" - - machine.wait_for_unit("multi-user.target") - machine.succeed(f"echo -n '{passphrase}' | cryptsetup luksFormat -q --iter-time=1 /dev/vdb -") - machine.succeed("bootctl set-default nixos-generation-1-specialisation-unlock.conf") - machine.succeed("sync") - machine.crash() - - machine.start() - machine.wait_for_text("passphrase") - machine.send_chars("not the passphrase\n") - time.sleep(5) - machine.wait_for_text("passphrase") - machine.screenshot("passphrase") - machine.send_chars(f"{passphrase}\n") - machine.wait_for_unit("multi-user.target") - - machine.succeed("test -e /dev/mapper/secret") - journal = machine.succeed("journalctl -b -u bootvine -o cat") - print(journal) - assert "in initrd" in journal, "never ran in the initrd" - assert journal.count("answered a password prompt") == 2, "did not answer both attempts itself" - ''; -} diff --git a/demo/test.nix b/demo/test.nix deleted file mode 100644 index c77a59a..0000000 --- a/demo/test.nix +++ /dev/null @@ -1,66 +0,0 @@ -{ demoHost }: -{ - name = "bootvine"; - enableOCR = true; - - nodes.machine = - { lib, pkgs, ... }: - let - lingerFor = seconds: lib.mkForce "${pkgs.coreutils}/bin/sleep ${seconds}"; - in - { - imports = [ demoHost ]; - systemd.settings.Manager.ShowStatus = lib.mkForce true; - systemd.services.demo-db.serviceConfig.ExecStop = lingerFor "20"; - virtualisation = { - memorySize = 2048; - qemu.options = [ - "-vga none" - "-device virtio-vga,xres=1280,yres=800" - ]; - }; - }; - - testScript = '' - machine.start() - - machine.wait_for_text("Initrd") - machine.screenshot("initrd") - - machine.wait_for_text("Stage 2") - machine.screenshot("stage-2") - quieted = machine.succeed("cut -f1 /proc/sys/kernel/printk").strip() - assert quieted == "1", f"stage 2 sysctl reopened the kernel console: {quieted}" - - machine.wait_for_unit("greetd.service") - machine.wait_until_succeeds("systemctl show -p ActiveState --value bootvine | grep -qx inactive") - - journal = machine.succeed("journalctl -b -u bootvine -o cat") - print(journal) - watched = [line for line in journal.splitlines() if line.startswith("bootvine: watching")] - assert any(" in initrd " in line for line in watched), "never ran in the initrd" - assert any(" in stage 2 " in line for line in watched), "never reconnected after the root switch" - pids = {line.split(" as pid ")[1].split()[0] for line in watched} - assert len(pids) == 1, f"the initrd process did not survive the root switch: {pids}" - assert "handing the console over" in journal, "never handed the console over" - - machine.succeed("test \"$(systemctl show -p Result --value bootvine)\" = success") - console_level = machine.succeed("cut -f1 /proc/sys/kernel/printk").strip() - assert console_level != "1", f"kernel console level was not restored: {console_level}" - show_status = machine.succeed("systemctl show -p ShowStatus --value").strip() - assert show_status == "yes", f"systemd status output was not restored: {show_status}" - machine.screenshot("handed-over") - - foreground = machine.succeed("cat /sys/class/tty/tty0/active").strip() - machine.succeed("systemctl restart bootvine") - machine.wait_until_succeeds("systemctl show -p ActiveState --value bootvine | grep -qx inactive", timeout=10) - assert "boot already finished" in machine.succeed("journalctl -u bootvine -o cat"), "a restart after boot did not stand down" - still_foreground = machine.succeed("cat /sys/class/tty/tty0/active").strip() - assert still_foreground == foreground, f"a restart after boot took the console: {foreground} -> {still_foreground}" - - machine.succeed("systemctl poweroff --no-block") - machine.wait_for_text("demo-db") - machine.screenshot("shutdown") - machine.wait_for_shutdown() - ''; -} diff --git a/docs/boot.tape b/docs/boot.tape new file mode 100644 index 0000000..579e5d7 --- /dev/null +++ b/docs/boot.tape @@ -0,0 +1,21 @@ +Output docs/boot.gif + +Require bootvine-boot-example + +Set Shell bash +Set FontSize 22 +Set Width 1380 +Set Height 980 +Set Padding 16 +Set Theme "Monokai Vivid" +Set TypingSpeed 0 +Set Framerate 10 + +Hide +Type "clear && bootvine-boot-example" +Enter +Show + +Wait+Screen@60s /0 running\s+0 waiting/ +Sleep 2s +Hide diff --git a/docs/initrd.png b/docs/initrd.png deleted file mode 100644 index 374cbcafdae10862d5018b1a2b793af2cd1350f9..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5993 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
    cvC3M3n^I7fe?57g`eh6z6sovv@ZvAG2}u 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 literal 0 HcmV?d00001 diff --git a/docs/shutdown.png b/docs/shutdown.png deleted file mode 100644 index daad49a31e66f12823b615c4ffbc28a7bf733b52..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14178 zcmeAS@N?(olHy`uVBq!ia0y~yU}a!nU{+vZW?*3G+ji*$0|SF-fKP~P-+`LnACK?Y zttP9Wm=+WAYp?#*BMbE{CS7J=P+;(MaSW-L^LB3c#5q>m-Iix56<9X^SG!<$NW~%D z;3>zhtWW$8`Gh8YyT;72=qA&?(B}zKwg>K>c4{#D6~MspNwJpU!952Dg;U4p7o2{7 zL@GJAQ^THtkAuTyrm(@`TS5W?PZ}E>ru5tIulpO;rT;G@``@1$rImf9s&#*VnWlP% zu;!g_4?C`3QZ2UT@58k>RtcGWe!oJip!%N1gZUdjHa8?pThd_ve|GA|hMPhH0%w9$ z7Q8!d88&r6t|AMIU?$`L4DY(?n;NUVe)J0ns5CS)43 z)%qXhTaI3?udnxCeSOdV>oe`!GQ73Ij~uxEfxot?Rq+H0$-Ccgr`FH3_j&gI{q;ikI+nRV-#?dr zHShfVr=NfJe0q@^{A$aKD?56{q|dldUS)re>96Yx{f(dNi~p6jF)eG`#d13$+nx1G z`jgccX6C2Q2zev4cCNny_vF)JpKA}~=!(163m%*dsyukVrC}TE9*Mh~tUMWgg;=)SKgPxA8NS}d;r8?0 zS@IX=h)rWHk#*$oxT*BONxmTL0QWb>?&t$AnOT-N9PkSJ!kAgdVX@Kiz|z$ZrZnis zu)1?ERY*vczi{X8wtso7_CEd<-2F$-*xGMi74vE>%a!{A zf)ncJN=*0__AcpG*rZyA4e|m7avVR>6duSVx3e%Y1tu}R|Fl5Hgb@-Gr>q$NPx`t( zqq{5Uy2_lX1tsy1et-VXmMIpqpvU2W*P`2}K7Kzw@7hltfdUq$Feb*=5keojC7BtO zm3k*JX>rU*^gOWt+=lx9`>w?Ay>P2H+rGO#_|OjD<-g7ZH=X>{pR-%!UuE?Vha07Q zzGD9+ZnRI|k!#*1%o$x%74IKVFZ+OVWMvZ+wX zTt#d`Ysa6fxzpoji)FL^>FSQ?%F<$4$2!1;&(`Wy^PuB&G{!0E;sP^hBC*$deVo{sh>@i{&RAYGG_iy)h zJYaO~4tq-j=dM)7=f{^gA86=l@D4v1zi0aQsX`yRY7a>6R!Crcs;jV<)uQa#KezAS zS0tHzeIIh|*=5e@P4}-FEAl_vWWJAUUXz#4H1&R^#s=Z{I~8YDClyKNz4A8|C{R~; zVAd!2p@{#1Q{HctwNgADtc!HGIOGpnH#RtkaB#TX^gVF?DyKN(b@@<-177c{xhv%r z5>y2?@Nquz?-dHUTayubA?kkRl!9dkF+CV`2bdmc4Z}UCvp03J+u_ z3K*2+e+o3c!QRsFKCPayT9i9u+f$Y$M{j4bC_cE|*ih_nVEg9%4ezp=I5M_9WnIFl z%gA`&Z)rnk`oVui*J870+`jOvY`!nIBq*v<9B!)5X0+=J0cn-;!a-j(U^wy6AD^~*B{7B=P?w=Cv*|I5Gf zzL>$%bLo0t4>9d}zf@WNX1VBI2X3Y)g$G()EGf5hm{?>Q8>Z%n8^k`!d!w&V+xlR+ zk`?RawwRPO!DOLY&j&x|7BE_ubCucdPpA^yza#q2$#+a_!JRC+55A^}eN?-+{d3x{ zhJQz-MWyc?e;BqtVy(!8_KpwVzi2I=Tpw>&yKuJfhu~OOhwZH~tlCqBCbZm|d46F- zdE$Nd!k7aEv)Wo3p3jd|5xH=`yl|x_@n_UVPZ=Tb7uT| zQfW@ek!6zPmMd>m5*E3CKe^P0 ztKywqf{2+>xv0$41ECw1IXV2@Fx_9(NuJ@i-Gk+4YyZu3_1WI%FZO7$+p^yc{<}Za zTF<|k^LpO5QxdfYcJ}8#nI>#~XX(PzOpK|G4Hv}}8P9)Z$Wwn;yzK0yo`whW-e@c2 zuxdl|Xyx(-)y*AygtBky6f!B@K7THn)n{Fi!h^FD#V$<#nzN3D#l~7dprdF*LyFae zkE)H&p8j~J+L&@oU~Xjo>-aBcr`ArmSfn$t z$zR6(J*ec^1kKH7AL#{7TAu%f@qBjx_ldVjxrvV466JgsIp$5B%<*HBuL8>+iQF%Y zm#2%|T>W4N3yY05yFItrq6xnn?tfbx_tm(~XJ++g+kN~$a=jMtSCpx^AI{0#cHv4a z4+n?KMB#$lmBLJMJfJdbPpHEWj%f{$GD}e8!{qg~YC@Y-r4}U|;x{_@;efc+)Ow!J zu`(PHo)>Glnd7C4ZeMw`&HK_h%^z}1Vl`*-cB=?%n6!w~ULj!`Gpk8)Q_ugG;)1>U z$Ln`&z3iv3$>3poV!&nhyZ5=TeYt*x_v31|*lF($=^I-49k{YOxLJIeUya{Sf5XNT ze_G^)n}fbwUAd(B`ce6tX5X~#Ykvx3jO_4u6?%c2sczLb);aS(IDgFTX5xEj#u1^c zkUX~`eU?K?+9Cd<+gq6?dAiQ2s*z^7<9lEOzlHXLm1+VrXMZ?6L2yHYG|L_T14mSf zjxz0P5t}(b-*IIUqctm|;sY-+^*;ftA`Un@9@zekar*kEw~uUuJI?t3Fbu5O)!LB% zj(O7Vs>eABZaT*LCk}u8bj}p)&RK<%C!VkoefK6rsV+!x^T{ipo7MEH0<`?}e1 zPSU@&(^8+(6dw3F9LSZ?eemmermtNC_s$QSH<>rj5KuTZk;%zlfDzJ!Qc_Q-5}UXz z-rRG2$=mp4)pmcQ{(O(`lXy8PTG%>%on2|oT4jxdw68f#yRKe&`>2WW_g#ZlRo(YB zE2}sv{26x_^iGWs*$~XkqT+BsXEw`|H+l~)ecb97&Gf3=#b2K@=h5DJ#~JPN-=15= zH#U@{EJ%9HT_mVHx9VSwv5jff0h{o@e?D&Y3ugNDeXiN3XO|OJbiaFl@u5~1rw9A< zYR#V=(<;{Vh#5!)3)kta0y(C5NyF*Q9WG2Q)j)~VFhz z-x4&~%*D8#mqo{q0o1BhZz#X8rD3PQ#LU^XF>iv;ZezN$IPLe7pRU3O3b*Jaloj;+ zyfIlvf74oqsF&KSBxO1lG|YB#sk*E6s$YNp((sho&wg9yo&K|JO2fXi0)^*UjLj_D zzXc^utGvKucDR#8rS^csfsK)yc_Re3oNR7bG{^J60)CHcaoX-5E^{d?(6}zJp}isf zsS8tE_`#C5uG?5MjxNeAu00UK`9bZLV1a8#$6oUlkA628dd~e*>oE7!duFEt%$aTu z1^x;O0<26-fgnH1GCq8)3oR%!Ll5l#|HyRdzbC8yP4=%c{&&})(`2_%i*(+p`SJUg zZ;dZo8_D=rzW(nuG1fUhqn!^l+%J3D|65lvLG^A=n81Y3?d#?`AJAuITz~i`>z}W$ zr@yrMbJ4aVeu?wP>|13v|K`@rt&g1Fw*Q;unWA+!ZN5G9|B(3S*MGCyXw<@ zzy5^1(tHJmTKks*d-sN1ygv1u4^t6;gtFn^l(!rwoL#tB|16f?U(97u|7)Mp8}nbe z*KP|=NM7^%(`xlx#=mno^Iq}qF3V?p`|Bl(iEmss)2@~Fm-NrdKPvC>k3BSb&&f*p z7x`bJw_am^GGTK54W?CWtR~snEKiCJ?l6Cn-Z`HS)I>h5xc_4Q?xmTG`~R%U+QI)~ z*|jLe2e#{*&gOrKzFD>;mGQXxf%rV%$M2c@n6?$k2b4elb4C7Qt%Gs>?UI**XTBD0 z{@rld|6BCTbv2i39SVdIVGRv(5G5u0!SR}XWzdI>3J>>wsIL5S%t*5BRQs|=^XIWM zg$dc5ZD`PLY?!)6WP&OKM}+V6{~V0m8Eyyq`~5dnWU&9-rf~mpy5+iBmq@;&E1oX4 zyOUsl-*SsH+i^wC=3Ot7AIPlbSkarzo&E5}CR>l$KP;ct+e8>%6q~?Xuu<%j*n~W3 zp|y`>h3|iQBIK(K%RZ<*o)b4e=1Sq&=faJg8EyY}2B=JyD~N% zM)x9+(mcoq>T&GNpE8m~V2>w<+d$#qFO)_3Z z{4A_K>-y%zA9%WcZGy^w+l;^i6O1_|o<&!kV`EfTc);~dv|#14>I+jE{(k>{{^j=i zm%3$-zkmO}qhhA3{F=Qp-!#X`e@Haj{E^jhpI*f5O)FYwy?2aeniZB?s zSadj4ce3|xYgqOC_MEOmOnjV-*1tEtuG!eA3AyTu=;&Xzi&%*u0n zWyyi|-zW5Z&NTTeOcFN;{A`;M>Tr+gR;yLiff8%eNjvyYL_377*}}TS^nP;~Yt2oy z4Z4iGEg3823*ruFc*lIU%?LU0Kx>9x)NZaa`I)iI+S?Qq)-`E1op0(5eti6g-GdV2 z0B(!5vRByW@c)>xE^fZhfy{Rk(k&W23Pkq^colJ@jS)bby#fLqm#)+v=qNZ4fBxTz z=iOd!oZYWAOJ6K>n)D=L|B+?CU3yHus;E55Vse{ltlCr~ut9`lhwFi(5QfHsSF)+! zszq-JU9f*#x=>z6DCL#THycw)okQL^OBK{qZcO81@^on`ImH+5dsg<+$GOYDRg2CN zGLZQB==jkeh6bO1UOC5{=H-6)!a}{27#>-UWaHaHbAu8)Q}(UypPH$wcI39H5ciGA z2Y(jYZQb7x$MT*-ctX#f>t{GU+#>k31Ok?Re)_Fiv`=KhW?u)_%}1Et*<{%Z6?CvZ zQTFa^s4>~Meo~6uvc@$N8*J`RRd$;tWblSLYvYb!vwHcb+{e~j>e%&G;K%hOnRes?X|8Dh;bBd^m1fBBkU0mfB<9pC| z-*15wW43c@%n=NpJ(G2%GCc2 z5_l$<*2z7Aeec~v=6UZ!XFor-@{H;J2M_mz9(ba)Jmi3Qe2Qg^gIUW_!!v1~93Dbk ztRZCzhyR>YOxSTMQZ-@Ik(%24^l(Pwl`Gf0{5vh=f|$UDNn2PKHW;rA6yvb?UN|q6 zk$bV-A2Xqc7k396RPw9|3At)g^h-i~`9rO5u?-KKQXZb~3BKG`@=jz*mi3i}xz6YsKu9xnGg zKlbvLJWu>O_tdrPJiobiL|<{A*^swq%i0j11CD1oBzji+ae1uE>@+AbuVlP??(i%2 zscY9ueiH?!2O%+59xYMff~b;jGACJmdYE*w8FfuQXo_8^?OEkto72=bxSW`4SLCg=H{s;Mj2E8f$5!1HwNG4`h6YX-mYCwIJv|M+^BA5AW-&4v>k#APQfCSK3U%95X* zC)1Yvi|1F_9f6#AySYA2RCtn<+7YaOd?J%txaDmYAGLjH!NI?8s43K%J(Rf9WIyS& z@eiNa9dA!PpLChS!n>F$OCf<#V1q5=;#`3O<gH| zh|27KzQD~)$Ao)BxICEc!Z=o}pRBl`hI@y~f~QBEgqsTbMX@bWU3R;E>=icg`KZ-oJSMAwr;_p+Qq2VQa(PdrWF<-<%Kl?s=;<7; zCT-T3+w3M;y5AWU6NDb7A3Un4^vcz!U0iYHub2{!Zl#aw=ly*4opJxkbK!~lDmP9? zXB4#W&A&b|y88SJr6d0T1zo4vh<3j|P$KiBtMzl^s;{PB^Jj@VP^9ocx}o8z z$TVGxw@=v%);7L>F@-5kZ_^T1#)G|CE|(Ozz{D6HsFJX+g&91kVa7RwfhkIbRfk8=P?_VI zvsH}Ke%)(}MU34PDwq>KSlQW!9uIN4s4+?7Rq~Ek#rH*gIU}qr)J}=>r+N05S2AC8 zn2{jU-B!DVIk7Fex5l$@NyF~ejx*ddPF-qg*vGBOjw%US4k!em=M_7E$2{SQn zHc?H;?C_|w$-LnErTgkexuq;jLY*GsdheLkSigLlr0K5b7tOTn{Hj$k4pFHSp87sv zRhh{)`|96`nT(>5%?&I2S2r{WFKm!y*$cdhmxuWwqYixfPw+IBj{lVip?r}(9!DoZ+9P5i^^ROD{e zY+_>6&h$PIvUG97Tq%VIb6KB=a9iw1L;|#UW2wzZg&W@Id(X>0Q^yxZ_WQxnA`>(>sw5mg<#ZrwomRqjm4tA` z1T99UyyX3>A1G`-uT(55b5?kgsKKO+umg$vbXa0e3OXu0Hd9{kruKlK{3XFXmd9Lc zS+*y>&^=&yI^p!K+6_CMU))<0ovifpMfDsmrgK48BGzVI?92Rj?cy@VLy*!jO5lU6 zqrzLx8&7f*Dx(Ah?nppJL_y=jk(v+m3T3nP1;jpocfa#V`qK1`b9dgJ{;T|z+slh* zSpP4$x%c2r=2P`&roFxKt!c5p%pHN0l{@#uYbO*&iAnG8m0a$KDgE*?EHSs9T3gI+a6PK0n2;F5 z?)gEPqv-)(T-EhV z5Aq6SPo)}0dn&a12b|eF{kKIbpU#u!4N?LIp-q3Qf`cEr=NS67SrofDEL~)Gu&Lpq z{nQUH*n^s`iOWspVx40WdfI{)1$L_h1s=XGI^pZ7jP@M8b&sd&+}7vRC=%VH@nFG? z^HcfmZ50$+g@n`?_h)tqe|AmRobPp? z{mEXpVx9MU_$^qIRai?VNm=h`idoD|Nk_u-Izsju@szbbCa6;Dq&9Pqj{efi;>tU3Nm zS@s-#$p-3dziw!l>Ttm770aI=KSKKFKRy5G`TpZS0#(ISu8Mw6t^fCbf$BNeA3Rt4 zuNJSAtu%P;_TBY-Q*L}=z?Nw#&$I(o7YM$7c_EVWU zi+|6DxAzvbS(Lt5R3o0awn4|mh5PG|5Y5LS6B{}=sW)pr+csf!g4wFffU8V#J-5Ur zoZ9AhfWP?JzF7@=QA$&-%wO;^`MptG@bbaSeX)KHyU(uMc}871OsAUb9LJB8!tK9I z=88;cX^!bI=X~)-OYDN`oSrI1Ps6>lgeQbm%7Q0>`efHNy}b1)bVHbq<^$GW4R_Zx z#QHhZm0G8;9tkb@Ww#*m_lELca(~v{d)&M<>*yV`@M$S_;;|wR4dcGsWv<%Tc09bq zF^0V|%|=6RU*hvAhieZUaX)l;exmWq+n3gz5YJ)%zrfs7z2oPLG{K$s7T?Kw<$icYbW2^z zMqXLjy^n-nJeZ+)QLE|Jj0sa3_|zXP-?gqG?^VAMBjfT{Uvu1+XFS=P{N;_(Lixx) z9NHW^TB{hF3zu(co-R>db?rjG&OwV8m5dkJdv3%Z$nM*7ev_YrNs}Vj4aeUx#hH9j zKCQ)AC@K@E{-7lMz4Q9bb`O?&?)Q1&E>t^D<2NS|SSk9VQ@K&U?@ZY~w@#7OEy*HQ$ckI@W zE#cl^@cB-@%e~%|xD#2yXYU+1DWnAOY*WZpTLDT zi+LHRpSsAd+%1x(CogNncym zT^IFR?WadtEW5s7$ko*w*Q{=M^H_tinbRsL*7 _qqv_P@UWW8J9y#Peg&v-C|m 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 diff --git a/docs/shutdown.tape b/docs/shutdown.tape new file mode 100644 index 0000000..dec1fe5 --- /dev/null +++ b/docs/shutdown.tape @@ -0,0 +1,21 @@ +Output docs/shutdown.gif + +Require bootvine-shutdown-example + +Set Shell bash +Set FontSize 22 +Set Width 1380 +Set Height 980 +Set Padding 16 +Set Theme "Monokai Vivid" +Set TypingSpeed 0 +Set Framerate 10 + +Hide +Type "clear && bootvine-shutdown-example" +Enter +Show + +Wait+Screen@60s /0 running\s+0 waiting/ +Sleep 2s +Hide diff --git a/docs/stage-2.png b/docs/stage-2.png deleted file mode 100644 index 29bcb89abec0f90c21448e3d3572fa40ec1ebdab..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 10889 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 Biw*z) diff --git a/flake.nix b/flake.nix index 96b9b94..373d539 100644 --- a/flake.nix +++ b/flake.nix @@ -64,8 +64,8 @@ { packages = forEachSystem ( { pkgs, craneLib, ... }: - { - default = craneLib.buildPackage { + let + commonArgs = { inherit (buildInputsFor pkgs) nativeBuildInputs buildInputs; src = lib.fileset.toSource { root = ./.; @@ -75,20 +75,40 @@ ]; }; strictDeps = true; - postInstall = '' - for unit in bootvine.service bootvine-shutdown.service; do - install -Dm644 packaging/systemd/$unit $out/lib/systemd/system/$unit - substituteInPlace $out/lib/systemd/system/$unit \ - --replace-fail /usr/bin/bootvine $out/bin/bootvine - done - install -Dm755 packaging/dracut/90bootvine/module-setup.sh \ - $out/lib/dracut/modules.d/90bootvine/module-setup.sh - install -Dm644 packaging/mkinitcpio/install/sd-bootvine \ - $out/lib/initcpio/install/sd-bootvine - ''; - meta.mainProgram = "bootvine"; - meta.platforms = lib.platforms.linux; }; + in + { + examples = craneLib.buildPackage ( + commonArgs + // { + pname = "bootvine-examples"; + cargoExtraArgs = "--examples"; + doCheck = false; + installPhaseCommand = '' + for example in boot shutdown; do + install -Dm755 target/release/examples/$example $out/bin/bootvine-$example-example + done + ''; + } + ); + default = craneLib.buildPackage ( + commonArgs + // { + postInstall = '' + for unit in bootvine.service bootvine-shutdown.service; do + install -Dm644 packaging/systemd/$unit $out/lib/systemd/system/$unit + substituteInPlace $out/lib/systemd/system/$unit \ + --replace-fail /usr/bin/bootvine $out/bin/bootvine + done + install -Dm755 packaging/dracut/90bootvine/module-setup.sh \ + $out/lib/dracut/modules.d/90bootvine/module-setup.sh + install -Dm644 packaging/mkinitcpio/install/sd-bootvine \ + $out/lib/initcpio/install/sd-bootvine + ''; + meta.mainProgram = "bootvine"; + meta.platforms = lib.platforms.linux; + } + ); demo-units = pkgs.callPackage ./demo/user-units.nix { inherit demoUnits; }; } ); @@ -98,7 +118,7 @@ nixosConfigurations.demo = demoSystem "x86_64-linux"; apps = forEachSystem ( - { system, ... }: + { pkgs, system, ... }: { vm = { type = "app"; @@ -108,6 +128,27 @@ type = "app"; program = lib.getExe self.packages.${system}.demo-units; }; + docs = { + type = "app"; + program = lib.getExe ( + pkgs.writeShellApplication { + name = "bootvine-docs"; + runtimeInputs = [ + pkgs.vhs + self.packages.${system}.examples + ]; + text = '' + if [ ! -d docs ]; then + echo "no docs directory here; run from the repository root" >&2 + exit 1 + fi + vhs ${./docs/boot.tape} + vhs ${./docs/shutdown.tape} + install -m644 -t docs ${self.checks.${system}.luks}/passphrase.png + ''; + } + ); + }; } ); @@ -115,9 +156,9 @@ { pkgs, system, ... }: { package = self.packages.${system}.default; - boot = pkgs.testers.runNixOSTest (import ./demo/test.nix { inherit demoHost; }); + boot = pkgs.testers.runNixOSTest (import ./tests/boot.nix { inherit demoHost; }); luks = pkgs.testers.runNixOSTest ( - import ./demo/luks-test.nix { bootvineModule = self.nixosModules.default; } + import ./tests/luks.nix { bootvineModule = self.nixosModules.default; } ); } ); diff --git a/src/console.rs b/src/console.rs index fa7f2b5..168c03f 100644 --- a/src/console.rs +++ b/src/console.rs @@ -21,6 +21,7 @@ pub struct Console { foreground: Option, for_system: bool, pub glyphs: Glyphs, + pub bold_is_brightness: bool, } impl Console { @@ -38,6 +39,7 @@ impl Console { }, for_system, glyphs: font_glyphs(), + bold_is_brightness: own_vt().is_some(), } } @@ -163,16 +165,19 @@ fn active_vt() -> Option { Some(state.active) } +fn own_vt() -> Option { + let name = ttyname(stdin(), Vec::new()).ok()?; + name.to_str() + .ok()? + .strip_prefix(VIRTUAL_TERMINAL_PREFIX)? + .parse() + .ok() + .filter(|number| *number > 0) +} + impl ForegroundVt { fn take() -> Option { - let name = ttyname(stdin(), Vec::new()).ok()?; - let own: u16 = name - .to_str() - .ok()? - .strip_prefix(VIRTUAL_TERMINAL_PREFIX)? - .parse() - .ok() - .filter(|number| *number > 0)?; + let own = own_vt()?; let previous = active_vt()?; if previous != own { activate(own).ok()?; diff --git a/src/run.rs b/src/run.rs index 9290f02..13d26c5 100644 --- a/src/run.rs +++ b/src/run.rs @@ -22,6 +22,7 @@ use ratatui::{ DefaultTerminal, backend::Backend, buffer::{Buffer, CellDiffOption}, + style::Modifier, }; use rustix::{ event::{PollFd, PollFlags, poll}, @@ -130,6 +131,13 @@ fn overwrite_every_cell(backend: &mut B, frame: &Buffer) -> Result<( backend.flush() } +fn drop_bold(frame: &mut Buffer) { + frame + .content + .iter_mut() + .for_each(|cell| cell.modifier.remove(Modifier::BOLD)); +} + fn watch( state: &mut BootState, feed: &mut Feed, @@ -180,6 +188,9 @@ fn watch( }, canvas.area(), ); + if console.bold_is_brightness { + drop_bold(canvas.buffer_mut()); + } })?; if repaint_due { let painted = completed.buffer.clone(); diff --git a/tests/boot.nix b/tests/boot.nix new file mode 100644 index 0000000..56635eb --- /dev/null +++ b/tests/boot.nix @@ -0,0 +1,31 @@ +{ demoHost }: +{ + name = "bootvine"; + + nodes.machine = + { lib, ... }: + let + waitFor = flag: "/bin/sh -c 'until [ -e /run/${flag} ]; do sleep 0.1; done'"; + in + { + imports = [ demoHost ]; + testing.initrdBackdoor = true; + boot.initrd.systemd.services.demo-initrd-probe.serviceConfig.ExecStart = lib.mkForce ( + waitFor "release-initrd-probe" + ); + systemd = { + settings.Manager.ShowStatus = lib.mkForce true; + services.demo-db.serviceConfig.ExecStop = lib.mkForce (waitFor "release-demo-db"); + services.backdoor.before = [ "demo-db.service" ]; + }; + virtualisation = { + memorySize = 2048; + qemu.options = [ + "-vga none" + "-device virtio-vga,xres=1280,yres=800" + ]; + }; + }; + + testScript = builtins.readFile ./console.py + builtins.readFile ./boot.py; +} diff --git a/tests/boot.py b/tests/boot.py new file mode 100644 index 0000000..eb8f54b --- /dev/null +++ b/tests/boot.py @@ -0,0 +1,54 @@ +def console_level(): + return machine.succeed("cut -f1 /proc/sys/kernel/printk").strip() + + +def unit_state(unit): + return machine.succeed(f"systemctl is-active {unit} || true").strip() + + +machine.start() + +wait_for_screen("Initrd", "Slow hardware probe") +assert_bootvine_in_front() +assert_text_visible(font_has_512_glyphs=True) +assert console_level() == "1", f"the kernel console was not quieted: {console_level()}" +machine.succeed("touch /run/release-initrd-probe") +machine.switch_root() + +retry(lambda _: unit_state("demo-db") == "activating", timeout_seconds=60) +wait_for_screen("Stage 2", "demo-db") +assert_bootvine_in_front() +assert_text_visible(font_has_512_glyphs=True) +assert console_level() == "1", f"stage 2 sysctl reopened the kernel console: {console_level()}" + +machine.wait_for_unit("greetd.service") +retry(lambda _: unit_state("bootvine") == "inactive", timeout_seconds=60) + +journal = bootvine_journal() +print(journal) +watched = [line for line in journal.splitlines() if line.startswith("bootvine: watching")] +assert any(" in Initrd " in line for line in watched), "never ran in the initrd" +assert any(" in Stage 2 " in line for line in watched), "never reconnected after the root switch" +pids = {line.split(" as pid ")[1].split()[0] for line in watched} +assert len(pids) == 1, f"the initrd process did not survive the root switch: {pids}" +assert "handing the console over" in journal, "never handed the console over" + +machine.succeed('test "$(systemctl show -p Result --value bootvine)" = success') +assert console_level() != "1", f"kernel console level was not restored: {console_level()}" +show_status = machine.succeed("systemctl show -p ShowStatus --value").strip() +assert show_status == "yes", f"systemd status output was not restored: {show_status}" + +foreground = foreground_terminal() +assert foreground != f"tty{BOOTVINE_TERMINAL}", "bootvine kept the console after handing it over" +machine.succeed("systemctl restart bootvine") +retry(lambda _: unit_state("bootvine") == "inactive", timeout_seconds=10) +assert "boot already finished" in bootvine_journal(), "a restart after boot did not stand down" +assert foreground_terminal() == foreground, "a restart after boot took the console" + +machine.succeed("systemctl poweroff --no-block") +retry(lambda _: unit_state("demo-db") == "deactivating", timeout_seconds=60) +wait_for_screen("Shutdown", "demo-db") +assert_bootvine_in_front() +assert_text_visible(font_has_512_glyphs=True) +machine.succeed("touch /run/release-demo-db") +machine.wait_for_shutdown() diff --git a/tests/console.py b/tests/console.py new file mode 100644 index 0000000..75adb3b --- /dev/null +++ b/tests/console.py @@ -0,0 +1,69 @@ +import base64 + +BOOTVINE_TERMINAL = 12 + + +def read_terminal(): + attributed, characters = machine.succeed( + f"base64 -w0 /dev/vcsa{BOOTVINE_TERMINAL}; echo; " + f"base64 -w0 /dev/vcsu{BOOTVINE_TERMINAL}" + ).split() + attributed = base64.b64decode(attributed) + columns = attributed[1] + attributes = attributed[5::2] + text = base64.b64decode(characters).decode("utf-32-le") + return columns, text, attributes + + +def as_rows(text, columns): + return "\n".join(text[start : start + columns] for start in range(0, len(text), columns)) + + +def screen(): + columns, text, _ = read_terminal() + return as_rows(text, columns) + + +def colours(attribute, font_has_512_glyphs): + if font_has_512_glyphs: + return (attribute >> 1) & 0x0F, (attribute >> 5) & 0x07 + return attribute & 0x0F, (attribute >> 4) & 0x07 + + +def assert_text_visible(font_has_512_glyphs=False): + columns, text, attributes = read_terminal() + + def is_hidden(character, attribute): + foreground, background = colours(attribute, font_has_512_glyphs) + return character != " " and foreground == background + + hidden = "".join( + "#" if is_hidden(character, attribute) else " " + for character, attribute in zip(text, attributes) + ) + assert "#" not in hidden, ( + f"text drawn in its background colour, marked #:\n{as_rows(hidden, columns)}\n{as_rows(text, columns)}" + ) + + +def wait_for_screen(*fragments): + def shows_all(last_try): + text = screen() + if last_try: + print(text) + return all(fragment in text for fragment in fragments) + + retry(shows_all, timeout_seconds=60) + + +def foreground_terminal(): + return machine.succeed("cat /sys/class/tty/tty0/active").strip() + + +def assert_bootvine_in_front(): + active = foreground_terminal() + assert active == f"tty{BOOTVINE_TERMINAL}", f"bootvine is not in front: {active}" + + +def bootvine_journal(): + return machine.succeed("journalctl -b -u bootvine -o cat") diff --git a/tests/luks.nix b/tests/luks.nix new file mode 100644 index 0000000..2df1291 --- /dev/null +++ b/tests/luks.nix @@ -0,0 +1,50 @@ +{ bootvineModule }: +let + passphrase = "quietly unlocked"; +in +{ + name = "bootvine-luks"; + nodes.machine = + { lib, pkgs, ... }: + let + secretUuid = "9d1f2a8e-0b7c-4c55-9a8e-6b2f8f3c1d00"; + secretDisk = pkgs.runCommand "bootvine-luks-disk" { nativeBuildInputs = [ pkgs.cryptsetup ]; } '' + truncate -s 32M disk.img + echo -n '${passphrase}' | cryptsetup luksFormat -q --disable-locks --type luks2 \ + --pbkdf pbkdf2 --pbkdf-force-iterations 1000 --uuid ${secretUuid} disk.img - + mv disk.img $out + ''; + in + { + imports = [ bootvineModule ]; + + services.bootvine.enable = true; + + testing.initrdBackdoor = true; + boot.initrd.systemd.enable = true; + boot.initrd.luks.devices = lib.mkVMOverride { + secret.device = "/dev/disk/by-uuid/${secretUuid}"; + }; + + virtualisation.qemu.options = [ + "-vga none" + "-device virtio-vga,xres=1280,yres=800" + ]; + virtualisation.qemu.drives = [ + { + name = "secret"; + file = "${secretDisk}"; + driveExtraOpts = { + format = "raw"; + snapshot = "on"; + }; + } + ]; + }; + + testScript = '' + PASSPHRASE = "${passphrase}" + '' + + builtins.readFile ./console.py + + builtins.readFile ./luks.py; +} diff --git a/tests/luks.py b/tests/luks.py new file mode 100644 index 0000000..6ec8f9b --- /dev/null +++ b/tests/luks.py @@ -0,0 +1,31 @@ +def answered_prompts(): + return bootvine_journal().count("answered a password prompt") + + +def pending_prompt(): + listing = machine.succeed("ls /run/systemd/ask-password").split() + return next((name for name in listing if name.startswith("ask.")), "") + + +machine.start() + +retry(lambda _: pending_prompt() != "", timeout_seconds=60) +wait_for_screen("passphrase") +assert_text_visible() +first_prompt = pending_prompt() +machine.send_chars("not the passphrase\n") +retry(lambda _: answered_prompts() == 1, timeout_seconds=30) +retry(lambda _: pending_prompt() not in ("", first_prompt), timeout_seconds=30) +wait_for_screen("passphrase") +assert_text_visible() +machine.screenshot("passphrase") +machine.send_chars(f"{PASSPHRASE}\n") +machine.wait_for_unit("systemd-cryptsetup@secret.service") +machine.switch_root() +machine.wait_for_unit("multi-user.target") + +machine.succeed("test -e /dev/mapper/secret") +journal = bootvine_journal() +print(journal) +assert " in Initrd " in journal, "never ran in the initrd" +assert journal.count("answered a password prompt") == 2, "did not answer both attempts itself"