Files

T

Robert Allan JamesandClaude Sonnet 5 736627510b Fix riscv64 boot crash: add missing kernel stack trampoline

kernel_main on riscv64 ran directly on EDK2's UEFI boot-time stack, with
no dedicated stack switch — amd64 has always had a kernel_entry.S
trampoline for exactly this reason (its own comment: "the FORTH
interpreter + DOE experiment loop can easily exceed that depth").
aarch64 happens to get away without one because its firmware's default
stack is apparently larger, but that was never a guarantee.

On riscv64 the VM bootstrap's call depth (27 word-registration modules
-> physics/SSM init -> Tripod capsule birth) overflowed that small
stack, corrupting a return address and producing a wild jump / page
fault right after vm_init_with_host() returned — reproduced consistently
across the 2026-08-01 DoE campaign logs.

- src/starkernel/arch/riscv64/kernel_entry.S (new): RISC-V stack-switch
  trampoline mirroring amd64's, giving the kernel a dedicated 2 MiB BSS
  stack before anything deep runs.
- kernel_main.c: riscv64 now builds kernel_main_impl (invoked via the
  trampoline) instead of kernel_main directly, same pattern as amd64.
- Makefile.starkernel: wires the new file into the riscv64 build.
- uefi_loader.c: RAW_LOG() was silently a no-op on every non-amd64 arch;
  added a real raw-UART writer for riscv64 (QEMU virt's uart8250 at MMIO
  0x10000000) so existing loader diagnostics actually produce output.

Verified: all three architectures boot clean to [Hera] ok> in the
required order (amd64, aarch64, riscv64); logs and DoE CSVs from these
runs included.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-08-02 06:59:48 -04:00

cmdline.c

Initial commit — LithosAnanke kernel

2026-08-01 07:49:56 -04:00

elf_loader.c

Initial commit — LithosAnanke kernel

2026-08-01 07:49:56 -04:00

README.md

Initial commit — LithosAnanke kernel

2026-08-01 07:49:56 -04:00

reloc_stub.c

Initial commit — LithosAnanke kernel

2026-08-01 07:49:56 -04:00

reloc.S

Initial commit — LithosAnanke kernel

2026-08-01 07:49:56 -04:00

uefi_loader.c

Fix riscv64 boot crash: add missing kernel stack trampoline

2026-08-02 06:59:48 -04:00

README.md

src/starkernel/boot/

UEFI boot, kernel-image loading, and boot-time command-line handling.

uefi_loader.c — the UEFI application entry point (BOOTX64.EFI); calls ExitBootServices() to take ownership of hardware, builds BootInfo (memory map, ACPI, framebuffer), and hands off to kernel_main().
elf_loader.c — ELF64 kernel image parsing/loading.
cmdline.c — parses the boot-time kernel command line / starforth.cfg contents (see include/starkernel/cmdline.h, kernel_args.h).
reloc_stub.c, reloc.S — position-independent relocation support for the loaded image.