diff --git a/docs/lithosananke/hosted-acceptance-test/README.md b/docs/lithosananke/hosted-acceptance-test/README.md index 993d1da..dabe839 100644 --- a/docs/lithosananke/hosted-acceptance-test/README.md +++ b/docs/lithosananke/hosted-acceptance-test/README.md @@ -1,8 +1,8 @@ # Hosted StarForth — 3-Architecture Acceptance Test -**Date**: 2026-07-24 -**Branch**: `lithosananke` -**Commit**: `edced063` (block-subsystem buffer-sizing fix that made this pass on all three architectures) +**Date**: 2026-07-24 (original), corrected 2026-08-02 +**Branch**: `master` +**Commits**: `edced063` (original block-subsystem fix), this correction pass --- @@ -20,35 +20,53 @@ This is distinct from the kernel (`Makefile.starkernel`) 3-arch acceptance test documented in [`../amd64-isr-fix/README.md`](../amd64-isr-fix/README.md), which boots a full UEFI bare-metal image under system-mode QEMU. This test only exercises -the hosted Linux binary, using QEMU **user-mode** emulation -(`qemu-aarch64-static` / `qemu-riscv64-static`) to run a foreign-architecture -static binary directly on the x86_64 host — no kernel, no UEFI firmware, no -system emulation. +the hosted Linux binary, using QEMU **user-mode** emulation to run a +foreign-architecture static binary directly on the x86_64 host — no kernel, +no UEFI firmware, no system emulation. --- ## Prerequisites -Cross toolchains and QEMU user-mode emulators: +Cross toolchains, QEMU user-mode emulation, and clang (needed for the +riscv64 leg — see below): ```bash sudo apt-get install -y \ gcc-aarch64-linux-gnu \ gcc-riscv64-linux-gnu \ - qemu-user qemu-user-static + clang-18 lld-18 \ + qemu-user ``` +`qemu-user` alone is enough — the binaries built below are statically +linked (`-static`), so the non-static `qemu-` emulators run them +directly with no sysroot. (The `qemu-user-static` package, if you see it +referenced elsewhere, provides statically-linked *emulators*; it's not +required just because the *guest* binary is static.) + +--- + +## Invocation note + +None of the three binaries accept a `-c "