]> git.ipfire.org Git - thirdparty/qemu.git/commit
docs: deprecate RISC-V default machine option
authorDaniel Henrique Barboza <dbarboza@ventanamicro.com>
Fri, 4 Apr 2025 12:28:58 +0000 (09:28 -0300)
committerAlistair Francis <alistair.francis@wdc.com>
Mon, 7 Apr 2025 00:12:40 +0000 (10:12 +1000)
commitd31d37fded414959713678d2e9e6bc1afab5f376
tree99774d5f3b5765e9252e316155476b3dfbad288b
parent53f3a13ac1069975ad47cf8bd05cc96b4ac09962
docs: deprecate RISC-V default machine option

Commit 5b4beba124 ("RISC-V Spike Machines") added the Spike machine and
made it default for qemu-system-riscv32/64. It was the first RISC-V
machine added in QEMU so setting it as default was sensible.

Today we have 7 riscv64 and 6 riscv32 machines and having 'spike' as
default machine is not intuitive. For example, [1] is a bug that was
opened with the 'virt' board in mind, but given that the user didn't
pass a '-machine' option, the user was using 'spike' without knowing.

Being explicit in the command line is desirable when we have a handful
of boards available, so deprecate the default machine setting from
RISC-V.

[1] https://gitlab.com/qemu-project/qemu/-/issues/2467

Suggested-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Signed-off-by: Daniel Henrique Barboza <dbarboza@ventanamicro.com>
Reviewed-by: Alistair Francis <alistair.francis@wdc.com>
Reviewed-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Message-ID: <20250404122858.241598-1-dbarboza@ventanamicro.com>
Signed-off-by: Alistair Francis <alistair.francis@wdc.com>
docs/about/deprecated.rst