blob: 7d7819dafcc566ad4f77e0bf26a700bbf8e9e6d4 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _LINUX_WAIT_H
2#define _LINUX_WAIT_H
3
Linus Torvalds1da177e2005-04-16 15:20:36 -07004
Linus Torvalds1da177e2005-04-16 15:20:36 -07005#include <linux/list.h>
6#include <linux/stddef.h>
7#include <linux/spinlock.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -07008#include <asm/current.h>
David Howells607ca462012-10-13 10:46:48 +01009#include <uapi/linux/wait.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070010
11typedef struct __wait_queue wait_queue_t;
Peter Zijlstra7d478722009-09-14 19:55:44 +020012typedef int (*wait_queue_func_t)(wait_queue_t *wait, unsigned mode, int flags, void *key);
13int default_wake_function(wait_queue_t *wait, unsigned mode, int flags, void *key);
Linus Torvalds1da177e2005-04-16 15:20:36 -070014
15struct __wait_queue {
16 unsigned int flags;
17#define WQ_FLAG_EXCLUSIVE 0x01
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -070018 void *private;
Linus Torvalds1da177e2005-04-16 15:20:36 -070019 wait_queue_func_t func;
20 struct list_head task_list;
21};
22
23struct wait_bit_key {
24 void *flags;
25 int bit_nr;
David Howellscb655372013-05-10 19:50:26 +010026#define WAIT_ATOMIC_T_BIT_NR -1
Linus Torvalds1da177e2005-04-16 15:20:36 -070027};
28
29struct wait_bit_queue {
30 struct wait_bit_key key;
31 wait_queue_t wait;
32};
33
34struct __wait_queue_head {
35 spinlock_t lock;
36 struct list_head task_list;
37};
38typedef struct __wait_queue_head wait_queue_head_t;
39
Tim Schmielau8c65b4a2005-11-07 00:59:43 -080040struct task_struct;
Linus Torvalds1da177e2005-04-16 15:20:36 -070041
42/*
43 * Macros for declaration and initialisaton of the datatypes
44 */
45
46#define __WAITQUEUE_INITIALIZER(name, tsk) { \
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -070047 .private = tsk, \
Linus Torvalds1da177e2005-04-16 15:20:36 -070048 .func = default_wake_function, \
49 .task_list = { NULL, NULL } }
50
51#define DECLARE_WAITQUEUE(name, tsk) \
52 wait_queue_t name = __WAITQUEUE_INITIALIZER(name, tsk)
53
54#define __WAIT_QUEUE_HEAD_INITIALIZER(name) { \
Ingo Molnare4d91912006-07-03 00:24:34 -070055 .lock = __SPIN_LOCK_UNLOCKED(name.lock), \
Linus Torvalds1da177e2005-04-16 15:20:36 -070056 .task_list = { &(name).task_list, &(name).task_list } }
57
58#define DECLARE_WAIT_QUEUE_HEAD(name) \
59 wait_queue_head_t name = __WAIT_QUEUE_HEAD_INITIALIZER(name)
60
61#define __WAIT_BIT_KEY_INITIALIZER(word, bit) \
62 { .flags = word, .bit_nr = bit, }
63
David Howellscb655372013-05-10 19:50:26 +010064#define __WAIT_ATOMIC_T_KEY_INITIALIZER(p) \
65 { .flags = p, .bit_nr = WAIT_ATOMIC_T_BIT_NR, }
66
Peter Zijlstraf07fdec2011-12-13 13:20:54 +010067extern void __init_waitqueue_head(wait_queue_head_t *q, const char *name, struct lock_class_key *);
Peter Zijlstra2fc39112009-08-10 12:33:05 +010068
69#define init_waitqueue_head(q) \
70 do { \
71 static struct lock_class_key __key; \
72 \
Peter Zijlstraf07fdec2011-12-13 13:20:54 +010073 __init_waitqueue_head((q), #q, &__key); \
Peter Zijlstra2fc39112009-08-10 12:33:05 +010074 } while (0)
Linus Torvalds1da177e2005-04-16 15:20:36 -070075
Peter Zijlstra7259f0d2006-10-29 22:46:36 -080076#ifdef CONFIG_LOCKDEP
77# define __WAIT_QUEUE_HEAD_INIT_ONSTACK(name) \
78 ({ init_waitqueue_head(&name); name; })
79# define DECLARE_WAIT_QUEUE_HEAD_ONSTACK(name) \
80 wait_queue_head_t name = __WAIT_QUEUE_HEAD_INIT_ONSTACK(name)
81#else
82# define DECLARE_WAIT_QUEUE_HEAD_ONSTACK(name) DECLARE_WAIT_QUEUE_HEAD(name)
83#endif
84
Linus Torvalds1da177e2005-04-16 15:20:36 -070085static inline void init_waitqueue_entry(wait_queue_t *q, struct task_struct *p)
86{
87 q->flags = 0;
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -070088 q->private = p;
Linus Torvalds1da177e2005-04-16 15:20:36 -070089 q->func = default_wake_function;
90}
91
92static inline void init_waitqueue_func_entry(wait_queue_t *q,
93 wait_queue_func_t func)
94{
95 q->flags = 0;
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -070096 q->private = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -070097 q->func = func;
98}
99
100static inline int waitqueue_active(wait_queue_head_t *q)
101{
102 return !list_empty(&q->task_list);
103}
104
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800105extern void add_wait_queue(wait_queue_head_t *q, wait_queue_t *wait);
106extern void add_wait_queue_exclusive(wait_queue_head_t *q, wait_queue_t *wait);
107extern void remove_wait_queue(wait_queue_head_t *q, wait_queue_t *wait);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700108
109static inline void __add_wait_queue(wait_queue_head_t *head, wait_queue_t *new)
110{
111 list_add(&new->task_list, &head->task_list);
112}
113
114/*
115 * Used for wake-one threads:
116 */
Changli Gaoa93d2f12010-05-07 14:33:26 +0800117static inline void __add_wait_queue_exclusive(wait_queue_head_t *q,
118 wait_queue_t *wait)
119{
120 wait->flags |= WQ_FLAG_EXCLUSIVE;
121 __add_wait_queue(q, wait);
122}
123
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124static inline void __add_wait_queue_tail(wait_queue_head_t *head,
Changli Gaoa93d2f12010-05-07 14:33:26 +0800125 wait_queue_t *new)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700126{
127 list_add_tail(&new->task_list, &head->task_list);
128}
129
Changli Gaoa93d2f12010-05-07 14:33:26 +0800130static inline void __add_wait_queue_tail_exclusive(wait_queue_head_t *q,
131 wait_queue_t *wait)
132{
133 wait->flags |= WQ_FLAG_EXCLUSIVE;
134 __add_wait_queue_tail(q, wait);
135}
136
Linus Torvalds1da177e2005-04-16 15:20:36 -0700137static inline void __remove_wait_queue(wait_queue_head_t *head,
138 wait_queue_t *old)
139{
140 list_del(&old->task_list);
141}
142
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800143void __wake_up(wait_queue_head_t *q, unsigned int mode, int nr, void *key);
Davide Libenzi4ede8162009-03-31 15:24:20 -0700144void __wake_up_locked_key(wait_queue_head_t *q, unsigned int mode, void *key);
145void __wake_up_sync_key(wait_queue_head_t *q, unsigned int mode, int nr,
146 void *key);
Thomas Gleixner63b20012011-12-01 00:04:00 +0100147void __wake_up_locked(wait_queue_head_t *q, unsigned int mode, int nr);
Davide Libenzi4ede8162009-03-31 15:24:20 -0700148void __wake_up_sync(wait_queue_head_t *q, unsigned int mode, int nr);
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800149void __wake_up_bit(wait_queue_head_t *, void *, int);
150int __wait_on_bit(wait_queue_head_t *, struct wait_bit_queue *, int (*)(void *), unsigned);
151int __wait_on_bit_lock(wait_queue_head_t *, struct wait_bit_queue *, int (*)(void *), unsigned);
152void wake_up_bit(void *, int);
David Howellscb655372013-05-10 19:50:26 +0100153void wake_up_atomic_t(atomic_t *);
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800154int out_of_line_wait_on_bit(void *, int, int (*)(void *), unsigned);
155int out_of_line_wait_on_bit_lock(void *, int, int (*)(void *), unsigned);
David Howellscb655372013-05-10 19:50:26 +0100156int out_of_line_wait_on_atomic_t(atomic_t *, int (*)(atomic_t *), unsigned);
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800157wait_queue_head_t *bit_waitqueue(void *, int);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700158
Matthew Wilcoxe64d66c2007-12-06 17:34:36 -0500159#define wake_up(x) __wake_up(x, TASK_NORMAL, 1, NULL)
160#define wake_up_nr(x, nr) __wake_up(x, TASK_NORMAL, nr, NULL)
161#define wake_up_all(x) __wake_up(x, TASK_NORMAL, 0, NULL)
Thomas Gleixner63b20012011-12-01 00:04:00 +0100162#define wake_up_locked(x) __wake_up_locked((x), TASK_NORMAL, 1)
163#define wake_up_all_locked(x) __wake_up_locked((x), TASK_NORMAL, 0)
Matthew Wilcoxe64d66c2007-12-06 17:34:36 -0500164
Linus Torvalds1da177e2005-04-16 15:20:36 -0700165#define wake_up_interruptible(x) __wake_up(x, TASK_INTERRUPTIBLE, 1, NULL)
166#define wake_up_interruptible_nr(x, nr) __wake_up(x, TASK_INTERRUPTIBLE, nr, NULL)
167#define wake_up_interruptible_all(x) __wake_up(x, TASK_INTERRUPTIBLE, 0, NULL)
Matthew Wilcoxe64d66c2007-12-06 17:34:36 -0500168#define wake_up_interruptible_sync(x) __wake_up_sync((x), TASK_INTERRUPTIBLE, 1)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700169
Peter Zijlstra0ccf8312008-02-04 22:27:20 -0800170/*
Davide Libenzic0da3772009-03-31 15:24:20 -0700171 * Wakeup macros to be used to report events to the targets.
Peter Zijlstra0ccf8312008-02-04 22:27:20 -0800172 */
Davide Libenzic0da3772009-03-31 15:24:20 -0700173#define wake_up_poll(x, m) \
174 __wake_up(x, TASK_NORMAL, 1, (void *) (m))
175#define wake_up_locked_poll(x, m) \
176 __wake_up_locked_key((x), TASK_NORMAL, (void *) (m))
177#define wake_up_interruptible_poll(x, m) \
178 __wake_up(x, TASK_INTERRUPTIBLE, 1, (void *) (m))
179#define wake_up_interruptible_sync_poll(x, m) \
180 __wake_up_sync_key((x), TASK_INTERRUPTIBLE, 1, (void *) (m))
Peter Zijlstra0ccf8312008-02-04 22:27:20 -0800181
Peter Zijlstra2953ef22013-10-02 11:22:19 +0200182#define ___wait_cond_timeout(condition, ret) \
183({ \
184 bool __cond = (condition); \
185 if (__cond && !ret) \
186 ret = 1; \
187 __cond || !ret; \
188})
189
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190#define __wait_event(wq, condition) \
191do { \
192 DEFINE_WAIT(__wait); \
193 \
194 for (;;) { \
195 prepare_to_wait(&wq, &__wait, TASK_UNINTERRUPTIBLE); \
196 if (condition) \
197 break; \
198 schedule(); \
199 } \
200 finish_wait(&wq, &__wait); \
201} while (0)
202
203/**
204 * wait_event - sleep until a condition gets true
205 * @wq: the waitqueue to wait on
206 * @condition: a C expression for the event to wait for
207 *
208 * The process is put to sleep (TASK_UNINTERRUPTIBLE) until the
209 * @condition evaluates to true. The @condition is checked each time
210 * the waitqueue @wq is woken up.
211 *
212 * wake_up() has to be called after changing any variable that could
213 * change the result of the wait condition.
214 */
215#define wait_event(wq, condition) \
216do { \
217 if (condition) \
218 break; \
219 __wait_event(wq, condition); \
220} while (0)
221
222#define __wait_event_timeout(wq, condition, ret) \
223do { \
224 DEFINE_WAIT(__wait); \
225 \
226 for (;;) { \
227 prepare_to_wait(&wq, &__wait, TASK_UNINTERRUPTIBLE); \
Peter Zijlstra2953ef22013-10-02 11:22:19 +0200228 if (___wait_cond_timeout(condition, ret)) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700229 break; \
230 ret = schedule_timeout(ret); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231 } \
232 finish_wait(&wq, &__wait); \
233} while (0)
234
235/**
236 * wait_event_timeout - sleep until a condition gets true or a timeout elapses
237 * @wq: the waitqueue to wait on
238 * @condition: a C expression for the event to wait for
239 * @timeout: timeout, in jiffies
240 *
241 * The process is put to sleep (TASK_UNINTERRUPTIBLE) until the
242 * @condition evaluates to true. The @condition is checked each time
243 * the waitqueue @wq is woken up.
244 *
245 * wake_up() has to be called after changing any variable that could
246 * change the result of the wait condition.
247 *
Imre Deak4c663cf2013-05-24 15:55:09 -0700248 * The function returns 0 if the @timeout elapsed, or the remaining
249 * jiffies (at least 1) if the @condition evaluated to %true before
250 * the @timeout elapsed.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700251 */
252#define wait_event_timeout(wq, condition, timeout) \
253({ \
254 long __ret = timeout; \
255 if (!(condition)) \
256 __wait_event_timeout(wq, condition, __ret); \
257 __ret; \
258})
259
260#define __wait_event_interruptible(wq, condition, ret) \
261do { \
262 DEFINE_WAIT(__wait); \
263 \
264 for (;;) { \
265 prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE); \
266 if (condition) \
267 break; \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200268 if (signal_pending(current)) { \
269 ret = -ERESTARTSYS; \
270 break; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700271 } \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200272 schedule(); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700273 } \
274 finish_wait(&wq, &__wait); \
275} while (0)
276
277/**
278 * wait_event_interruptible - sleep until a condition gets true
279 * @wq: the waitqueue to wait on
280 * @condition: a C expression for the event to wait for
281 *
282 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
283 * @condition evaluates to true or a signal is received.
284 * The @condition is checked each time the waitqueue @wq is woken up.
285 *
286 * wake_up() has to be called after changing any variable that could
287 * change the result of the wait condition.
288 *
289 * The function will return -ERESTARTSYS if it was interrupted by a
290 * signal and 0 if @condition evaluated to true.
291 */
292#define wait_event_interruptible(wq, condition) \
293({ \
294 int __ret = 0; \
295 if (!(condition)) \
296 __wait_event_interruptible(wq, condition, __ret); \
297 __ret; \
298})
299
300#define __wait_event_interruptible_timeout(wq, condition, ret) \
301do { \
302 DEFINE_WAIT(__wait); \
303 \
304 for (;;) { \
305 prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE); \
Peter Zijlstra2953ef22013-10-02 11:22:19 +0200306 if (___wait_cond_timeout(condition, ret)) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700307 break; \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200308 if (signal_pending(current)) { \
309 ret = -ERESTARTSYS; \
310 break; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700311 } \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200312 ret = schedule_timeout(ret); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700313 } \
314 finish_wait(&wq, &__wait); \
315} while (0)
316
317/**
318 * wait_event_interruptible_timeout - sleep until a condition gets true or a timeout elapses
319 * @wq: the waitqueue to wait on
320 * @condition: a C expression for the event to wait for
321 * @timeout: timeout, in jiffies
322 *
323 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
324 * @condition evaluates to true or a signal is received.
325 * The @condition is checked each time the waitqueue @wq is woken up.
326 *
327 * wake_up() has to be called after changing any variable that could
328 * change the result of the wait condition.
329 *
Imre Deak4c663cf2013-05-24 15:55:09 -0700330 * Returns:
331 * 0 if the @timeout elapsed, -%ERESTARTSYS if it was interrupted by
332 * a signal, or the remaining jiffies (at least 1) if the @condition
333 * evaluated to %true before the @timeout elapsed.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700334 */
335#define wait_event_interruptible_timeout(wq, condition, timeout) \
336({ \
337 long __ret = timeout; \
338 if (!(condition)) \
339 __wait_event_interruptible_timeout(wq, condition, __ret); \
340 __ret; \
341})
342
Kent Overstreet774a08b2013-05-07 16:18:43 -0700343#define __wait_event_hrtimeout(wq, condition, timeout, state) \
344({ \
345 int __ret = 0; \
346 DEFINE_WAIT(__wait); \
347 struct hrtimer_sleeper __t; \
348 \
349 hrtimer_init_on_stack(&__t.timer, CLOCK_MONOTONIC, \
350 HRTIMER_MODE_REL); \
351 hrtimer_init_sleeper(&__t, current); \
352 if ((timeout).tv64 != KTIME_MAX) \
353 hrtimer_start_range_ns(&__t.timer, timeout, \
354 current->timer_slack_ns, \
355 HRTIMER_MODE_REL); \
356 \
357 for (;;) { \
358 prepare_to_wait(&wq, &__wait, state); \
359 if (condition) \
360 break; \
361 if (state == TASK_INTERRUPTIBLE && \
362 signal_pending(current)) { \
363 __ret = -ERESTARTSYS; \
364 break; \
365 } \
366 if (!__t.task) { \
367 __ret = -ETIME; \
368 break; \
369 } \
370 schedule(); \
371 } \
372 \
373 hrtimer_cancel(&__t.timer); \
374 destroy_hrtimer_on_stack(&__t.timer); \
375 finish_wait(&wq, &__wait); \
376 __ret; \
377})
378
379/**
380 * wait_event_hrtimeout - sleep until a condition gets true or a timeout elapses
381 * @wq: the waitqueue to wait on
382 * @condition: a C expression for the event to wait for
383 * @timeout: timeout, as a ktime_t
384 *
385 * The process is put to sleep (TASK_UNINTERRUPTIBLE) until the
386 * @condition evaluates to true or a signal is received.
387 * The @condition is checked each time the waitqueue @wq is woken up.
388 *
389 * wake_up() has to be called after changing any variable that could
390 * change the result of the wait condition.
391 *
392 * The function returns 0 if @condition became true, or -ETIME if the timeout
393 * elapsed.
394 */
395#define wait_event_hrtimeout(wq, condition, timeout) \
396({ \
397 int __ret = 0; \
398 if (!(condition)) \
399 __ret = __wait_event_hrtimeout(wq, condition, timeout, \
400 TASK_UNINTERRUPTIBLE); \
401 __ret; \
402})
403
404/**
405 * wait_event_interruptible_hrtimeout - sleep until a condition gets true or a timeout elapses
406 * @wq: the waitqueue to wait on
407 * @condition: a C expression for the event to wait for
408 * @timeout: timeout, as a ktime_t
409 *
410 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
411 * @condition evaluates to true or a signal is received.
412 * The @condition is checked each time the waitqueue @wq is woken up.
413 *
414 * wake_up() has to be called after changing any variable that could
415 * change the result of the wait condition.
416 *
417 * The function returns 0 if @condition became true, -ERESTARTSYS if it was
418 * interrupted by a signal, or -ETIME if the timeout elapsed.
419 */
420#define wait_event_interruptible_hrtimeout(wq, condition, timeout) \
421({ \
422 long __ret = 0; \
423 if (!(condition)) \
424 __ret = __wait_event_hrtimeout(wq, condition, timeout, \
425 TASK_INTERRUPTIBLE); \
426 __ret; \
427})
428
Linus Torvalds1da177e2005-04-16 15:20:36 -0700429#define __wait_event_interruptible_exclusive(wq, condition, ret) \
430do { \
Peter Zijlstrabb632bc2013-10-02 11:22:20 +0200431 __label__ __out; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700432 DEFINE_WAIT(__wait); \
433 \
434 for (;;) { \
435 prepare_to_wait_exclusive(&wq, &__wait, \
436 TASK_INTERRUPTIBLE); \
Peter Zijlstrabb632bc2013-10-02 11:22:20 +0200437 if (condition) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700438 break; \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200439 if (signal_pending(current)) { \
440 ret = -ERESTARTSYS; \
441 abort_exclusive_wait(&wq, &__wait, \
Johannes Weiner777c6c52009-02-04 15:12:14 -0800442 TASK_INTERRUPTIBLE, NULL); \
Peter Zijlstrabb632bc2013-10-02 11:22:20 +0200443 goto __out; \
Peter Zijlstra2f2a2b62013-10-02 11:22:18 +0200444 } \
445 schedule(); \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700446 } \
Peter Zijlstrabb632bc2013-10-02 11:22:20 +0200447 finish_wait(&wq, &__wait); \
448__out: ; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700449} while (0)
450
451#define wait_event_interruptible_exclusive(wq, condition) \
452({ \
453 int __ret = 0; \
454 if (!(condition)) \
455 __wait_event_interruptible_exclusive(wq, condition, __ret);\
456 __ret; \
457})
458
Michal Nazarewicz22c43c82010-05-05 12:53:11 +0200459
460#define __wait_event_interruptible_locked(wq, condition, exclusive, irq) \
461({ \
462 int __ret = 0; \
463 DEFINE_WAIT(__wait); \
464 if (exclusive) \
465 __wait.flags |= WQ_FLAG_EXCLUSIVE; \
466 do { \
467 if (likely(list_empty(&__wait.task_list))) \
468 __add_wait_queue_tail(&(wq), &__wait); \
469 set_current_state(TASK_INTERRUPTIBLE); \
470 if (signal_pending(current)) { \
471 __ret = -ERESTARTSYS; \
472 break; \
473 } \
474 if (irq) \
475 spin_unlock_irq(&(wq).lock); \
476 else \
477 spin_unlock(&(wq).lock); \
478 schedule(); \
479 if (irq) \
480 spin_lock_irq(&(wq).lock); \
481 else \
482 spin_lock(&(wq).lock); \
483 } while (!(condition)); \
484 __remove_wait_queue(&(wq), &__wait); \
485 __set_current_state(TASK_RUNNING); \
486 __ret; \
487})
488
489
490/**
491 * wait_event_interruptible_locked - sleep until a condition gets true
492 * @wq: the waitqueue to wait on
493 * @condition: a C expression for the event to wait for
494 *
495 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
496 * @condition evaluates to true or a signal is received.
497 * The @condition is checked each time the waitqueue @wq is woken up.
498 *
499 * It must be called with wq.lock being held. This spinlock is
500 * unlocked while sleeping but @condition testing is done while lock
501 * is held and when this macro exits the lock is held.
502 *
503 * The lock is locked/unlocked using spin_lock()/spin_unlock()
504 * functions which must match the way they are locked/unlocked outside
505 * of this macro.
506 *
507 * wake_up_locked() has to be called after changing any variable that could
508 * change the result of the wait condition.
509 *
510 * The function will return -ERESTARTSYS if it was interrupted by a
511 * signal and 0 if @condition evaluated to true.
512 */
513#define wait_event_interruptible_locked(wq, condition) \
514 ((condition) \
515 ? 0 : __wait_event_interruptible_locked(wq, condition, 0, 0))
516
517/**
518 * wait_event_interruptible_locked_irq - sleep until a condition gets true
519 * @wq: the waitqueue to wait on
520 * @condition: a C expression for the event to wait for
521 *
522 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
523 * @condition evaluates to true or a signal is received.
524 * The @condition is checked each time the waitqueue @wq is woken up.
525 *
526 * It must be called with wq.lock being held. This spinlock is
527 * unlocked while sleeping but @condition testing is done while lock
528 * is held and when this macro exits the lock is held.
529 *
530 * The lock is locked/unlocked using spin_lock_irq()/spin_unlock_irq()
531 * functions which must match the way they are locked/unlocked outside
532 * of this macro.
533 *
534 * wake_up_locked() has to be called after changing any variable that could
535 * change the result of the wait condition.
536 *
537 * The function will return -ERESTARTSYS if it was interrupted by a
538 * signal and 0 if @condition evaluated to true.
539 */
540#define wait_event_interruptible_locked_irq(wq, condition) \
541 ((condition) \
542 ? 0 : __wait_event_interruptible_locked(wq, condition, 0, 1))
543
544/**
545 * wait_event_interruptible_exclusive_locked - sleep exclusively until a condition gets true
546 * @wq: the waitqueue to wait on
547 * @condition: a C expression for the event to wait for
548 *
549 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
550 * @condition evaluates to true or a signal is received.
551 * The @condition is checked each time the waitqueue @wq is woken up.
552 *
553 * It must be called with wq.lock being held. This spinlock is
554 * unlocked while sleeping but @condition testing is done while lock
555 * is held and when this macro exits the lock is held.
556 *
557 * The lock is locked/unlocked using spin_lock()/spin_unlock()
558 * functions which must match the way they are locked/unlocked outside
559 * of this macro.
560 *
561 * The process is put on the wait queue with an WQ_FLAG_EXCLUSIVE flag
562 * set thus when other process waits process on the list if this
563 * process is awaken further processes are not considered.
564 *
565 * wake_up_locked() has to be called after changing any variable that could
566 * change the result of the wait condition.
567 *
568 * The function will return -ERESTARTSYS if it was interrupted by a
569 * signal and 0 if @condition evaluated to true.
570 */
571#define wait_event_interruptible_exclusive_locked(wq, condition) \
572 ((condition) \
573 ? 0 : __wait_event_interruptible_locked(wq, condition, 1, 0))
574
575/**
576 * wait_event_interruptible_exclusive_locked_irq - sleep until a condition gets true
577 * @wq: the waitqueue to wait on
578 * @condition: a C expression for the event to wait for
579 *
580 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
581 * @condition evaluates to true or a signal is received.
582 * The @condition is checked each time the waitqueue @wq is woken up.
583 *
584 * It must be called with wq.lock being held. This spinlock is
585 * unlocked while sleeping but @condition testing is done while lock
586 * is held and when this macro exits the lock is held.
587 *
588 * The lock is locked/unlocked using spin_lock_irq()/spin_unlock_irq()
589 * functions which must match the way they are locked/unlocked outside
590 * of this macro.
591 *
592 * The process is put on the wait queue with an WQ_FLAG_EXCLUSIVE flag
593 * set thus when other process waits process on the list if this
594 * process is awaken further processes are not considered.
595 *
596 * wake_up_locked() has to be called after changing any variable that could
597 * change the result of the wait condition.
598 *
599 * The function will return -ERESTARTSYS if it was interrupted by a
600 * signal and 0 if @condition evaluated to true.
601 */
602#define wait_event_interruptible_exclusive_locked_irq(wq, condition) \
603 ((condition) \
604 ? 0 : __wait_event_interruptible_locked(wq, condition, 1, 1))
605
606
607
Matthew Wilcox1411d5a2007-12-06 12:00:00 -0500608#define __wait_event_killable(wq, condition, ret) \
609do { \
610 DEFINE_WAIT(__wait); \
611 \
612 for (;;) { \
613 prepare_to_wait(&wq, &__wait, TASK_KILLABLE); \
614 if (condition) \
615 break; \
616 if (!fatal_signal_pending(current)) { \
617 schedule(); \
618 continue; \
619 } \
620 ret = -ERESTARTSYS; \
621 break; \
622 } \
623 finish_wait(&wq, &__wait); \
624} while (0)
625
626/**
627 * wait_event_killable - sleep until a condition gets true
628 * @wq: the waitqueue to wait on
629 * @condition: a C expression for the event to wait for
630 *
631 * The process is put to sleep (TASK_KILLABLE) until the
632 * @condition evaluates to true or a signal is received.
633 * The @condition is checked each time the waitqueue @wq is woken up.
634 *
635 * wake_up() has to be called after changing any variable that could
636 * change the result of the wait condition.
637 *
638 * The function will return -ERESTARTSYS if it was interrupted by a
639 * signal and 0 if @condition evaluated to true.
640 */
641#define wait_event_killable(wq, condition) \
642({ \
643 int __ret = 0; \
644 if (!(condition)) \
645 __wait_event_killable(wq, condition, __ret); \
646 __ret; \
647})
648
Lukas Czernereed8c022012-11-30 11:42:40 +0100649
650#define __wait_event_lock_irq(wq, condition, lock, cmd) \
651do { \
652 DEFINE_WAIT(__wait); \
653 \
654 for (;;) { \
655 prepare_to_wait(&wq, &__wait, TASK_UNINTERRUPTIBLE); \
656 if (condition) \
657 break; \
658 spin_unlock_irq(&lock); \
659 cmd; \
660 schedule(); \
661 spin_lock_irq(&lock); \
662 } \
663 finish_wait(&wq, &__wait); \
664} while (0)
665
666/**
667 * wait_event_lock_irq_cmd - sleep until a condition gets true. The
668 * condition is checked under the lock. This
669 * is expected to be called with the lock
670 * taken.
671 * @wq: the waitqueue to wait on
672 * @condition: a C expression for the event to wait for
673 * @lock: a locked spinlock_t, which will be released before cmd
674 * and schedule() and reacquired afterwards.
675 * @cmd: a command which is invoked outside the critical section before
676 * sleep
677 *
678 * The process is put to sleep (TASK_UNINTERRUPTIBLE) until the
679 * @condition evaluates to true. The @condition is checked each time
680 * the waitqueue @wq is woken up.
681 *
682 * wake_up() has to be called after changing any variable that could
683 * change the result of the wait condition.
684 *
685 * This is supposed to be called while holding the lock. The lock is
686 * dropped before invoking the cmd and going to sleep and is reacquired
687 * afterwards.
688 */
689#define wait_event_lock_irq_cmd(wq, condition, lock, cmd) \
690do { \
691 if (condition) \
692 break; \
693 __wait_event_lock_irq(wq, condition, lock, cmd); \
694} while (0)
695
696/**
697 * wait_event_lock_irq - sleep until a condition gets true. The
698 * condition is checked under the lock. This
699 * is expected to be called with the lock
700 * taken.
701 * @wq: the waitqueue to wait on
702 * @condition: a C expression for the event to wait for
703 * @lock: a locked spinlock_t, which will be released before schedule()
704 * and reacquired afterwards.
705 *
706 * The process is put to sleep (TASK_UNINTERRUPTIBLE) until the
707 * @condition evaluates to true. The @condition is checked each time
708 * the waitqueue @wq is woken up.
709 *
710 * wake_up() has to be called after changing any variable that could
711 * change the result of the wait condition.
712 *
713 * This is supposed to be called while holding the lock. The lock is
714 * dropped before going to sleep and is reacquired afterwards.
715 */
716#define wait_event_lock_irq(wq, condition, lock) \
717do { \
718 if (condition) \
719 break; \
720 __wait_event_lock_irq(wq, condition, lock, ); \
721} while (0)
722
723
724#define __wait_event_interruptible_lock_irq(wq, condition, \
725 lock, ret, cmd) \
726do { \
727 DEFINE_WAIT(__wait); \
728 \
729 for (;;) { \
730 prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE); \
731 if (condition) \
732 break; \
733 if (signal_pending(current)) { \
734 ret = -ERESTARTSYS; \
735 break; \
736 } \
737 spin_unlock_irq(&lock); \
738 cmd; \
739 schedule(); \
740 spin_lock_irq(&lock); \
741 } \
742 finish_wait(&wq, &__wait); \
743} while (0)
744
745/**
746 * wait_event_interruptible_lock_irq_cmd - sleep until a condition gets true.
747 * The condition is checked under the lock. This is expected to
748 * be called with the lock taken.
749 * @wq: the waitqueue to wait on
750 * @condition: a C expression for the event to wait for
751 * @lock: a locked spinlock_t, which will be released before cmd and
752 * schedule() and reacquired afterwards.
753 * @cmd: a command which is invoked outside the critical section before
754 * sleep
755 *
756 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
757 * @condition evaluates to true or a signal is received. The @condition is
758 * checked each time the waitqueue @wq is woken up.
759 *
760 * wake_up() has to be called after changing any variable that could
761 * change the result of the wait condition.
762 *
763 * This is supposed to be called while holding the lock. The lock is
764 * dropped before invoking the cmd and going to sleep and is reacquired
765 * afterwards.
766 *
767 * The macro will return -ERESTARTSYS if it was interrupted by a signal
768 * and 0 if @condition evaluated to true.
769 */
770#define wait_event_interruptible_lock_irq_cmd(wq, condition, lock, cmd) \
771({ \
772 int __ret = 0; \
773 \
774 if (!(condition)) \
775 __wait_event_interruptible_lock_irq(wq, condition, \
776 lock, __ret, cmd); \
777 __ret; \
778})
779
780/**
781 * wait_event_interruptible_lock_irq - sleep until a condition gets true.
782 * The condition is checked under the lock. This is expected
783 * to be called with the lock taken.
784 * @wq: the waitqueue to wait on
785 * @condition: a C expression for the event to wait for
786 * @lock: a locked spinlock_t, which will be released before schedule()
787 * and reacquired afterwards.
788 *
789 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
790 * @condition evaluates to true or signal is received. The @condition is
791 * checked each time the waitqueue @wq is woken up.
792 *
793 * wake_up() has to be called after changing any variable that could
794 * change the result of the wait condition.
795 *
796 * This is supposed to be called while holding the lock. The lock is
797 * dropped before going to sleep and is reacquired afterwards.
798 *
799 * The macro will return -ERESTARTSYS if it was interrupted by a signal
800 * and 0 if @condition evaluated to true.
801 */
802#define wait_event_interruptible_lock_irq(wq, condition, lock) \
803({ \
804 int __ret = 0; \
805 \
806 if (!(condition)) \
807 __wait_event_interruptible_lock_irq(wq, condition, \
808 lock, __ret, ); \
809 __ret; \
810})
811
Martin Peschked79ff142013-08-22 17:45:36 +0200812#define __wait_event_interruptible_lock_irq_timeout(wq, condition, \
813 lock, ret) \
814do { \
815 DEFINE_WAIT(__wait); \
816 \
817 for (;;) { \
818 prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE); \
Peter Zijlstra2953ef22013-10-02 11:22:19 +0200819 if (___wait_cond_timeout(condition, ret)) \
Martin Peschked79ff142013-08-22 17:45:36 +0200820 break; \
821 if (signal_pending(current)) { \
822 ret = -ERESTARTSYS; \
823 break; \
824 } \
825 spin_unlock_irq(&lock); \
826 ret = schedule_timeout(ret); \
827 spin_lock_irq(&lock); \
Martin Peschked79ff142013-08-22 17:45:36 +0200828 } \
829 finish_wait(&wq, &__wait); \
830} while (0)
831
832/**
833 * wait_event_interruptible_lock_irq_timeout - sleep until a condition gets true or a timeout elapses.
834 * The condition is checked under the lock. This is expected
835 * to be called with the lock taken.
836 * @wq: the waitqueue to wait on
837 * @condition: a C expression for the event to wait for
838 * @lock: a locked spinlock_t, which will be released before schedule()
839 * and reacquired afterwards.
840 * @timeout: timeout, in jiffies
841 *
842 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
843 * @condition evaluates to true or signal is received. The @condition is
844 * checked each time the waitqueue @wq is woken up.
845 *
846 * wake_up() has to be called after changing any variable that could
847 * change the result of the wait condition.
848 *
849 * This is supposed to be called while holding the lock. The lock is
850 * dropped before going to sleep and is reacquired afterwards.
851 *
852 * The function returns 0 if the @timeout elapsed, -ERESTARTSYS if it
853 * was interrupted by a signal, and the remaining jiffies otherwise
854 * if the condition evaluated to true before the timeout elapsed.
855 */
856#define wait_event_interruptible_lock_irq_timeout(wq, condition, lock, \
857 timeout) \
858({ \
859 int __ret = timeout; \
860 \
861 if (!(condition)) \
862 __wait_event_interruptible_lock_irq_timeout( \
863 wq, condition, lock, __ret); \
864 __ret; \
865})
866
Lukas Czernereed8c022012-11-30 11:42:40 +0100867
Linus Torvalds1da177e2005-04-16 15:20:36 -0700868/*
Linus Torvalds1da177e2005-04-16 15:20:36 -0700869 * These are the old interfaces to sleep waiting for an event.
Ingo Molnar0fec1712007-07-09 18:52:01 +0200870 * They are racy. DO NOT use them, use the wait_event* interfaces above.
871 * We plan to remove these interfaces.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700872 */
Ingo Molnar0fec1712007-07-09 18:52:01 +0200873extern void sleep_on(wait_queue_head_t *q);
874extern long sleep_on_timeout(wait_queue_head_t *q,
875 signed long timeout);
876extern void interruptible_sleep_on(wait_queue_head_t *q);
877extern long interruptible_sleep_on_timeout(wait_queue_head_t *q,
878 signed long timeout);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700879
880/*
881 * Waitqueues which are removed from the waitqueue_head at wakeup time
882 */
Harvey Harrisonb3c97522008-02-13 15:03:15 -0800883void prepare_to_wait(wait_queue_head_t *q, wait_queue_t *wait, int state);
884void prepare_to_wait_exclusive(wait_queue_head_t *q, wait_queue_t *wait, int state);
885void finish_wait(wait_queue_head_t *q, wait_queue_t *wait);
Johannes Weiner777c6c52009-02-04 15:12:14 -0800886void abort_exclusive_wait(wait_queue_head_t *q, wait_queue_t *wait,
887 unsigned int mode, void *key);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700888int autoremove_wake_function(wait_queue_t *wait, unsigned mode, int sync, void *key);
889int wake_bit_function(wait_queue_t *wait, unsigned mode, int sync, void *key);
890
Eric Dumazetbf368e42009-04-28 02:24:21 -0700891#define DEFINE_WAIT_FUNC(name, function) \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700892 wait_queue_t name = { \
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -0700893 .private = current, \
Eric Dumazetbf368e42009-04-28 02:24:21 -0700894 .func = function, \
blaisorblade@yahoo.it7e43c842005-05-25 01:31:42 +0200895 .task_list = LIST_HEAD_INIT((name).task_list), \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700896 }
897
Eric Dumazetbf368e42009-04-28 02:24:21 -0700898#define DEFINE_WAIT(name) DEFINE_WAIT_FUNC(name, autoremove_wake_function)
899
Linus Torvalds1da177e2005-04-16 15:20:36 -0700900#define DEFINE_WAIT_BIT(name, word, bit) \
901 struct wait_bit_queue name = { \
902 .key = __WAIT_BIT_KEY_INITIALIZER(word, bit), \
903 .wait = { \
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -0700904 .private = current, \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700905 .func = wake_bit_function, \
906 .task_list = \
907 LIST_HEAD_INIT((name).wait.task_list), \
908 }, \
909 }
910
911#define init_wait(wait) \
912 do { \
Benjamin LaHaisec43dc2f2005-06-23 00:10:27 -0700913 (wait)->private = current; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700914 (wait)->func = autoremove_wake_function; \
915 INIT_LIST_HEAD(&(wait)->task_list); \
Evgeny Kuznetsov231d0ae2010-10-05 12:47:57 +0400916 (wait)->flags = 0; \
Linus Torvalds1da177e2005-04-16 15:20:36 -0700917 } while (0)
918
919/**
920 * wait_on_bit - wait for a bit to be cleared
921 * @word: the word being waited on, a kernel virtual address
922 * @bit: the bit of the word being waited on
923 * @action: the function used to sleep, which may take special actions
924 * @mode: the task state to sleep in
925 *
926 * There is a standard hashed waitqueue table for generic use. This
927 * is the part of the hashtable's accessor API that waits on a bit.
928 * For instance, if one were to have waiters on a bitflag, one would
929 * call wait_on_bit() in threads waiting for the bit to clear.
930 * One uses wait_on_bit() where one is waiting for the bit to clear,
931 * but has no intention of setting it.
932 */
933static inline int wait_on_bit(void *word, int bit,
934 int (*action)(void *), unsigned mode)
935{
936 if (!test_bit(bit, word))
937 return 0;
938 return out_of_line_wait_on_bit(word, bit, action, mode);
939}
940
941/**
942 * wait_on_bit_lock - wait for a bit to be cleared, when wanting to set it
943 * @word: the word being waited on, a kernel virtual address
944 * @bit: the bit of the word being waited on
945 * @action: the function used to sleep, which may take special actions
946 * @mode: the task state to sleep in
947 *
948 * There is a standard hashed waitqueue table for generic use. This
949 * is the part of the hashtable's accessor API that waits on a bit
950 * when one intends to set it, for instance, trying to lock bitflags.
951 * For instance, if one were to have waiters trying to set bitflag
952 * and waiting for it to clear before setting it, one would call
953 * wait_on_bit() in threads waiting to be able to set the bit.
954 * One uses wait_on_bit_lock() where one is waiting for the bit to
955 * clear with the intention of setting it, and when done, clearing it.
956 */
957static inline int wait_on_bit_lock(void *word, int bit,
958 int (*action)(void *), unsigned mode)
959{
960 if (!test_and_set_bit(bit, word))
961 return 0;
962 return out_of_line_wait_on_bit_lock(word, bit, action, mode);
963}
David Howellscb655372013-05-10 19:50:26 +0100964
965/**
966 * wait_on_atomic_t - Wait for an atomic_t to become 0
967 * @val: The atomic value being waited on, a kernel virtual address
968 * @action: the function used to sleep, which may take special actions
969 * @mode: the task state to sleep in
970 *
971 * Wait for an atomic_t to become 0. We abuse the bit-wait waitqueue table for
972 * the purpose of getting a waitqueue, but we set the key to a bit number
973 * outside of the target 'word'.
974 */
975static inline
976int wait_on_atomic_t(atomic_t *val, int (*action)(atomic_t *), unsigned mode)
977{
978 if (atomic_read(val) == 0)
979 return 0;
980 return out_of_line_wait_on_atomic_t(val, action, mode);
981}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700982
Linus Torvalds1da177e2005-04-16 15:20:36 -0700983#endif