From 5e2312f75adcba8cfee343a03343bf298c5bc937 Mon Sep 17 00:00:00 2001 From: Akihiko Odaki Date: Thu, 29 May 2025 14:46:01 +0900 Subject: [PATCH] qemu-thread: Document QemuEvent Document QemuEvent to help choose an appropriate synchronization primitive. Signed-off-by: Akihiko Odaki Link: https://lore.kernel.org/r/20250529-event-v5-12-53b285203794@daynix.com Signed-off-by: Paolo Bonzini --- include/qemu/thread.h | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/include/qemu/thread.h b/include/qemu/thread.h index 573f8c9ede..f0302ed01f 100644 --- a/include/qemu/thread.h +++ b/include/qemu/thread.h @@ -10,6 +10,16 @@ typedef struct QemuSemaphore QemuSemaphore; typedef struct QemuLockCnt QemuLockCnt; typedef struct QemuThread QemuThread; +/* + * QemuEvent + * ========= + * + * QemuEvent is an implementation of Win32 manual-reset event object. + * For details, refer to: + * https://learn.microsoft.com/en-us/windows/win32/sync/using-event-objects + * + * QemuEvent is more lightweight than QemuSemaphore when HAVE_FUTEX is defined. + */ typedef struct QemuEvent { #ifndef HAVE_FUTEX pthread_mutex_t lock; -- 2.39.5