docs/tracing.txt: Update documentation of default backend
[qemu.git] / include / qemu / thread.h
blobe8e665f020fac814024e496adeb52ac4c57d6346
1 #ifndef QEMU_THREAD_H
2 #define QEMU_THREAD_H
4 #include "qemu/processor.h"
5 #include "qemu/atomic.h"
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;
13 #ifdef _WIN32
14 #include "qemu/thread-win32.h"
15 #else
16 #include "qemu/thread-posix.h"
17 #endif
19 #define QEMU_THREAD_JOINABLE 0
20 #define QEMU_THREAD_DETACHED 1
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);
28 /* Prototypes for other functions are in thread-posix.h/thread-win32.h. */
29 void qemu_rec_mutex_init(QemuRecMutex *mutex);
31 void qemu_cond_init(QemuCond *cond);
32 void qemu_cond_destroy(QemuCond *cond);
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!
39 void qemu_cond_signal(QemuCond *cond);
40 void qemu_cond_broadcast(QemuCond *cond);
41 void qemu_cond_wait(QemuCond *cond, QemuMutex *mutex);
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);
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);
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);
64 struct Notifier;
65 void qemu_thread_atexit_add(struct Notifier *notifier);
66 void qemu_thread_atexit_remove(struct Notifier *notifier);
68 typedef struct QemuSpin {
69 int value;
70 } QemuSpin;
72 static inline void qemu_spin_init(QemuSpin *spin)
74 __sync_lock_release(&spin->value);
77 static inline void qemu_spin_lock(QemuSpin *spin)
79 while (unlikely(__sync_lock_test_and_set(&spin->value, true))) {
80 while (atomic_read(&spin->value)) {
81 cpu_relax();
86 static inline bool qemu_spin_trylock(QemuSpin *spin)
88 return __sync_lock_test_and_set(&spin->value, true);
91 static inline bool qemu_spin_locked(QemuSpin *spin)
93 return atomic_read(&spin->value);
96 static inline void qemu_spin_unlock(QemuSpin *spin)
98 __sync_lock_release(&spin->value);
101 #endif