[PATCH 02/16] cpus: Improve qemu_cpu_kick_self() docstring
Philippe Mathieu-Daudé <[email protected]>
| Newsgroups | org.nongnu.qemu-devel,org.kernel.vger.kvm,org.nongnu.qemu-arm,org.nongnu.qemu-riscv |
|---|---|
| Message-ID | <[email protected]> |
Be a bit more descriptive than "Unblock cpu" :) Signed-off-by: Philippe Mathieu-Daudé <[email protected]> --- include/system/cpus.h | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/include/system/cpus.h b/include/system/cpus.h index 508444ccf1c..ade13e068eb 100644 --- a/include/system/cpus.h +++ b/include/system/cpus.h @@ -30,7 +30,15 @@ void resume_all_vcpus(void); void pause_all_vcpus(void); void cpu_stop_current(void); -/* Unblock cpu */ +/** + * qemu_cpu_kick_self - Force vCPU to re-enter to its inner main loop + * + * Signal the current vCPU thread to exit any blocking operations and + * re-enter its inner execution loop to process pending requests, + * possibly returning to its outer execution loop. + * + * Must be called from within the vCPU thread itself. + */ void qemu_cpu_kick_self(void); bool cpus_are_resettable(void); -- 2.53.0