xref: /qemu/include/qemu/thread.h (revision 33848cee)
1 #ifndef QEMU_THREAD_H
2 #define QEMU_THREAD_H
3 
4 #include "qemu/processor.h"
5 #include "qemu/atomic.h"
6 
7 typedef struct QemuMutex QemuMutex;
8 typedef struct QemuCond QemuCond;
9 typedef struct QemuSemaphore QemuSemaphore;
10 typedef struct QemuEvent QemuEvent;
11 typedef struct QemuThread QemuThread;
12 
13 #ifdef _WIN32
14 #include "qemu/thread-win32.h"
15 #else
16 #include "qemu/thread-posix.h"
17 #endif
18 
19 #define QEMU_THREAD_JOINABLE 0
20 #define QEMU_THREAD_DETACHED 1
21 
22 void qemu_mutex_init(QemuMutex *mutex);
23 void qemu_mutex_destroy(QemuMutex *mutex);
24 void qemu_mutex_lock(QemuMutex *mutex);
25 int qemu_mutex_trylock(QemuMutex *mutex);
26 void qemu_mutex_unlock(QemuMutex *mutex);
27 
28 /* Prototypes for other functions are in thread-posix.h/thread-win32.h.  */
29 void qemu_rec_mutex_init(QemuRecMutex *mutex);
30 
31 void qemu_cond_init(QemuCond *cond);
32 void qemu_cond_destroy(QemuCond *cond);
33 
34 /*
35  * IMPORTANT: The implementation does not guarantee that pthread_cond_signal
36  * and pthread_cond_broadcast can be called except while the same mutex is
37  * held as in the corresponding pthread_cond_wait calls!
38  */
39 void qemu_cond_signal(QemuCond *cond);
40 void qemu_cond_broadcast(QemuCond *cond);
41 void qemu_cond_wait(QemuCond *cond, QemuMutex *mutex);
42 
43 void qemu_sem_init(QemuSemaphore *sem, int init);
44 void qemu_sem_post(QemuSemaphore *sem);
45 void qemu_sem_wait(QemuSemaphore *sem);
46 int qemu_sem_timedwait(QemuSemaphore *sem, int ms);
47 void qemu_sem_destroy(QemuSemaphore *sem);
48 
49 void qemu_event_init(QemuEvent *ev, bool init);
50 void qemu_event_set(QemuEvent *ev);
51 void qemu_event_reset(QemuEvent *ev);
52 void qemu_event_wait(QemuEvent *ev);
53 void qemu_event_destroy(QemuEvent *ev);
54 
55 void qemu_thread_create(QemuThread *thread, const char *name,
56                         void *(*start_routine)(void *),
57                         void *arg, int mode);
58 void *qemu_thread_join(QemuThread *thread);
59 void qemu_thread_get_self(QemuThread *thread);
60 bool qemu_thread_is_self(QemuThread *thread);
61 void qemu_thread_exit(void *retval);
62 void qemu_thread_naming(bool enable);
63 
64 struct Notifier;
65 void qemu_thread_atexit_add(struct Notifier *notifier);
66 void qemu_thread_atexit_remove(struct Notifier *notifier);
67 
68 typedef struct QemuSpin {
69     int value;
70 } QemuSpin;
71 
72 static inline void qemu_spin_init(QemuSpin *spin)
73 {
74     __sync_lock_release(&spin->value);
75 }
76 
77 static inline void qemu_spin_lock(QemuSpin *spin)
78 {
79     while (unlikely(__sync_lock_test_and_set(&spin->value, true))) {
80         while (atomic_read(&spin->value)) {
81             cpu_relax();
82         }
83     }
84 }
85 
86 static inline bool qemu_spin_trylock(QemuSpin *spin)
87 {
88     return __sync_lock_test_and_set(&spin->value, true);
89 }
90 
91 static inline bool qemu_spin_locked(QemuSpin *spin)
92 {
93     return atomic_read(&spin->value);
94 }
95 
96 static inline void qemu_spin_unlock(QemuSpin *spin)
97 {
98     __sync_lock_release(&spin->value);
99 }
100 
101 #endif
102