Commit 703bc80f55 for qemu.org

commit 703bc80f553f19993eaaee249f53386d38f42122
Author: Alex Bennée <alex.bennee@linaro.org>
Date:   Thu Feb 19 17:18:10 2026 +0000

    hw/core/cpu: expand cpu_reset function docs

    Add a hint to the developer that this should only be called from a
    reset chain.

    Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
    Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
    Reviewed-by: Pierrick Bouvier <pierrick.bouvier@linaro.org>
    Message-ID: <20260219171810.602667-15-alex.bennee@linaro.org>
    Signed-off-by: Philippe Mathieu-Daudé <philmd@linaro.org>

diff --git a/include/hw/core/cpu.h b/include/hw/core/cpu.h
index ef20cb356a..89934b8efe 100644
--- a/include/hw/core/cpu.h
+++ b/include/hw/core/cpu.h
@@ -815,6 +815,9 @@ void cpu_list_remove(CPUState *cpu);
 /**
  * cpu_reset:
  * @cpu: The CPU whose state is to be reset.
+ *
+ * You should refrain from calling this during CPU realization and
+ * make sure this is called from the reset logic instead.
  */
 void cpu_reset(CPUState *cpu);