xref: /freebsd/include/semaphore.h (revision b3e76948)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2010 David Xu <davidxu@freebsd.org>
5  *
6  * All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice unmodified, this list of conditions, and the following
13  *    disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 /* semaphore.h: POSIX 1003.1b semaphores */
31 
32 #ifndef _SEMAPHORE_H_
33 #define _SEMAPHORE_H_
34 
35 #include <sys/cdefs.h>
36 #include <sys/_types.h>
37 #include <sys/_umtx.h>
38 
39 #include <machine/_limits.h>
40 
41 struct _sem {
42 	__uint32_t	_magic;
43 	struct _usem2	_kern;
44 	__uint32_t	_padding;	/* Preserve structure size */
45 };
46 
47 typedef	struct _sem	sem_t;
48 
49 #define	SEM_FAILED	((sem_t *)0)
50 #define	SEM_VALUE_MAX	__INT_MAX
51 
52 struct timespec;
53 
54 __BEGIN_DECLS
55 #if __BSD_VISIBLE
56 int	 sem_clockwait_np(sem_t * __restrict, __clockid_t, int,
57 	    const struct timespec *, struct timespec *);
58 #endif
59 int	 sem_close(sem_t *);
60 int	 sem_destroy(sem_t *);
61 int	 sem_getvalue(sem_t * __restrict, int * __restrict);
62 int	 sem_init(sem_t *, int, unsigned int);
63 sem_t	*sem_open(const char *, int, ...);
64 int	 sem_post(sem_t *);
65 int	 sem_timedwait(sem_t * __restrict, const struct timespec * __restrict);
66 int	 sem_trywait(sem_t *);
67 int	 sem_unlink(const char *);
68 int	 sem_wait(sem_t *);
69 __END_DECLS
70 
71 #endif /* !_SEMAPHORE_H_ */
72