#!/usr/bin/env bash # SPDX-License-Identifier: LicenseRef-Starship-1.0 # Copyright (c) 2023-2026 Robert A. James # test_qemu_session_snapshot.sh -- the tests of qemu_session.py's CPU snapshot on a failed check # (Captain Bob, 2026-11-19: "Diagnose on CI" -- CI's aarch64 BIRTH stall reproduces only there). # When a check fails, the script asks QEMU's monitor for the CPUs' registers three times, a # second apart, and prints them, so the job's log shows where the kernel is and whether it moves. # # The script boots QEMU when it is run, so the test takes cpu_snapshot() and check() out of it # (ast) and runs them against a fake monitor. No QEMU. Prints PASS:/FAIL: and RESULT:. set -uo pipefail ROOT="$(cd "$(dirname "$0")/.." && pwd)" python3 - "$ROOT/scripts/qemu_session.py" <<'PY' import ast, io, sys, contextlib src = open(sys.argv[1]).read() tree = ast.parse(src) want = {"cpu_snapshot", "check"} funcs = [n for n in tree.body if isinstance(n, ast.FunctionDef) and n.name in want] ok = True def report(name, cond): global ok print(("PASS: " if cond else "FAIL: ") + name); ok = ok and cond report("qemu_session.py has cpu_snapshot()", any(f.name == "cpu_snapshot" for f in funcs)) calls = [] def qcmd(cmd, **args): calls.append((cmd, args)) if args.get("command-line", "").startswith("x "): return {"return": "00000000400812a4: 0xd503201f 0x94000123 0xf9400000 0xd65f03c0\n"} return {"return": "X0=0000000000000001\nPC=00000000400812a4 X30=0000000040081000 SP=0000000040300000\n"} import re g = {"qcmd": qcmd, "re": re, "time": type("T", (), {"sleep": staticmethod(lambda s: None)}), "ok": True, "excerpt": lambda near=None: None, "print": print} mod = ast.Module(body=funcs, type_ignores=[]) try: exec(compile(mod, "qemu_session.py", "exec"), g) except Exception as e: report(f"the functions load ({e})", False) out = io.StringIO() with contextlib.redirect_stdout(out): if "check" in g: g["check"]("a check that fails", False) said = out.getvalue() regs = [c for c in calls if c[0] == "human-monitor-command" and c[1].get("command-line") == "info registers"] report("a failed check asks the monitor for the registers three times", len(regs) == 3) report(" and prints where the CPU is, each time", said.count("PC=00000000400812a4") == 3) code = [c for c in calls if c[0] == "human-monitor-command" and c[1].get("command-line", "") == "x /8wx 0x00000000400812a4"] report(" and the code at the PC each time, by its address (the monitor has no $pc on aarch64)", len(code) == 3 and said.count("0xd503201f") == 3) calls.clear(); out = io.StringIO() with contextlib.redirect_stdout(out): if "check" in g: g["check"]("a check that passes", True) report("a passing check asks the monitor nothing", not calls) def broken(cmd, **args): raise OSError("monitor gone") g["qcmd"] = broken; out = io.StringIO() try: with contextlib.redirect_stdout(out): if "check" in g: g["check"]("a check that fails, the monitor gone", False) report("a monitor that does not answer does not stop the run", True) except Exception as e: report(f"a monitor that does not answer does not stop the run ({e})", False) print("RESULT: PASS" if ok else "RESULT: FAIL") sys.exit(0 if ok else 1) PY