xref: /freebsd/include/semaphore.h (revision 732a02b4e77866604a120a275c082bb6221bd2ff)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
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  * $FreeBSD$
30  */
31 
32 /* semaphore.h: POSIX 1003.1b semaphores */
33 
34 #ifndef _SEMAPHORE_H_
35 #define _SEMAPHORE_H_
36 
37 #include <sys/cdefs.h>
38 #include <sys/_types.h>
39 #include <sys/_umtx.h>
40 
41 #include <machine/_limits.h>
42 
43 struct _sem {
44 	__uint32_t	_magic;
45 	struct _usem2	_kern;
46 	__uint32_t	_padding;	/* Preserve structure size */
47 };
48 
49 typedef	struct _sem	sem_t;
50 
51 #define	SEM_FAILED	((sem_t *)0)
52 #define	SEM_VALUE_MAX	__INT_MAX
53 
54 struct timespec;
55 
56 __BEGIN_DECLS
57 #if __BSD_VISIBLE
58 int	 sem_clockwait_np(sem_t * __restrict, __clockid_t, int,
59 	    const struct timespec *, struct timespec *);
60 #endif
61 int	 sem_close(sem_t *);
62 int	 sem_destroy(sem_t *);
63 int	 sem_getvalue(sem_t * __restrict, int * __restrict);
64 int	 sem_init(sem_t *, int, unsigned int);
65 sem_t	*sem_open(const char *, int, ...);
66 int	 sem_post(sem_t *);
67 int	 sem_timedwait(sem_t * __restrict, const struct timespec * __restrict);
68 int	 sem_trywait(sem_t *);
69 int	 sem_unlink(const char *);
70 int	 sem_wait(sem_t *);
71 __END_DECLS
72 
73 #endif /* !_SEMAPHORE_H_ */
74