1/*-
2 * Copyright (c) 2011 Ed Schouten <ed@FreeBSD.org>
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 *    notice, this list of conditions and the following disclaimer in the
12 *    documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD$
27 */
28
29#ifndef _THREADS_H_
30#define	_THREADS_H_
31
32#include <time.h>
33
34/*
35 * The C11 threads interface.
36 *
37 * This interface is implemented as a light-weight wrapper around
38 * <pthread.h>.  To prevent namespace pollution, the once_flag object,
39 * its corresponding ONCE_FLAG_INIT and TSS_DTOR_ITERATIONS have been
40 * copied from this header file.  They must be kept in sync.
41 */
42
43typedef struct pthread_cond	*cnd_t;
44typedef struct pthread_mutex	*mtx_t;
45typedef struct pthread		*thrd_t;
46typedef int			 tss_t;
47
48typedef struct {
49	int	__state;
50	mtx_t	__mutex;
51} once_flag;
52
53typedef void (*tss_dtor_t)(void *);
54typedef int (*thrd_start_t)(void *);
55
56enum {
57	mtx_plain = 0x1,
58	mtx_recursive = 0x2,
59	mtx_timed = 0x4
60};
61
62enum {
63	thrd_busy = 1,
64	thrd_error = 2,
65	thrd_nomem = 3,
66	thrd_success = 4,
67	thrd_timedout = 5
68};
69
70#if !defined(__cplusplus) || __cplusplus < 201103L
71#define	thread_local		_Thread_local
72#endif
73#define	ONCE_FLAG_INIT		{ 0, NULL }
74#define	TSS_DTOR_ITERATIONS	4
75
76__BEGIN_DECLS
77void	call_once(once_flag *, void (*)(void));
78int	cnd_broadcast(cnd_t *);
79void	cnd_destroy(cnd_t *);
80int	cnd_init(cnd_t *);
81int	cnd_signal(cnd_t *);
82int	cnd_timedwait(cnd_t *__restrict, mtx_t *__restrict,
83    const struct timespec *__restrict);
84int	cnd_wait(cnd_t *, mtx_t *);
85void	mtx_destroy(mtx_t *);
86int	mtx_init(mtx_t *, int);
87int	mtx_lock(mtx_t *);
88int	mtx_timedlock(mtx_t *__restrict, const struct timespec *__restrict);
89int	mtx_trylock(mtx_t *);
90int	mtx_unlock(mtx_t *);
91int	thrd_create(thrd_t *, thrd_start_t, void *);
92thrd_t	thrd_current(void);
93int	thrd_detach(thrd_t);
94int	thrd_equal(thrd_t, thrd_t);
95_Noreturn void
96	thrd_exit(int);
97int	thrd_join(thrd_t, int *);
98int	thrd_sleep(const struct timespec *, struct timespec *);
99void	thrd_yield(void);
100int	tss_create(tss_t *, tss_dtor_t);
101void	tss_delete(tss_t);
102void *	tss_get(tss_t);
103int	tss_set(tss_t, void *);
104__END_DECLS
105
106#endif /* !_THREADS_H_ */
107