From: Warner Losh <imp@bsdimp.com>
Date: Sun, 16 Jan 2022 23:33:21 +0000 (-0700)
Subject: bsd-user: Bring in docs from linux-user for signal_pending
X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=4804722593bd1735ce810e380247788200bcb961;p=qemu.git

bsd-user: Bring in docs from linux-user for signal_pending

This is currently unused, so no code adjustments are needed.

Signed-off-by: Warner Losh <imp@bsdimp.com>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
---

diff --git a/bsd-user/qemu.h b/bsd-user/qemu.h
index 4dd209e402..671b26f00c 100644
--- a/bsd-user/qemu.h
+++ b/bsd-user/qemu.h
@@ -86,7 +86,14 @@ typedef struct TaskState {
     struct image_info *info;
 
     struct emulated_sigtable sigtab[TARGET_NSIG];
-    int signal_pending; /* non zero if a signal may be pending */
+    /*
+     * Nonzero if process_pending_signals() needs to do something (either
+     * handle a pending signal or unblock signals).
+     * This flag is written from a signal handler so should be accessed via
+     * the qatomic_read() and qatomic_set() functions. (It is not accessed
+     * from multiple threads.)
+     */
+    int signal_pending;
 
     uint8_t stack[];
 } __attribute__((aligned(16))) TaskState;