docs: document the riscv64 RVA23 profile CPU requirement

2026-09-21 01:24:11 +02:00
parent ba90e0f367
commit f36897abc2
2 changed files with 2 additions and 0 deletions
@@ -282,6 +282,7 @@ ecr --kernel=/boot/vmlinuz debian -- /bin/sh -c "echo hello"
   - `-display none -serial mon:stdio` - console on stdio
   - `-netdev user,id=net0 -device virtio-net-pci,netdev=net0` - network NIC
   - `-enable-kvm -cpu host` - when the host supports KVM and the target matches the host architecture
+   - `-cpu rva23s64` - riscv64 under TCG otherwise. Ubuntu builds its riscv64 port against the RVA23 profile (since 25.10); QEMU's default `rv64` CPU does not implement all profile extensions, so Ubuntu binaries die with SIGILL during init. Profiles are supersets, so baseline rv64gc rootfses (Alpine, older Ubuntu) run unchanged. Needs QEMU ≥ 10.1 (named profile CPUs).
 5. Wait for QEMU to exit (init powers the VM off when the command/shell exits; `-no-reboot` makes QEMU terminate)
 6. Cleanup temporary files