1 /* $NetBSD: sleepq.h,v 1.42 2023/10/15 10:30:00 riastradh Exp $ */
2
3 /*-
4 * Copyright (c) 2002, 2006, 2007, 2008, 2009, 2019, 2020, 2023
5 * The NetBSD Foundation, Inc.
6 * All rights reserved.
7 *
8 * This code is derived from software contributed to The NetBSD Foundation
9 * by Jason R. Thorpe and Andrew Doran.
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
31 */
32
33 #ifndef _SYS_SLEEPQ_H_
34 #define _SYS_SLEEPQ_H_
35
36 #include <sys/param.h>
37
38 #include <sys/lwp.h>
39 #include <sys/mutex.h>
40 #include <sys/pool.h>
41 #include <sys/queue.h>
42 #include <sys/sched.h>
43 #include <sys/wchan.h>
44
45 struct syncobj;
46
47 /*
48 * Generic sleep queues.
49 */
50
51 typedef struct sleepq sleepq_t;
52
53 void sleepq_init(sleepq_t *);
54 void sleepq_remove(sleepq_t *, lwp_t *, bool);
55 int sleepq_enter(sleepq_t *, lwp_t *, kmutex_t *);
56 void sleepq_enqueue(sleepq_t *, wchan_t, const char *,
57 const struct syncobj *, bool);
58 void sleepq_transfer(lwp_t *, sleepq_t *, sleepq_t *, wchan_t, const char *,
59 const struct syncobj *, kmutex_t *, bool);
60 void sleepq_uncatch(lwp_t *);
61 void sleepq_unsleep(lwp_t *, bool);
62 void sleepq_timeout(void *);
63 void sleepq_wake(sleepq_t *, wchan_t, u_int, kmutex_t *);
64 int sleepq_abort(kmutex_t *, int);
65 void sleepq_changepri(lwp_t *, pri_t);
66 void sleepq_lendpri(lwp_t *, pri_t);
67 int sleepq_block(int, bool, const struct syncobj *, int);
68
69 #ifdef _KERNEL
70
71 #include <sys/kernel.h>
72
73 typedef union {
74 kmutex_t lock;
75 uint8_t pad[COHERENCY_UNIT];
76 } sleepqlock_t;
77
78 /*
79 * Return non-zero if it is unsafe to sleep.
80 *
81 * XXX This only exists because panic() is broken.
82 */
83 static __inline bool
sleepq_dontsleep(lwp_t * l)84 sleepq_dontsleep(lwp_t *l)
85 {
86
87 return cold || (doing_shutdown && (panicstr || CURCPU_IDLE_P()));
88 }
89
90 #endif /* _KERNEL */
91
92 #include <sys/sleeptab.h>
93
94 #endif /* _SYS_SLEEPQ_H_ */
95