1 /* $NetBSD: threads.h,v 1.3 2019/09/10 22:34:19 kamil Exp $ */ 2 3 /*- 4 * Copyright (c) 2016 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Kamil Rytarowski. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29 * POSSIBILITY OF SUCH DAMAGE. 30 */ 31 32 #ifndef _THREADS_H_ 33 #define _THREADS_H_ 34 35 #include <sys/cdefs.h> 36 #include <limits.h> 37 #include <pthread.h> 38 #include <stdint.h> 39 #include <time.h> 40 41 /* ISO/IEC 9899:201x 7.26.1/3 */ 42 #ifndef __thread_local_is_defined 43 #if ((__cplusplus - 0) < 201103L) 44 #define thread_local _Thread_local 45 #endif 46 #define __thread_local_is_defined 47 #endif /* __thread_local_is_defined */ 48 49 #ifndef ONCE_FLAG_INIT 50 #define ONCE_FLAG_INIT PTHREAD_ONCE_INIT 51 #endif /* ONCE_FLAG_INIT */ 52 53 #ifndef TSS_DTOR_ITERATIONS 54 #define TSS_DTOR_ITERATIONS PTHREAD_DESTRUCTOR_ITERATIONS 55 #endif /* TSS_DTOR_ITERATIONS */ 56 57 /* ISO/IEC 9899:201x 7.26.1/4 */ 58 typedef pthread_cond_t cnd_t; 59 typedef pthread_t thrd_t; 60 typedef pthread_key_t tss_t; 61 typedef pthread_mutex_t mtx_t; 62 typedef void (*tss_dtor_t) (void *); 63 typedef int (*thrd_start_t) (void *); 64 typedef pthread_once_t once_flag; 65 66 /* ISO/IEC 9899:201x 7.26.1/5 */ 67 enum { 68 mtx_plain = 1, 69 mtx_recursive = 2, 70 mtx_timed = 4, 71 _MTX_MAXTYPE = 0x7fffffff 72 }; 73 74 enum { 75 thrd_timedout = -1, 76 thrd_success = 0, 77 thrd_busy = 1, 78 thrd_error = 2, 79 thrd_nomem = 3, 80 _THRD_MAXTYPE = 0x7fffffff 81 }; 82 83 __BEGIN_DECLS 84 /* ISO/IEC 9899:201x 7.26.2 Initialization functions */ 85 void call_once(once_flag *, void (*)(void)); 86 87 /* ISO/IEC 9899:201x 7.26.3 Condition variable functions */ 88 int cnd_broadcast(cnd_t *); 89 void cnd_destroy(cnd_t *); 90 int cnd_init(cnd_t *); 91 int cnd_signal(cnd_t *); 92 int cnd_timedwait(cnd_t * __restrict, mtx_t * __restrict, 93 const struct timespec * __restrict); 94 int cnd_wait(cnd_t *, mtx_t *); 95 96 /* ISO/IEC 9899:201x 7.26.4 Mutex functions */ 97 void mtx_destroy(mtx_t *); 98 int mtx_init(mtx_t *, int); 99 int mtx_lock(mtx_t *); 100 int mtx_timedlock(mtx_t *__restrict, const struct timespec *__restrict); 101 int mtx_trylock(mtx_t *); 102 int mtx_unlock(mtx_t *); 103 104 /* ISO/IEC 9899:201x 7.26.5 Thread functions */ 105 int thrd_create(thrd_t *, thrd_start_t, void *); 106 thrd_t thrd_current(void); 107 int thrd_detach(thrd_t); 108 int thrd_equal(thrd_t, thrd_t); 109 __dead void thrd_exit(int); 110 int thrd_join(thrd_t, int *); 111 int thrd_sleep(const struct timespec *, struct timespec *); 112 void thrd_yield(void); 113 114 /* ISO/IEC 9899:201x 7.26.6 Thread-specific storage functions */ 115 int tss_create(tss_t *, tss_dtor_t); 116 void tss_delete(tss_t); 117 void *tss_get(tss_t); 118 int tss_set(tss_t, void *); 119 __END_DECLS 120 121 #endif 122