From: Paolo Bonzini <pbonzini@redhat.com>
Date: Fri, 29 Aug 2025 08:31:34 +0000 (+0200)
Subject: cpus: document that qemu_cpu_kick() can be used for BQL-less operation
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9e1ecd4aaaf9aa2f5b7caf364a10241a2cba02a8;p=thirdparty%2Fqemu.git

cpus: document that qemu_cpu_kick() can be used for BQL-less operation

Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
---

diff --git a/include/hw/core/cpu.h b/include/hw/core/cpu.h
index 23bd02277f4..8b57bcd92c9 100644
--- a/include/hw/core/cpu.h
+++ b/include/hw/core/cpu.h
@@ -829,7 +829,8 @@ bool qemu_cpu_is_self(CPUState *cpu);
  * qemu_cpu_kick:
  * @cpu: The vCPU to kick.
  *
- * Kicks @cpu's thread.
+ * Kicks @cpu's thread to exit the accelerator.  For accelerators that
+ * can do that, the target vCPU thread will try not to take the BQL.
  */
 void qemu_cpu_kick(CPUState *cpu);