]> pd.if.org Git - pdclib/blob - includes/threads.h
assert: for assert(x), mark !x case as _PDCLIB_UNREACHABLE
[pdclib] / includes / threads.h
1 #ifndef _PDCLIB_THREADS_H\r
2 #define _PDCLIB_THREADS_H\r
3 #include <_PDCLIB_threadconfig.h>\r
4 #include <time.h>\r
5 _PDCLIB_BEGIN_EXTERN_C\r
6 \r
7 #define thread_local _Thread_local\r
8 \r
9 typedef _PDCLIB_once_flag once_flag;\r
10 \r
11 enum {\r
12         mtx_plain               = 0,\r
13         mtx_recursive   = (1 << 0),\r
14         mtx_timed               = (1 << 1),\r
15 \r
16         _PDCLIB_mtx_valid_mask = mtx_recursive | mtx_timed\r
17 };\r
18 \r
19 enum {\r
20         thrd_success    = 0,\r
21         thrd_timeout    = 1,\r
22         thrd_busy               = 2,\r
23         thrd_error              = 3,\r
24         thrd_nomem              = 4,\r
25 };\r
26 \r
27 #define ONCE_FLAG_INIT _PDCLIB_ONCE_FLAG_INIT\r
28 #if defined(_PDCLIB_ONCE_FLAG_IS_DONE)\r
29 static inline void call_once(once_flag *flag, void (*func)(void))\r
30 {\r
31         if(!_PDCLIB_ONCE_FLAG_IS_DONE(flag)) {\r
32                 _PDCLIB_call_once(flag, func);\r
33         }\r
34 }\r
35 #else\r
36 void call_once(once_flag *flag, void (*func)(void));\r
37 #endif\r
38 \r
39 #if defined(_PDCLIB_MTX_T)\r
40 typedef _PDCLIB_MTX_T   mtx_t;\r
41 void mtx_destroy(mtx_t *mtx) _PDCLIB_nothrow;\r
42 int mtx_init(mtx_t *mtx, int type) _PDCLIB_nothrow;\r
43 int mtx_lock(mtx_t *mtx) _PDCLIB_nothrow;\r
44 int mtx_timedlock(mtx_t *_PDCLIB_restrict mtx, const struct timespec *_PDCLIB_restrict ts) _PDCLIB_nothrow;\r
45 int mtx_trylock(mtx_t *mtx) _PDCLIB_nothrow;\r
46 int mtx_unlock(mtx_t *mtx) _PDCLIB_nothrow;\r
47 #endif\r
48 \r
49 #if defined(_PDCLIB_CND_T)\r
50 typedef _PDCLIB_CND_T   cnd_t;\r
51 int cnd_broadcast(cnd_t *cond) _PDCLIB_nothrow;\r
52 void cnd_destroy(cnd_t *cond) _PDCLIB_nothrow;\r
53 int cnd_init(cnd_t *cond) _PDCLIB_nothrow;\r
54 int cnd_signal(cnd_t *cond) _PDCLIB_nothrow;\r
55 int cnd_timedwait(cnd_t *_PDCLIB_restrict cond,\r
56         mtx_t *_PDCLIB_restrict mtx,\r
57         const struct timespec *_PDCLIB_restrict ts) _PDCLIB_nothrow;\r
58 int cnd_wait(cnd_t *cond, mtx_t *mtx) _PDCLIB_nothrow;\r
59 #endif\r
60 \r
61 #if defined(_PDCLIB_THRD_T)\r
62 #define _PDCLIB_THRD_HAVE_MISC\r
63 typedef _PDCLIB_THRD_T  thrd_t;\r
64 typedef int (*thrd_start_t)(void*);\r
65 \r
66 int thrd_create(thrd_t *thr, thrd_start_t func, void *arg) _PDCLIB_nothrow;\r
67 thrd_t thrd_current(void) _PDCLIB_nothrow;\r
68 int thrd_detach(thrd_t thr) _PDCLIB_nothrow;\r
69 int thrd_equal(thrd_t thr0, thrd_t thr1) _PDCLIB_nothrow;\r
70 \r
71 /* Not nothrow: systems may use exceptions at thread exit */\r
72 _PDCLIB_noreturn void thrd_exit(int res);\r
73 /* Not nothrow: systems may potentially propogate exceptions out of thrd_join?*/\r
74 int thrd_join(thrd_t thr, int *res);\r
75 #endif\r
76 \r
77 #if defined(_PDCLIB_THRD_HAVE_MISC)\r
78 int thrd_sleep(const struct timespec *duration, struct timespec *remaining) _PDCLIB_nothrow;\r
79 void thrd_yield(void) _PDCLIB_nothrow;\r
80 #endif\r
81 \r
82 /* The behaviour of tss_t is woefully underspecified in the C11 standard. In \r
83  * particular, it never specifies where/when/<b>if</b> destructors are called.\r
84  *\r
85  * In lieu of any clarification, we assume the behaviour of POSIX pthread_key_t\r
86  */\r
87 \r
88 #if defined(_PDCLIB_TSS_T)\r
89 #define TSS_DTOR_ITERATIONS _PDCLIB_TSS_DTOR_ITERATIONS\r
90 \r
91 typedef _PDCLIB_TSS_T   tss_t;\r
92 typedef void (*tss_dtor_t)(void*);\r
93 \r
94 int tss_create(tss_t *key, tss_dtor_t dtor) _PDCLIB_nothrow;\r
95 void tss_delete(tss_t key) _PDCLIB_nothrow;\r
96 void *tss_get(tss_t key) _PDCLIB_nothrow;\r
97 int tss_set(tss_t key, void *val) _PDCLIB_nothrow;\r
98 #endif\r
99 \r
100 _PDCLIB_END_EXTERN_C\r
101 #endif\r