Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * workqueue.h --- work queue handling for Linux. |
| 3 | */ |
| 4 | |
| 5 | #ifndef _LINUX_WORKQUEUE_H |
| 6 | #define _LINUX_WORKQUEUE_H |
| 7 | |
| 8 | #include <linux/timer.h> |
| 9 | #include <linux/linkage.h> |
| 10 | #include <linux/bitops.h> |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 11 | #include <linux/lockdep.h> |
Tejun Heo | 7a22ad7 | 2010-06-29 10:07:13 +0200 | [diff] [blame] | 12 | #include <linux/threads.h> |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 13 | #include <asm/atomic.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 14 | |
| 15 | struct workqueue_struct; |
| 16 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 17 | struct work_struct; |
| 18 | typedef void (*work_func_t)(struct work_struct *work); |
David Howells | 6bb49e5 | 2006-11-22 14:54:45 +0000 | [diff] [blame] | 19 | |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 20 | /* |
| 21 | * The first word is the work queue pointer and the flags rolled into |
| 22 | * one |
| 23 | */ |
| 24 | #define work_data_bits(work) ((unsigned long *)(&(work)->data)) |
| 25 | |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 26 | enum { |
| 27 | WORK_STRUCT_PENDING_BIT = 0, /* work item is pending execution */ |
Tejun Heo | affee4b | 2010-06-29 10:07:12 +0200 | [diff] [blame] | 28 | WORK_STRUCT_LINKED_BIT = 1, /* next work is linked to this one */ |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 29 | #ifdef CONFIG_DEBUG_OBJECTS_WORK |
Tejun Heo | affee4b | 2010-06-29 10:07:12 +0200 | [diff] [blame] | 30 | WORK_STRUCT_STATIC_BIT = 2, /* static initializer (debugobjects) */ |
Tejun Heo | 73f53c4 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 31 | WORK_STRUCT_COLOR_SHIFT = 3, /* color for workqueue flushing */ |
Tejun Heo | 0f90004 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 32 | #else |
Tejun Heo | 73f53c4 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 33 | WORK_STRUCT_COLOR_SHIFT = 2, /* color for workqueue flushing */ |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 34 | #endif |
| 35 | |
Tejun Heo | 73f53c4 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 36 | WORK_STRUCT_COLOR_BITS = 4, |
| 37 | |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 38 | WORK_STRUCT_PENDING = 1 << WORK_STRUCT_PENDING_BIT, |
Tejun Heo | affee4b | 2010-06-29 10:07:12 +0200 | [diff] [blame] | 39 | WORK_STRUCT_LINKED = 1 << WORK_STRUCT_LINKED_BIT, |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 40 | #ifdef CONFIG_DEBUG_OBJECTS_WORK |
| 41 | WORK_STRUCT_STATIC = 1 << WORK_STRUCT_STATIC_BIT, |
| 42 | #else |
| 43 | WORK_STRUCT_STATIC = 0, |
| 44 | #endif |
| 45 | |
Tejun Heo | 73f53c4 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 46 | /* |
| 47 | * The last color is no color used for works which don't |
| 48 | * participate in workqueue flushing. |
| 49 | */ |
| 50 | WORK_NR_COLORS = (1 << WORK_STRUCT_COLOR_BITS) - 1, |
| 51 | WORK_NO_COLOR = WORK_NR_COLORS, |
| 52 | |
| 53 | /* |
| 54 | * Reserve 6 bits off of cwq pointer w/ debugobjects turned |
| 55 | * off. This makes cwqs aligned to 64 bytes which isn't too |
| 56 | * excessive while allowing 15 workqueue flush colors. |
| 57 | */ |
| 58 | WORK_STRUCT_FLAG_BITS = WORK_STRUCT_COLOR_SHIFT + |
| 59 | WORK_STRUCT_COLOR_BITS, |
| 60 | |
Tejun Heo | 0f90004 | 2010-06-29 10:07:11 +0200 | [diff] [blame] | 61 | WORK_STRUCT_FLAG_MASK = (1UL << WORK_STRUCT_FLAG_BITS) - 1, |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 62 | WORK_STRUCT_WQ_DATA_MASK = ~WORK_STRUCT_FLAG_MASK, |
Tejun Heo | 7a22ad7 | 2010-06-29 10:07:13 +0200 | [diff] [blame] | 63 | WORK_STRUCT_NO_CPU = NR_CPUS << WORK_STRUCT_FLAG_BITS, |
Tejun Heo | dcd989c | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 64 | |
| 65 | /* bit mask for work_busy() return values */ |
| 66 | WORK_BUSY_PENDING = 1 << 0, |
| 67 | WORK_BUSY_RUNNING = 1 << 1, |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 68 | }; |
| 69 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 70 | struct work_struct { |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 71 | atomic_long_t data; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | struct list_head entry; |
David Howells | 6bb49e5 | 2006-11-22 14:54:45 +0000 | [diff] [blame] | 73 | work_func_t func; |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 74 | #ifdef CONFIG_LOCKDEP |
| 75 | struct lockdep_map lockdep_map; |
| 76 | #endif |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 77 | }; |
| 78 | |
Tejun Heo | 7a22ad7 | 2010-06-29 10:07:13 +0200 | [diff] [blame] | 79 | #define WORK_DATA_INIT() ATOMIC_LONG_INIT(WORK_STRUCT_NO_CPU) |
| 80 | #define WORK_DATA_STATIC_INIT() \ |
| 81 | ATOMIC_LONG_INIT(WORK_STRUCT_NO_CPU | WORK_STRUCT_STATIC) |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 82 | |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 83 | struct delayed_work { |
| 84 | struct work_struct work; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 85 | struct timer_list timer; |
| 86 | }; |
| 87 | |
Jean Delvare | bf6aede | 2009-04-02 16:56:54 -0700 | [diff] [blame] | 88 | static inline struct delayed_work *to_delayed_work(struct work_struct *work) |
| 89 | { |
| 90 | return container_of(work, struct delayed_work, work); |
| 91 | } |
| 92 | |
James Bottomley | 1fa44ec | 2006-02-23 12:43:43 -0600 | [diff] [blame] | 93 | struct execute_work { |
| 94 | struct work_struct work; |
| 95 | }; |
| 96 | |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 97 | #ifdef CONFIG_LOCKDEP |
| 98 | /* |
| 99 | * NB: because we have to copy the lockdep_map, setting _key |
| 100 | * here is required, otherwise it could get initialised to the |
| 101 | * copy of the lockdep_map! |
| 102 | */ |
| 103 | #define __WORK_INIT_LOCKDEP_MAP(n, k) \ |
| 104 | .lockdep_map = STATIC_LOCKDEP_MAP_INIT(n, k), |
| 105 | #else |
| 106 | #define __WORK_INIT_LOCKDEP_MAP(n, k) |
| 107 | #endif |
| 108 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 109 | #define __WORK_INITIALIZER(n, f) { \ |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 110 | .data = WORK_DATA_STATIC_INIT(), \ |
Oleg Nesterov | 23b2e59 | 2007-05-09 02:34:19 -0700 | [diff] [blame] | 111 | .entry = { &(n).entry, &(n).entry }, \ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 112 | .func = (f), \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 113 | __WORK_INIT_LOCKDEP_MAP(#n, &(n)) \ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 114 | } |
| 115 | |
| 116 | #define __DELAYED_WORK_INITIALIZER(n, f) { \ |
| 117 | .work = __WORK_INITIALIZER((n).work, (f)), \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 118 | .timer = TIMER_INITIALIZER(NULL, 0, 0), \ |
| 119 | } |
| 120 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 121 | #define DECLARE_WORK(n, f) \ |
| 122 | struct work_struct n = __WORK_INITIALIZER(n, f) |
| 123 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 124 | #define DECLARE_DELAYED_WORK(n, f) \ |
| 125 | struct delayed_work n = __DELAYED_WORK_INITIALIZER(n, f) |
| 126 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 127 | /* |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 128 | * initialize a work item's function pointer |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 129 | */ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 130 | #define PREPARE_WORK(_work, _func) \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 131 | do { \ |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 132 | (_work)->func = (_func); \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 133 | } while (0) |
| 134 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 135 | #define PREPARE_DELAYED_WORK(_work, _func) \ |
| 136 | PREPARE_WORK(&(_work)->work, (_func)) |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 137 | |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 138 | #ifdef CONFIG_DEBUG_OBJECTS_WORK |
| 139 | extern void __init_work(struct work_struct *work, int onstack); |
| 140 | extern void destroy_work_on_stack(struct work_struct *work); |
Tejun Heo | 4690c4a | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 141 | static inline unsigned int work_static(struct work_struct *work) |
| 142 | { |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 143 | return *work_data_bits(work) & WORK_STRUCT_STATIC; |
Tejun Heo | 4690c4a | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 144 | } |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 145 | #else |
| 146 | static inline void __init_work(struct work_struct *work, int onstack) { } |
| 147 | static inline void destroy_work_on_stack(struct work_struct *work) { } |
Tejun Heo | 4690c4a | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 148 | static inline unsigned int work_static(struct work_struct *work) { return 0; } |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 149 | #endif |
| 150 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 151 | /* |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 152 | * initialize all of a work item in one go |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 153 | * |
Dmitri Vorobiev | b9049df | 2009-06-23 12:09:29 +0200 | [diff] [blame] | 154 | * NOTE! No point in using "atomic_long_set()": using a direct |
Linus Torvalds | a08727b | 2006-12-16 09:53:50 -0800 | [diff] [blame] | 155 | * assignment of the work data initializer allows the compiler |
| 156 | * to generate better code. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 157 | */ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 158 | #ifdef CONFIG_LOCKDEP |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 159 | #define __INIT_WORK(_work, _func, _onstack) \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 160 | do { \ |
| 161 | static struct lock_class_key __key; \ |
| 162 | \ |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 163 | __init_work((_work), _onstack); \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 164 | (_work)->data = (atomic_long_t) WORK_DATA_INIT(); \ |
| 165 | lockdep_init_map(&(_work)->lockdep_map, #_work, &__key, 0);\ |
| 166 | INIT_LIST_HEAD(&(_work)->entry); \ |
| 167 | PREPARE_WORK((_work), (_func)); \ |
| 168 | } while (0) |
| 169 | #else |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 170 | #define __INIT_WORK(_work, _func, _onstack) \ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 171 | do { \ |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 172 | __init_work((_work), _onstack); \ |
Oleg Nesterov | 23b2e59 | 2007-05-09 02:34:19 -0700 | [diff] [blame] | 173 | (_work)->data = (atomic_long_t) WORK_DATA_INIT(); \ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 174 | INIT_LIST_HEAD(&(_work)->entry); \ |
| 175 | PREPARE_WORK((_work), (_func)); \ |
| 176 | } while (0) |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 177 | #endif |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 178 | |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 179 | #define INIT_WORK(_work, _func) \ |
| 180 | do { \ |
| 181 | __INIT_WORK((_work), (_func), 0); \ |
| 182 | } while (0) |
| 183 | |
| 184 | #define INIT_WORK_ON_STACK(_work, _func) \ |
| 185 | do { \ |
| 186 | __INIT_WORK((_work), (_func), 1); \ |
| 187 | } while (0) |
| 188 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 189 | #define INIT_DELAYED_WORK(_work, _func) \ |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 190 | do { \ |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 191 | INIT_WORK(&(_work)->work, (_func)); \ |
| 192 | init_timer(&(_work)->timer); \ |
| 193 | } while (0) |
| 194 | |
Peter Zijlstra | 6d612b0 | 2009-01-12 12:52:23 +0100 | [diff] [blame] | 195 | #define INIT_DELAYED_WORK_ON_STACK(_work, _func) \ |
| 196 | do { \ |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 197 | INIT_WORK_ON_STACK(&(_work)->work, (_func)); \ |
Peter Zijlstra | 6d612b0 | 2009-01-12 12:52:23 +0100 | [diff] [blame] | 198 | init_timer_on_stack(&(_work)->timer); \ |
| 199 | } while (0) |
| 200 | |
Thomas Gleixner | dc186ad | 2009-11-16 01:09:48 +0900 | [diff] [blame] | 201 | #define INIT_DELAYED_WORK_DEFERRABLE(_work, _func) \ |
Venki Pallipadi | 2828703 | 2007-05-08 00:27:47 -0700 | [diff] [blame] | 202 | do { \ |
| 203 | INIT_WORK(&(_work)->work, (_func)); \ |
| 204 | init_timer_deferrable(&(_work)->timer); \ |
| 205 | } while (0) |
| 206 | |
David Howells | 365970a | 2006-11-22 14:54:49 +0000 | [diff] [blame] | 207 | /** |
| 208 | * work_pending - Find out whether a work item is currently pending |
| 209 | * @work: The work item in question |
| 210 | */ |
| 211 | #define work_pending(work) \ |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 212 | test_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work)) |
David Howells | 365970a | 2006-11-22 14:54:49 +0000 | [diff] [blame] | 213 | |
| 214 | /** |
| 215 | * delayed_work_pending - Find out whether a delayable work item is currently |
| 216 | * pending |
| 217 | * @work: The work item in question |
| 218 | */ |
Linus Torvalds | 0221872 | 2006-12-15 14:13:51 -0800 | [diff] [blame] | 219 | #define delayed_work_pending(w) \ |
| 220 | work_pending(&(w)->work) |
David Howells | 365970a | 2006-11-22 14:54:49 +0000 | [diff] [blame] | 221 | |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 222 | /** |
Oleg Nesterov | 23b2e59 | 2007-05-09 02:34:19 -0700 | [diff] [blame] | 223 | * work_clear_pending - for internal use only, mark a work item as not pending |
| 224 | * @work: The work item in question |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 225 | */ |
Oleg Nesterov | 23b2e59 | 2007-05-09 02:34:19 -0700 | [diff] [blame] | 226 | #define work_clear_pending(work) \ |
Tejun Heo | 22df02b | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 227 | clear_bit(WORK_STRUCT_PENDING_BIT, work_data_bits(work)) |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 228 | |
Tejun Heo | 97e37d7 | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 229 | enum { |
| 230 | WQ_FREEZEABLE = 1 << 0, /* freeze during suspend */ |
Tejun Heo | 502ca9d | 2010-06-29 10:07:13 +0200 | [diff] [blame] | 231 | WQ_SINGLE_CPU = 1 << 1, /* only single cpu at a time */ |
Tejun Heo | 18aa9ef | 2010-06-29 10:07:13 +0200 | [diff] [blame] | 232 | WQ_NON_REENTRANT = 1 << 2, /* guarantee non-reentrance */ |
Tejun Heo | e22bee7 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 233 | WQ_RESCUER = 1 << 3, /* has an rescue worker */ |
Tejun Heo | 649027d | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 234 | WQ_HIGHPRI = 1 << 4, /* high priority */ |
Tejun Heo | fb0e7be | 2010-06-29 10:07:15 +0200 | [diff] [blame^] | 235 | WQ_CPU_INTENSIVE = 1 << 5, /* cpu instensive workqueue */ |
Tejun Heo | b71ab8c | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 236 | |
| 237 | WQ_MAX_ACTIVE = 512, /* I like 512, better ideas? */ |
| 238 | WQ_DFL_ACTIVE = WQ_MAX_ACTIVE / 2, |
Tejun Heo | 97e37d7 | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 239 | }; |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 240 | |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 241 | /* |
| 242 | * System-wide workqueues which are always present. |
| 243 | * |
| 244 | * system_wq is the one used by schedule[_delayed]_work[_on](). |
| 245 | * Multi-CPU multi-threaded. There are users which expect relatively |
| 246 | * short queue flush time. Don't queue works which can run for too |
| 247 | * long. |
| 248 | * |
| 249 | * system_long_wq is similar to system_wq but may host long running |
| 250 | * works. Queue flushing might take relatively long. |
| 251 | * |
| 252 | * system_nrt_wq is non-reentrant and guarantees that any given work |
| 253 | * item is never executed in parallel by multiple CPUs. Queue |
| 254 | * flushing might take relatively long. |
| 255 | */ |
| 256 | extern struct workqueue_struct *system_wq; |
| 257 | extern struct workqueue_struct *system_long_wq; |
| 258 | extern struct workqueue_struct *system_nrt_wq; |
| 259 | |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 260 | extern struct workqueue_struct * |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 261 | __alloc_workqueue_key(const char *name, unsigned int flags, int max_active, |
| 262 | struct lock_class_key *key, const char *lock_name); |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 263 | |
| 264 | #ifdef CONFIG_LOCKDEP |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 265 | #define alloc_workqueue(name, flags, max_active) \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 266 | ({ \ |
| 267 | static struct lock_class_key __key; \ |
Johannes Berg | eb13ba8 | 2008-01-16 09:51:58 +0100 | [diff] [blame] | 268 | const char *__lock_name; \ |
| 269 | \ |
| 270 | if (__builtin_constant_p(name)) \ |
| 271 | __lock_name = (name); \ |
| 272 | else \ |
| 273 | __lock_name = #name; \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 274 | \ |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 275 | __alloc_workqueue_key((name), (flags), (max_active), \ |
| 276 | &__key, __lock_name); \ |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 277 | }) |
| 278 | #else |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 279 | #define alloc_workqueue(name, flags, max_active) \ |
| 280 | __alloc_workqueue_key((name), (flags), (max_active), NULL, NULL) |
Johannes Berg | 4e6045f | 2007-10-18 23:39:55 -0700 | [diff] [blame] | 281 | #endif |
| 282 | |
Tejun Heo | 97e37d7 | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 283 | #define create_workqueue(name) \ |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 284 | alloc_workqueue((name), WQ_RESCUER, 1) |
Tejun Heo | 97e37d7 | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 285 | #define create_freezeable_workqueue(name) \ |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 286 | alloc_workqueue((name), WQ_FREEZEABLE | WQ_SINGLE_CPU | WQ_RESCUER, 1) |
Tejun Heo | 97e37d7 | 2010-06-29 10:07:10 +0200 | [diff] [blame] | 287 | #define create_singlethread_workqueue(name) \ |
Tejun Heo | d320c03 | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 288 | alloc_workqueue((name), WQ_SINGLE_CPU | WQ_RESCUER, 1) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 289 | |
| 290 | extern void destroy_workqueue(struct workqueue_struct *wq); |
| 291 | |
Harvey Harrison | b3c9752 | 2008-02-13 15:03:15 -0800 | [diff] [blame] | 292 | extern int queue_work(struct workqueue_struct *wq, struct work_struct *work); |
Zhang Rui | c1a220e | 2008-07-23 21:28:39 -0700 | [diff] [blame] | 293 | extern int queue_work_on(int cpu, struct workqueue_struct *wq, |
| 294 | struct work_struct *work); |
Harvey Harrison | b3c9752 | 2008-02-13 15:03:15 -0800 | [diff] [blame] | 295 | extern int queue_delayed_work(struct workqueue_struct *wq, |
| 296 | struct delayed_work *work, unsigned long delay); |
Venkatesh Pallipadi | 7a6bc1c | 2006-06-28 13:50:33 -0700 | [diff] [blame] | 297 | extern int queue_delayed_work_on(int cpu, struct workqueue_struct *wq, |
Oleg Nesterov | 28e53bd | 2007-05-09 02:34:22 -0700 | [diff] [blame] | 298 | struct delayed_work *work, unsigned long delay); |
| 299 | |
Harvey Harrison | b3c9752 | 2008-02-13 15:03:15 -0800 | [diff] [blame] | 300 | extern void flush_workqueue(struct workqueue_struct *wq); |
Oleg Nesterov | 28e53bd | 2007-05-09 02:34:22 -0700 | [diff] [blame] | 301 | extern void flush_scheduled_work(void); |
Linus Torvalds | 43046b6 | 2009-10-14 09:16:42 -0700 | [diff] [blame] | 302 | extern void flush_delayed_work(struct delayed_work *work); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 303 | |
Harvey Harrison | b3c9752 | 2008-02-13 15:03:15 -0800 | [diff] [blame] | 304 | extern int schedule_work(struct work_struct *work); |
Zhang Rui | c1a220e | 2008-07-23 21:28:39 -0700 | [diff] [blame] | 305 | extern int schedule_work_on(int cpu, struct work_struct *work); |
Harvey Harrison | b3c9752 | 2008-02-13 15:03:15 -0800 | [diff] [blame] | 306 | extern int schedule_delayed_work(struct delayed_work *work, unsigned long delay); |
Oleg Nesterov | 28e53bd | 2007-05-09 02:34:22 -0700 | [diff] [blame] | 307 | extern int schedule_delayed_work_on(int cpu, struct delayed_work *work, |
| 308 | unsigned long delay); |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 309 | extern int schedule_on_each_cpu(work_func_t func); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 310 | extern int keventd_up(void); |
| 311 | |
| 312 | extern void init_workqueues(void); |
David Howells | 65f27f3 | 2006-11-22 14:55:48 +0000 | [diff] [blame] | 313 | int execute_in_process_context(work_func_t fn, struct execute_work *); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 314 | |
Oleg Nesterov | db70089 | 2008-07-25 01:47:49 -0700 | [diff] [blame] | 315 | extern int flush_work(struct work_struct *work); |
Oleg Nesterov | 1f1f642 | 2007-07-15 23:41:44 -0700 | [diff] [blame] | 316 | extern int cancel_work_sync(struct work_struct *work); |
Oleg Nesterov | 28e53bd | 2007-05-09 02:34:22 -0700 | [diff] [blame] | 317 | |
Tejun Heo | dcd989c | 2010-06-29 10:07:14 +0200 | [diff] [blame] | 318 | extern void workqueue_set_max_active(struct workqueue_struct *wq, |
| 319 | int max_active); |
| 320 | extern bool workqueue_congested(unsigned int cpu, struct workqueue_struct *wq); |
| 321 | extern unsigned int work_cpu(struct work_struct *work); |
| 322 | extern unsigned int work_busy(struct work_struct *work); |
| 323 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 324 | /* |
| 325 | * Kill off a pending schedule_delayed_work(). Note that the work callback |
Oleg Nesterov | 071b638 | 2007-04-26 15:45:32 -0700 | [diff] [blame] | 326 | * function may still be running on return from cancel_delayed_work(), unless |
| 327 | * it returns 1 and the work doesn't re-arm itself. Run flush_workqueue() or |
Oleg Nesterov | 28e53bd | 2007-05-09 02:34:22 -0700 | [diff] [blame] | 328 | * cancel_work_sync() to wait on it. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 329 | */ |
David Howells | 52bad64 | 2006-11-22 14:54:01 +0000 | [diff] [blame] | 330 | static inline int cancel_delayed_work(struct delayed_work *work) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 331 | { |
| 332 | int ret; |
| 333 | |
Oleg Nesterov | 223a10a | 2007-05-18 00:36:42 -0700 | [diff] [blame] | 334 | ret = del_timer_sync(&work->timer); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 335 | if (ret) |
Oleg Nesterov | 23b2e59 | 2007-05-09 02:34:19 -0700 | [diff] [blame] | 336 | work_clear_pending(&work->work); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 337 | return ret; |
| 338 | } |
| 339 | |
Oleg Nesterov | 4e49627 | 2009-09-05 11:17:06 -0700 | [diff] [blame] | 340 | /* |
| 341 | * Like above, but uses del_timer() instead of del_timer_sync(). This means, |
| 342 | * if it returns 0 the timer function may be running and the queueing is in |
| 343 | * progress. |
| 344 | */ |
| 345 | static inline int __cancel_delayed_work(struct delayed_work *work) |
| 346 | { |
| 347 | int ret; |
| 348 | |
| 349 | ret = del_timer(&work->timer); |
| 350 | if (ret) |
| 351 | work_clear_pending(&work->work); |
| 352 | return ret; |
| 353 | } |
| 354 | |
Oleg Nesterov | 1f1f642 | 2007-07-15 23:41:44 -0700 | [diff] [blame] | 355 | extern int cancel_delayed_work_sync(struct delayed_work *work); |
Oleg Nesterov | 1634c48 | 2007-05-09 02:34:18 -0700 | [diff] [blame] | 356 | |
Oleg Nesterov | f5a421a | 2007-07-15 23:41:44 -0700 | [diff] [blame] | 357 | /* Obsolete. use cancel_delayed_work_sync() */ |
Oleg Nesterov | 1634c48 | 2007-05-09 02:34:18 -0700 | [diff] [blame] | 358 | static inline |
| 359 | void cancel_rearming_delayed_workqueue(struct workqueue_struct *wq, |
| 360 | struct delayed_work *work) |
| 361 | { |
Oleg Nesterov | f5a421a | 2007-07-15 23:41:44 -0700 | [diff] [blame] | 362 | cancel_delayed_work_sync(work); |
| 363 | } |
| 364 | |
| 365 | /* Obsolete. use cancel_delayed_work_sync() */ |
| 366 | static inline |
| 367 | void cancel_rearming_delayed_work(struct delayed_work *work) |
| 368 | { |
| 369 | cancel_delayed_work_sync(work); |
Oleg Nesterov | 1634c48 | 2007-05-09 02:34:18 -0700 | [diff] [blame] | 370 | } |
| 371 | |
Rusty Russell | 2d3854a | 2008-11-05 13:39:10 +1100 | [diff] [blame] | 372 | #ifndef CONFIG_SMP |
| 373 | static inline long work_on_cpu(unsigned int cpu, long (*fn)(void *), void *arg) |
| 374 | { |
| 375 | return fn(arg); |
| 376 | } |
| 377 | #else |
| 378 | long work_on_cpu(unsigned int cpu, long (*fn)(void *), void *arg); |
| 379 | #endif /* CONFIG_SMP */ |
Tejun Heo | a0a1a5f | 2010-06-29 10:07:12 +0200 | [diff] [blame] | 380 | |
| 381 | #ifdef CONFIG_FREEZER |
| 382 | extern void freeze_workqueues_begin(void); |
| 383 | extern bool freeze_workqueues_busy(void); |
| 384 | extern void thaw_workqueues(void); |
| 385 | #endif /* CONFIG_FREEZER */ |
| 386 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 387 | #endif |