1/* $NetBSD: ksem.h,v 1.17 2023/07/11 11:37:29 riastradh Exp $ */
2
3/*
4 * Copyright (c) 2002 Alfred Perlstein <alfred@FreeBSD.org>
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
28
29#ifndef _SYS_KSEM_H_
30#define _SYS_KSEM_H_
31
32#include <sys/cdefs.h>
33
34#include <sys/types.h>
35
36struct timespec;
37
38#ifdef _KERNEL
39
40#include <sys/condvar.h>
41#include <sys/mutex.h>
42#include <sys/queue.h>
43
44#ifndef _KMEMUSER /* XXX hack for fstat(8) */
45#include <sys/systm.h>
46#endif
47
48struct lwp;
49struct proc;
50
51#define KSEM_MAX 128
52
53typedef struct ksem {
54 LIST_ENTRY(ksem) ks_entry; /* global list entry */
55 struct proc * ks_pshared_proc;/* owner of pshared sem */
56 intptr_t ks_pshared_id; /* global id for pshared sem */
57 kmutex_t ks_lock; /* lock on this ksem */
58 kcondvar_t ks_cv; /* condition variable */
59 u_int ks_pshared_fd; /* fd in owning proc */
60 u_int ks_ref; /* number of references */
61 u_int ks_value; /* current value */
62 u_int ks_waiters; /* number of waiters */
63 char * ks_name; /* name, if named */
64 size_t ks_namelen; /* length of name */
65 int ks_flags; /* for KS_UNLINKED */
66 mode_t ks_mode; /* protection bits */
67 uid_t ks_uid; /* creator uid */
68 gid_t ks_gid; /* creator gid */
69} ksem_t;
70
71int do_ksem_init(struct lwp *, unsigned int, intptr_t *, copyin_t, copyout_t);
72int do_ksem_open(struct lwp *, const char *, int, mode_t, unsigned int,
73 intptr_t *, copyout_t);
74int do_ksem_wait(struct lwp *, intptr_t, bool, struct timespec *);
75
76extern int ksem_max;
77#endif /* _KERNEL */
78
79#if defined(_KERNEL) || defined(_LIBC)
80#define KSEM_PSHARED 0x50535244U /* 'PSRD' */
81
82#define KSEM_MARKER_MASK 0xff000001U
83#define KSEM_MARKER_MIN 0x01000001U
84#define KSEM_PSHARED_MARKER 0x70000001U /* 'p' << 24 | 1 */
85#endif /* _KERNEL || _LIBC */
86
87#ifdef _LIBC
88__BEGIN_DECLS
89int _ksem_close(intptr_t);
90int _ksem_destroy(intptr_t);
91int _ksem_getvalue(intptr_t, int *);
92int _ksem_init(unsigned int, intptr_t *);
93int _ksem_open(const char *, int, mode_t, unsigned int, intptr_t *);
94int _ksem_post(intptr_t);
95int _ksem_timedwait(intptr_t, const struct timespec * __restrict);
96int _ksem_trywait(intptr_t);
97int _ksem_unlink(const char *);
98int _ksem_wait(intptr_t);
99__END_DECLS
100#endif /* _LIBC */
101
102#endif /* _SYS_KSEM_H_ */