xref: /dragonfly/sys/dev/drm/include/linux/wait.h (revision ed183f8c)
1 /*
2  * Copyright (c) 2014 Imre Vadász
3  * Copyright (c) 2014-2019 François Tigeot <ftigeot@wolfpond.org>
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice unmodified, this list of conditions, and the following
11  *    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 ``AS IS'' AND ANY EXPRESS OR
17  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 
28 #ifndef _LINUX_WAIT_H_
29 #define _LINUX_WAIT_H_
30 
31 #include <linux/list.h>
32 #include <linux/stddef.h>
33 #include <linux/spinlock.h>
34 #include <asm/current.h>
35 
36 typedef struct __wait_queue wait_queue_t;
37 
38 typedef int (*wait_queue_func_t)(wait_queue_t *wait, unsigned mode, int flags, void *key);
39 
40 int default_wake_function(wait_queue_t *wait, unsigned mode, int flags, void *key);
41 int autoremove_wake_function(wait_queue_t *wait, unsigned mode, int sync, void *key);
42 
43 struct __wait_queue {
44 	unsigned int flags;
45 	void *private;
46 	wait_queue_func_t func;
47 	struct list_head task_list;
48 };
49 
50 typedef struct {
51 	struct lock		lock;
52 	struct list_head	task_list;
53 } wait_queue_head_t;
54 
55 static inline void
56 init_waitqueue_head(wait_queue_head_t *eq)
57 {
58 	lockinit(&eq->lock, "lwq", 0, LK_CANRECURSE);
59 	INIT_LIST_HEAD(&eq->task_list);
60 }
61 
62 void __wake_up_core(wait_queue_head_t *q, int num_to_wake_up);
63 
64 static inline void
65 wake_up(wait_queue_head_t *q)
66 {
67 	lockmgr(&q->lock, LK_EXCLUSIVE);
68 	__wake_up_core(q, 1);
69 	lockmgr(&q->lock, LK_RELEASE);
70 	wakeup_one(q);
71 }
72 
73 static inline void
74 wake_up_all(wait_queue_head_t *q)
75 {
76 	lockmgr(&q->lock, LK_EXCLUSIVE);
77 	__wake_up_core(q, 0);
78 	lockmgr(&q->lock, LK_RELEASE);
79 	wakeup(q);
80 }
81 
82 #define wake_up_all_locked(eq)		__wake_up_core(eq, 0)
83 
84 #define wake_up_interruptible(eq)	wake_up(eq)
85 #define wake_up_interruptible_all(eq)	wake_up_all(eq)
86 
87 /*
88  * wait_event_interruptible_timeout:
89  * - The process is put to sleep until the condition evaluates to true.
90  * - The condition is checked each time the waitqueue wq is woken up.
91  * - wake_up has to be called after changing any variable that could change
92  * the result of the wait condition.
93  *
94  * returns:
95  *   - 0 if the timeout elapsed
96  *   - the remaining jiffies if the condition evaluated to true before
97  *   the timeout elapsed.
98  *   - remaining jiffies are always at least 1
99  *   - -ERESTARTSYS if interrupted by a signal (when PCATCH is set in flags)
100 */
101 #define __wait_event_common(wq, condition, timeout_jiffies, flags,	\
102 			    locked)					\
103 ({									\
104 	int start_jiffies, elapsed_jiffies, remaining_jiffies, ret;	\
105 	bool timeout_expired = false;					\
106 	bool interrupted = false;					\
107 	long retval;							\
108 									\
109 	start_jiffies = ticks;						\
110 									\
111 	if (!locked)							\
112 		lockmgr(&wq.lock, LK_EXCLUSIVE);			\
113 	while (1) {							\
114 		if (condition)						\
115 			break;						\
116 									\
117 		if (flags == PCATCH) {					\
118 			__set_current_state(TASK_INTERRUPTIBLE);	\
119 		} else {						\
120 			__set_current_state(TASK_UNINTERRUPTIBLE);	\
121 		}							\
122 									\
123 		ret = lksleep(&wq, &wq.lock, flags,			\
124 					"lwe", timeout_jiffies);	\
125 		if (ret == EINTR || ret == ERESTART) {			\
126 			interrupted = true;				\
127 			break;						\
128 		}							\
129 		if (ret == EWOULDBLOCK) {				\
130 			timeout_expired = true;				\
131 			break;						\
132 		}							\
133 	}								\
134 	if (!locked)							\
135 		lockmgr(&wq.lock, LK_RELEASE);				\
136 									\
137 	elapsed_jiffies = ticks - start_jiffies;			\
138 	remaining_jiffies = timeout_jiffies - elapsed_jiffies;		\
139 	if (remaining_jiffies <= 0)					\
140 		remaining_jiffies = 1;					\
141 									\
142 	if (timeout_expired)						\
143 		retval = 0;						\
144 	else if (interrupted)						\
145 		retval = -ERESTARTSYS;					\
146 	else if (timeout_jiffies > 0)					\
147 		retval = remaining_jiffies;				\
148 	else								\
149 		retval = 1;						\
150 									\
151 	__set_current_state(TASK_RUNNING);				\
152 	retval;								\
153 })
154 
155 #define wait_event(wq, condition)					\
156 		__wait_event_common(wq, condition, 0, 0, false)
157 
158 #define wait_event_timeout(wq, condition, timeout)			\
159 		__wait_event_common(wq, condition, timeout, 0, false)
160 
161 #define wait_event_interruptible(wq, condition)				\
162 ({									\
163 	long retval;							\
164 									\
165 	retval = __wait_event_common(wq, condition, 0, PCATCH, false);	\
166 	if (retval != -ERESTARTSYS)					\
167 		retval = 0;						\
168 	retval;								\
169 })
170 
171 #define wait_event_interruptible_locked(wq, condition)			\
172 ({									\
173 	long retval;							\
174 									\
175 	retval = __wait_event_common(wq, condition, 0, PCATCH, true);	\
176 	if (retval != -ERESTARTSYS)					\
177 		retval = 0;						\
178 	retval;								\
179 })
180 
181 #define wait_event_interruptible_timeout(wq, condition, timeout)	\
182 		__wait_event_common(wq, condition, timeout, PCATCH, false)
183 
184 static inline int
185 waitqueue_active(wait_queue_head_t *q)
186 {
187 	return !list_empty(&q->task_list);
188 }
189 
190 #define DEFINE_WAIT(name)					\
191 	wait_queue_t name = {					\
192 		.private = current,				\
193 		.task_list = LIST_HEAD_INIT((name).task_list),	\
194 	}
195 
196 static inline void
197 prepare_to_wait(wait_queue_head_t *q, wait_queue_t *wait, int state)
198 {
199 }
200 
201 static inline void
202 finish_wait(wait_queue_head_t *q, wait_queue_t *wait)
203 {
204 }
205 
206 static inline void
207 add_wait_queue(wait_queue_head_t *q, wait_queue_t *wait)
208 {
209 }
210 
211 static inline void
212 __add_wait_queue(wait_queue_head_t *head, wait_queue_t *new)
213 {
214 	list_add(&new->task_list, &head->task_list);
215 }
216 
217 #define DECLARE_WAIT_QUEUE_HEAD(name)					\
218 	wait_queue_head_t name = {					\
219 		.lock = LOCK_INITIALIZER("name", 0, LK_CANRECURSE),	\
220 		.task_list = { &(name).task_list, &(name).task_list }	\
221 	}
222 
223 static inline void
224 __remove_wait_queue(wait_queue_head_t *head, wait_queue_t *old)
225 {
226 	list_del(&old->task_list);
227 }
228 
229 #endif	/* _LINUX_WAIT_H_ */
230