]> git.proxmox.com Git - mirror_spl.git/blame - module/spl/spl-taskq.c
Add TASKQ_DYNAMIC feature
[mirror_spl.git] / module / spl / spl-taskq.c
CommitLineData
716154c5
BB
1/*****************************************************************************\
2 * Copyright (C) 2007-2010 Lawrence Livermore National Security, LLC.
3 * Copyright (C) 2007 The Regents of the University of California.
4 * Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
5 * Written by Brian Behlendorf <behlendorf1@llnl.gov>.
715f6251 6 * UCRL-CODE-235197
7 *
716154c5 8 * This file is part of the SPL, Solaris Porting Layer.
3d6af2dd 9 * For details, see <http://zfsonlinux.org/>.
715f6251 10 *
716154c5
BB
11 * The SPL is free software; you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the
13 * Free Software Foundation; either version 2 of the License, or (at your
14 * option) any later version.
15 *
16 * The SPL is distributed in the hope that it will be useful, but WITHOUT
715f6251 17 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
18 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
19 * for more details.
20 *
21 * You should have received a copy of the GNU General Public License along
716154c5
BB
22 * with the SPL. If not, see <http://www.gnu.org/licenses/>.
23 *****************************************************************************
24 * Solaris Porting Layer (SPL) Task Queue Implementation.
25\*****************************************************************************/
715f6251 26
f4b37741 27#include <sys/taskq.h>
3d061e9d 28#include <sys/kmem.h>
937879f1 29
703371d8
AV
30int spl_taskq_thread_bind = 0;
31module_param(spl_taskq_thread_bind, int, 0644);
32MODULE_PARM_DESC(spl_taskq_thread_bind, "Bind taskq thread to CPU by default");
33
f7a973d9
BB
34
35int spl_taskq_thread_dynamic = 1;
36module_param(spl_taskq_thread_dynamic, int, 0644);
37MODULE_PARM_DESC(spl_taskq_thread_dynamic, "Allow dynamic taskq threads");
38
39int spl_taskq_thread_sequential = 4;
40module_param(spl_taskq_thread_sequential, int, 0644);
41MODULE_PARM_DESC(spl_taskq_thread_sequential,
42 "Create new taskq threads after N sequential tasks");
43
e9cb2b4f
BB
44/* Global system-wide dynamic task queue available for all consumers */
45taskq_t *system_taskq;
46EXPORT_SYMBOL(system_taskq);
47
f7a973d9
BB
48/* Private dedicated taskq for creating new taskq threads on demand. */
49static taskq_t *dynamic_taskq;
50static taskq_thread_t *taskq_thread_create(taskq_t *);
51
9b51f218
BB
52static int
53task_km_flags(uint_t flags)
54{
55 if (flags & TQ_NOSLEEP)
56 return KM_NOSLEEP;
57
58 if (flags & TQ_PUSHPAGE)
59 return KM_PUSHPAGE;
60
61 return KM_SLEEP;
62}
63
82387586
BB
64/*
65 * NOTE: Must be called with tq->tq_lock held, returns a list_t which
bcd68186 66 * is not attached to the free, work, or pending taskq lists.
f1ca4da6 67 */
046a70c9 68static taskq_ent_t *
bcd68186 69task_alloc(taskq_t *tq, uint_t flags)
70{
472a34ca
BB
71 taskq_ent_t *t;
72 int count = 0;
bcd68186 73
472a34ca
BB
74 ASSERT(tq);
75 ASSERT(spin_is_locked(&tq->tq_lock));
bcd68186 76retry:
472a34ca
BB
77 /* Acquire taskq_ent_t's from free list if available */
78 if (!list_empty(&tq->tq_free_list) && !(flags & TQ_NEW)) {
79 t = list_entry(tq->tq_free_list.next, taskq_ent_t, tqent_list);
80
81 ASSERT(!(t->tqent_flags & TQENT_FLAG_PREALLOC));
d9acd930
BB
82 ASSERT(!(t->tqent_flags & TQENT_FLAG_CANCEL));
83 ASSERT(!timer_pending(&t->tqent_timer));
472a34ca
BB
84
85 list_del_init(&t->tqent_list);
8d9a23e8 86 return (t);
472a34ca
BB
87 }
88
89 /* Free list is empty and memory allocations are prohibited */
90 if (flags & TQ_NOALLOC)
8d9a23e8 91 return (NULL);
472a34ca
BB
92
93 /* Hit maximum taskq_ent_t pool size */
94 if (tq->tq_nalloc >= tq->tq_maxalloc) {
95 if (flags & TQ_NOSLEEP)
8d9a23e8 96 return (NULL);
472a34ca
BB
97
98 /*
99 * Sleep periodically polling the free list for an available
100 * taskq_ent_t. Dispatching with TQ_SLEEP should always succeed
101 * but we cannot block forever waiting for an taskq_ent_t to
102 * show up in the free list, otherwise a deadlock can happen.
103 *
104 * Therefore, we need to allocate a new task even if the number
105 * of allocated tasks is above tq->tq_maxalloc, but we still
106 * end up delaying the task allocation by one second, thereby
107 * throttling the task dispatch rate.
108 */
109 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
110 schedule_timeout(HZ / 100);
111 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
8d9a23e8
BB
112 if (count < 100) {
113 count++;
114 goto retry;
115 }
472a34ca
BB
116 }
117
118 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
119 t = kmem_alloc(sizeof(taskq_ent_t), task_km_flags(flags));
120 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
121
122 if (t) {
123 taskq_init_ent(t);
124 tq->tq_nalloc++;
125 }
126
8d9a23e8 127 return (t);
bcd68186 128}
129
82387586 130/*
046a70c9 131 * NOTE: Must be called with tq->tq_lock held, expects the taskq_ent_t
bcd68186 132 * to already be removed from the free, work, or pending taskq lists.
133 */
134static void
046a70c9 135task_free(taskq_t *tq, taskq_ent_t *t)
bcd68186 136{
472a34ca
BB
137 ASSERT(tq);
138 ASSERT(t);
bcd68186 139 ASSERT(spin_is_locked(&tq->tq_lock));
046a70c9 140 ASSERT(list_empty(&t->tqent_list));
d9acd930 141 ASSERT(!timer_pending(&t->tqent_timer));
bcd68186 142
472a34ca
BB
143 kmem_free(t, sizeof(taskq_ent_t));
144 tq->tq_nalloc--;
bcd68186 145}
146
82387586
BB
147/*
148 * NOTE: Must be called with tq->tq_lock held, either destroys the
046a70c9 149 * taskq_ent_t if too many exist or moves it to the free list for later use.
bcd68186 150 */
f1ca4da6 151static void
046a70c9 152task_done(taskq_t *tq, taskq_ent_t *t)
f1ca4da6 153{
bcd68186 154 ASSERT(tq);
155 ASSERT(t);
156 ASSERT(spin_is_locked(&tq->tq_lock));
157
d9acd930
BB
158 /* Wake tasks blocked in taskq_wait_id() */
159 wake_up_all(&t->tqent_waitq);
160
046a70c9 161 list_del_init(&t->tqent_list);
f1ca4da6 162
472a34ca 163 if (tq->tq_nalloc <= tq->tq_minalloc) {
046a70c9
PS
164 t->tqent_id = 0;
165 t->tqent_func = NULL;
166 t->tqent_arg = NULL;
44217f7a 167 t->tqent_flags = 0;
8f2503e0 168
472a34ca 169 list_add_tail(&t->tqent_list, &tq->tq_free_list);
bcd68186 170 } else {
171 task_free(tq, t);
172 }
f1ca4da6 173}
174
82387586 175/*
d9acd930
BB
176 * When a delayed task timer expires remove it from the delay list and
177 * add it to the priority list in order for immediate processing.
bcd68186 178 */
d9acd930
BB
179static void
180task_expire(unsigned long data)
bcd68186 181{
d9acd930
BB
182 taskq_ent_t *w, *t = (taskq_ent_t *)data;
183 taskq_t *tq = t->tqent_taskq;
184 struct list_head *l;
7257ec41
BB
185
186 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
d9acd930
BB
187
188 if (t->tqent_flags & TQENT_FLAG_CANCEL) {
189 ASSERT(list_empty(&t->tqent_list));
190 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
191 return;
192 }
193
194 /*
195 * The priority list must be maintained in strict task id order
196 * from lowest to highest for lowest_id to be easily calculable.
197 */
198 list_del(&t->tqent_list);
199 list_for_each_prev(l, &tq->tq_prio_list) {
200 w = list_entry(l, taskq_ent_t, tqent_list);
201 if (w->tqent_id < t->tqent_id) {
202 list_add(&t->tqent_list, l);
203 break;
204 }
205 }
206 if (l == &tq->tq_prio_list)
207 list_add(&t->tqent_list, &tq->tq_prio_list);
208
7257ec41
BB
209 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
210
d9acd930
BB
211 wake_up(&tq->tq_work_waitq);
212}
213
214/*
215 * Returns the lowest incomplete taskqid_t. The taskqid_t may
216 * be queued on the pending list, on the priority list, on the
217 * delay list, or on the work list currently being handled, but
218 * it is not 100% complete yet.
219 */
220static taskqid_t
221taskq_lowest_id(taskq_t *tq)
222{
223 taskqid_t lowest_id = tq->tq_next_id;
224 taskq_ent_t *t;
225 taskq_thread_t *tqt;
d9acd930
BB
226
227 ASSERT(tq);
228 ASSERT(spin_is_locked(&tq->tq_lock));
229
230 if (!list_empty(&tq->tq_pend_list)) {
231 t = list_entry(tq->tq_pend_list.next, taskq_ent_t, tqent_list);
232 lowest_id = MIN(lowest_id, t->tqent_id);
233 }
234
235 if (!list_empty(&tq->tq_prio_list)) {
236 t = list_entry(tq->tq_prio_list.next, taskq_ent_t, tqent_list);
237 lowest_id = MIN(lowest_id, t->tqent_id);
238 }
239
240 if (!list_empty(&tq->tq_delay_list)) {
241 t = list_entry(tq->tq_delay_list.next, taskq_ent_t, tqent_list);
242 lowest_id = MIN(lowest_id, t->tqent_id);
243 }
244
245 if (!list_empty(&tq->tq_active_list)) {
246 tqt = list_entry(tq->tq_active_list.next, taskq_thread_t,
247 tqt_active_list);
248 ASSERT(tqt->tqt_id != 0);
249 lowest_id = MIN(lowest_id, tqt->tqt_id);
250 }
251
8d9a23e8 252 return (lowest_id);
d9acd930
BB
253}
254
255/*
256 * Insert a task into a list keeping the list sorted by increasing taskqid.
257 */
258static void
259taskq_insert_in_order(taskq_t *tq, taskq_thread_t *tqt)
260{
261 taskq_thread_t *w;
262 struct list_head *l;
263
d9acd930
BB
264 ASSERT(tq);
265 ASSERT(tqt);
266 ASSERT(spin_is_locked(&tq->tq_lock));
267
268 list_for_each_prev(l, &tq->tq_active_list) {
269 w = list_entry(l, taskq_thread_t, tqt_active_list);
270 if (w->tqt_id < tqt->tqt_id) {
271 list_add(&tqt->tqt_active_list, l);
272 break;
273 }
274 }
275 if (l == &tq->tq_active_list)
276 list_add(&tqt->tqt_active_list, &tq->tq_active_list);
d9acd930
BB
277}
278
279/*
280 * Find and return a task from the given list if it exists. The list
281 * must be in lowest to highest task id order.
282 */
283static taskq_ent_t *
284taskq_find_list(taskq_t *tq, struct list_head *lh, taskqid_t id)
285{
286 struct list_head *l;
287 taskq_ent_t *t;
d9acd930
BB
288
289 ASSERT(spin_is_locked(&tq->tq_lock));
290
291 list_for_each(l, lh) {
292 t = list_entry(l, taskq_ent_t, tqent_list);
293
294 if (t->tqent_id == id)
8d9a23e8 295 return (t);
d9acd930
BB
296
297 if (t->tqent_id > id)
298 break;
299 }
300
8d9a23e8 301 return (NULL);
bcd68186 302}
303
d9acd930
BB
304/*
305 * Find an already dispatched task given the task id regardless of what
306 * state it is in. If a task is still pending or executing it will be
307 * returned and 'active' set appropriately. If the task has already
308 * been run then NULL is returned.
309 */
310static taskq_ent_t *
311taskq_find(taskq_t *tq, taskqid_t id, int *active)
312{
313 taskq_thread_t *tqt;
314 struct list_head *l;
315 taskq_ent_t *t;
d9acd930
BB
316
317 ASSERT(spin_is_locked(&tq->tq_lock));
318 *active = 0;
319
320 t = taskq_find_list(tq, &tq->tq_delay_list, id);
321 if (t)
8d9a23e8 322 return (t);
d9acd930
BB
323
324 t = taskq_find_list(tq, &tq->tq_prio_list, id);
325 if (t)
8d9a23e8 326 return (t);
d9acd930
BB
327
328 t = taskq_find_list(tq, &tq->tq_pend_list, id);
329 if (t)
8d9a23e8 330 return (t);
d9acd930
BB
331
332 list_for_each(l, &tq->tq_active_list) {
333 tqt = list_entry(l, taskq_thread_t, tqt_active_list);
334 if (tqt->tqt_id == id) {
335 t = tqt->tqt_task;
336 *active = 1;
8d9a23e8 337 return (t);
d9acd930
BB
338 }
339 }
340
8d9a23e8 341 return (NULL);
d9acd930
BB
342}
343
a876b030
CD
344/*
345 * Theory for the taskq_wait_id(), taskq_wait_outstanding(), and
346 * taskq_wait() functions below.
347 *
348 * Taskq waiting is accomplished by tracking the lowest outstanding task
349 * id and the next available task id. As tasks are dispatched they are
350 * added to the tail of the pending, priority, or delay lists. As worker
351 * threads become available the tasks are removed from the heads of these
352 * lists and linked to the worker threads. This ensures the lists are
353 * kept sorted by lowest to highest task id.
354 *
355 * Therefore the lowest outstanding task id can be quickly determined by
356 * checking the head item from all of these lists. This value is stored
357 * with the taskq as the lowest id. It only needs to be recalculated when
358 * either the task with the current lowest id completes or is canceled.
359 *
360 * By blocking until the lowest task id exceeds the passed task id the
361 * taskq_wait_outstanding() function can be easily implemented. Similarly,
362 * by blocking until the lowest task id matches the next task id taskq_wait()
363 * can be implemented.
364 *
365 * Callers should be aware that when there are multiple worked threads it
366 * is possible for larger task ids to complete before smaller ones. Also
367 * when the taskq contains delay tasks with small task ids callers may
368 * block for a considerable length of time waiting for them to expire and
369 * execute.
370 */
99c452bb
BB
371static int
372taskq_wait_id_check(taskq_t *tq, taskqid_t id)
f1ca4da6 373{
d9acd930 374 int active = 0;
99c452bb 375 int rc;
bcd68186 376
d9acd930 377 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
99c452bb 378 rc = (taskq_find(tq, id, &active) == NULL);
d9acd930
BB
379 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
380
99c452bb
BB
381 return (rc);
382}
bcd68186 383
99c452bb
BB
384/*
385 * The taskq_wait_id() function blocks until the passed task id completes.
386 * This does not guarantee that all lower task ids have completed.
387 */
388void
389taskq_wait_id(taskq_t *tq, taskqid_t id)
390{
391 wait_event(tq->tq_wait_waitq, taskq_wait_id_check(tq, id));
bcd68186 392}
aed8671c 393EXPORT_SYMBOL(taskq_wait_id);
bcd68186 394
d9acd930 395static int
a876b030 396taskq_wait_outstanding_check(taskq_t *tq, taskqid_t id)
d9acd930
BB
397{
398 int rc;
399
400 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
401 rc = (id < tq->tq_lowest_id);
402 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
403
8d9a23e8 404 return (rc);
d9acd930
BB
405}
406
a876b030
CD
407/*
408 * The taskq_wait_outstanding() function will block until all tasks with a
409 * lower taskqid than the passed 'id' have been completed. Note that all
410 * task id's are assigned monotonically at dispatch time. Zero may be
411 * passed for the id to indicate all tasks dispatch up to this point,
412 * but not after, should be waited for.
413 */
d9acd930 414void
a876b030 415taskq_wait_outstanding(taskq_t *tq, taskqid_t id)
d9acd930 416{
a876b030
CD
417 wait_event(tq->tq_wait_waitq,
418 taskq_wait_outstanding_check(tq, id ? id : tq->tq_next_id - 1));
d9acd930 419}
a876b030 420EXPORT_SYMBOL(taskq_wait_outstanding);
d9acd930 421
a876b030
CD
422static int
423taskq_wait_check(taskq_t *tq)
bcd68186 424{
a876b030 425 int rc;
bcd68186 426
749045bb 427 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
a876b030 428 rc = (tq->tq_lowest_id == tq->tq_next_id);
749045bb 429 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 430
a876b030
CD
431 return (rc);
432}
433
434/*
435 * The taskq_wait() function will block until the taskq is empty.
436 * This means that if a taskq re-dispatches work to itself taskq_wait()
437 * callers will block indefinitely.
438 */
439void
440taskq_wait(taskq_t *tq)
441{
442 wait_event(tq->tq_wait_waitq, taskq_wait_check(tq));
bcd68186 443}
aed8671c 444EXPORT_SYMBOL(taskq_wait);
bcd68186 445
446int
aed8671c 447taskq_member(taskq_t *tq, void *t)
bcd68186 448{
2c02b71b
PS
449 struct list_head *l;
450 taskq_thread_t *tqt;
f7a973d9 451 int found = 0;
bcd68186 452
453 ASSERT(tq);
472a34ca 454 ASSERT(t);
bcd68186 455
f7a973d9 456 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
2c02b71b
PS
457 list_for_each(l, &tq->tq_thread_list) {
458 tqt = list_entry(l, taskq_thread_t, tqt_thread_list);
f7a973d9
BB
459 if (tqt->tqt_thread == (struct task_struct *)t) {
460 found = 1;
461 break;
462 }
2c02b71b 463 }
f7a973d9 464 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 465
f7a973d9 466 return (found);
bcd68186 467}
aed8671c 468EXPORT_SYMBOL(taskq_member);
bcd68186 469
d9acd930
BB
470/*
471 * Cancel an already dispatched task given the task id. Still pending tasks
472 * will be immediately canceled, and if the task is active the function will
473 * block until it completes. Preallocated tasks which are canceled must be
474 * freed by the caller.
475 */
476int
477taskq_cancel_id(taskq_t *tq, taskqid_t id)
478{
479 taskq_ent_t *t;
480 int active = 0;
481 int rc = ENOENT;
d9acd930
BB
482
483 ASSERT(tq);
484
485 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
486 t = taskq_find(tq, id, &active);
487 if (t && !active) {
488 list_del_init(&t->tqent_list);
489 t->tqent_flags |= TQENT_FLAG_CANCEL;
490
491 /*
492 * When canceling the lowest outstanding task id we
493 * must recalculate the new lowest outstanding id.
494 */
495 if (tq->tq_lowest_id == t->tqent_id) {
496 tq->tq_lowest_id = taskq_lowest_id(tq);
497 ASSERT3S(tq->tq_lowest_id, >, t->tqent_id);
498 }
499
500 /*
501 * The task_expire() function takes the tq->tq_lock so drop
502 * drop the lock before synchronously cancelling the timer.
503 */
504 if (timer_pending(&t->tqent_timer)) {
505 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
506 del_timer_sync(&t->tqent_timer);
507 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
508 }
509
510 if (!(t->tqent_flags & TQENT_FLAG_PREALLOC))
511 task_done(tq, t);
512
513 rc = 0;
514 }
515 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
516
517 if (active) {
518 taskq_wait_id(tq, id);
519 rc = EBUSY;
520 }
521
8d9a23e8 522 return (rc);
d9acd930
BB
523}
524EXPORT_SYMBOL(taskq_cancel_id);
525
bcd68186 526taskqid_t
aed8671c 527taskq_dispatch(taskq_t *tq, task_func_t func, void *arg, uint_t flags)
bcd68186 528{
472a34ca 529 taskq_ent_t *t;
bcd68186 530 taskqid_t rc = 0;
f1ca4da6 531
472a34ca
BB
532 ASSERT(tq);
533 ASSERT(func);
d05ec4b4 534
472a34ca 535 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
f1ca4da6 536
bcd68186 537 /* Taskq being destroyed and all tasks drained */
f7a973d9 538 if (!(tq->tq_flags & TASKQ_ACTIVE))
8d9a23e8 539 goto out;
f1ca4da6 540
bcd68186 541 /* Do not queue the task unless there is idle thread for it */
542 ASSERT(tq->tq_nactive <= tq->tq_nthreads);
543 if ((flags & TQ_NOQUEUE) && (tq->tq_nactive == tq->tq_nthreads))
8d9a23e8 544 goto out;
bcd68186 545
472a34ca 546 if ((t = task_alloc(tq, flags)) == NULL)
8d9a23e8 547 goto out;
f1ca4da6 548
046a70c9 549 spin_lock(&t->tqent_lock);
f0d8bb26
NB
550
551 /* Queue to the priority list instead of the pending list */
552 if (flags & TQ_FRONT)
046a70c9 553 list_add_tail(&t->tqent_list, &tq->tq_prio_list);
f0d8bb26 554 else
046a70c9 555 list_add_tail(&t->tqent_list, &tq->tq_pend_list);
f0d8bb26 556
046a70c9 557 t->tqent_id = rc = tq->tq_next_id;
bcd68186 558 tq->tq_next_id++;
472a34ca
BB
559 t->tqent_func = func;
560 t->tqent_arg = arg;
d9acd930
BB
561 t->tqent_taskq = tq;
562 t->tqent_timer.data = 0;
563 t->tqent_timer.function = NULL;
564 t->tqent_timer.expires = 0;
44217f7a
PS
565
566 ASSERT(!(t->tqent_flags & TQENT_FLAG_PREALLOC));
567
046a70c9 568 spin_unlock(&t->tqent_lock);
0bb43ca2
NB
569
570 wake_up(&tq->tq_work_waitq);
bcd68186 571out:
749045bb 572 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
8d9a23e8 573 return (rc);
f1ca4da6 574}
aed8671c 575EXPORT_SYMBOL(taskq_dispatch);
44217f7a 576
d9acd930
BB
577taskqid_t
578taskq_dispatch_delay(taskq_t *tq, task_func_t func, void *arg,
579 uint_t flags, clock_t expire_time)
580{
d9acd930 581 taskqid_t rc = 0;
8d9a23e8 582 taskq_ent_t *t;
d9acd930
BB
583
584 ASSERT(tq);
585 ASSERT(func);
586
587 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
588
589 /* Taskq being destroyed and all tasks drained */
f7a973d9 590 if (!(tq->tq_flags & TASKQ_ACTIVE))
8d9a23e8 591 goto out;
d9acd930
BB
592
593 if ((t = task_alloc(tq, flags)) == NULL)
8d9a23e8 594 goto out;
d9acd930
BB
595
596 spin_lock(&t->tqent_lock);
597
598 /* Queue to the delay list for subsequent execution */
599 list_add_tail(&t->tqent_list, &tq->tq_delay_list);
600
601 t->tqent_id = rc = tq->tq_next_id;
602 tq->tq_next_id++;
603 t->tqent_func = func;
604 t->tqent_arg = arg;
605 t->tqent_taskq = tq;
606 t->tqent_timer.data = (unsigned long)t;
607 t->tqent_timer.function = task_expire;
608 t->tqent_timer.expires = (unsigned long)expire_time;
609 add_timer(&t->tqent_timer);
610
611 ASSERT(!(t->tqent_flags & TQENT_FLAG_PREALLOC));
612
613 spin_unlock(&t->tqent_lock);
614out:
615 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
8d9a23e8 616 return (rc);
d9acd930
BB
617}
618EXPORT_SYMBOL(taskq_dispatch_delay);
619
44217f7a 620void
aed8671c 621taskq_dispatch_ent(taskq_t *tq, task_func_t func, void *arg, uint_t flags,
44217f7a
PS
622 taskq_ent_t *t)
623{
44217f7a
PS
624 ASSERT(tq);
625 ASSERT(func);
44217f7a
PS
626
627 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
628
629 /* Taskq being destroyed and all tasks drained */
f7a973d9 630 if (!(tq->tq_flags & TASKQ_ACTIVE)) {
44217f7a
PS
631 t->tqent_id = 0;
632 goto out;
633 }
634
635 spin_lock(&t->tqent_lock);
636
637 /*
638 * Mark it as a prealloc'd task. This is important
639 * to ensure that we don't free it later.
640 */
641 t->tqent_flags |= TQENT_FLAG_PREALLOC;
642
643 /* Queue to the priority list instead of the pending list */
644 if (flags & TQ_FRONT)
645 list_add_tail(&t->tqent_list, &tq->tq_prio_list);
646 else
647 list_add_tail(&t->tqent_list, &tq->tq_pend_list);
648
649 t->tqent_id = tq->tq_next_id;
650 tq->tq_next_id++;
651 t->tqent_func = func;
652 t->tqent_arg = arg;
d9acd930 653 t->tqent_taskq = tq;
44217f7a
PS
654
655 spin_unlock(&t->tqent_lock);
656
657 wake_up(&tq->tq_work_waitq);
658out:
0bb43ca2 659 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
44217f7a 660}
aed8671c 661EXPORT_SYMBOL(taskq_dispatch_ent);
44217f7a
PS
662
663int
aed8671c 664taskq_empty_ent(taskq_ent_t *t)
44217f7a
PS
665{
666 return list_empty(&t->tqent_list);
667}
aed8671c 668EXPORT_SYMBOL(taskq_empty_ent);
44217f7a
PS
669
670void
aed8671c 671taskq_init_ent(taskq_ent_t *t)
44217f7a
PS
672{
673 spin_lock_init(&t->tqent_lock);
d9acd930
BB
674 init_waitqueue_head(&t->tqent_waitq);
675 init_timer(&t->tqent_timer);
44217f7a
PS
676 INIT_LIST_HEAD(&t->tqent_list);
677 t->tqent_id = 0;
678 t->tqent_func = NULL;
679 t->tqent_arg = NULL;
680 t->tqent_flags = 0;
d9acd930 681 t->tqent_taskq = NULL;
44217f7a 682}
aed8671c 683EXPORT_SYMBOL(taskq_init_ent);
44217f7a 684
f7a973d9
BB
685/*
686 * Return the next pending task, preference is given to tasks on the
687 * priority list which were dispatched with TQ_FRONT.
688 */
689static taskq_ent_t *
690taskq_next_ent(taskq_t *tq)
691{
692 struct list_head *list;
693
694 ASSERT(spin_is_locked(&tq->tq_lock));
695
696 if (!list_empty(&tq->tq_prio_list))
697 list = &tq->tq_prio_list;
698 else if (!list_empty(&tq->tq_pend_list))
699 list = &tq->tq_pend_list;
700 else
701 return (NULL);
702
703 return (list_entry(list->next, taskq_ent_t, tqent_list));
704}
705
706/*
707 * Spawns a new thread for the specified taskq.
708 */
709static void
710taskq_thread_spawn_task(void *arg)
711{
712 taskq_t *tq = (taskq_t *)arg;
713
714 (void) taskq_thread_create(tq);
715
716 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
717 tq->tq_nspawn--;
718 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
719}
720
721/*
722 * Spawn addition threads for dynamic taskqs (TASKQ_DYNMAIC) the current
723 * number of threads is insufficient to handle the pending tasks. These
724 * new threads must be created by the dedicated dynamic_taskq to avoid
725 * deadlocks between thread creation and memory reclaim. The system_taskq
726 * which is also a dynamic taskq cannot be safely used for this.
727 */
728static int
729taskq_thread_spawn(taskq_t *tq, int seq_tasks)
730{
731 int spawning = 0;
732
733 if (!(tq->tq_flags & TASKQ_DYNAMIC))
734 return (0);
735
736 if ((seq_tasks > spl_taskq_thread_sequential) &&
737 (tq->tq_nthreads + tq->tq_nspawn < tq->tq_maxthreads) &&
738 (tq->tq_flags & TASKQ_ACTIVE)) {
739 spawning = (++tq->tq_nspawn);
740 taskq_dispatch(dynamic_taskq, taskq_thread_spawn_task,
741 tq, TQ_NOSLEEP);
742 }
743
744 return (spawning);
745}
746
747/*
748 * Threads in a dynamic taskq should only exit once it has been completely
749 * drained and no other threads are actively servicing tasks. This prevents
750 * threads from being created and destroyed more than is required.
751 *
752 * The first thread is the thread list is treated as the primary thread.
753 * There is nothing special about the primary thread but in order to avoid
754 * all the taskq pids from changing we opt to make it long running.
755 */
756static int
757taskq_thread_should_stop(taskq_t *tq, taskq_thread_t *tqt)
758{
759 ASSERT(spin_is_locked(&tq->tq_lock));
760
761 if (!(tq->tq_flags & TASKQ_DYNAMIC))
762 return (0);
763
764 if (list_first_entry(&(tq->tq_thread_list), taskq_thread_t,
765 tqt_thread_list) == tqt)
766 return (0);
767
768 return
769 ((tq->tq_nspawn == 0) && /* No threads are being spawned */
770 (tq->tq_nactive == 0) && /* No threads are handling tasks */
771 (tq->tq_nthreads > 1) && /* More than 1 thread is running */
772 (!taskq_next_ent(tq)) && /* There are no pending tasks */
773 (spl_taskq_thread_dynamic));/* Dynamic taskqs are allowed */
774}
775
bcd68186 776static int
777taskq_thread(void *args)
778{
472a34ca
BB
779 DECLARE_WAITQUEUE(wait, current);
780 sigset_t blocked;
2c02b71b 781 taskq_thread_t *tqt = args;
472a34ca
BB
782 taskq_t *tq;
783 taskq_ent_t *t;
f7a973d9 784 int seq_tasks = 0;
bcd68186 785
472a34ca 786 ASSERT(tqt);
2c02b71b 787 tq = tqt->tqt_tq;
472a34ca 788 current->flags |= PF_NOFREEZE;
bcd68186 789
472a34ca
BB
790 sigfillset(&blocked);
791 sigprocmask(SIG_BLOCK, &blocked, NULL);
792 flush_signals(current);
bcd68186 793
472a34ca 794 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
f7a973d9
BB
795
796 /* Immediately exit if more threads than allowed were created. */
797 if (tq->tq_nthreads >= tq->tq_maxthreads)
798 goto error;
799
472a34ca 800 tq->tq_nthreads++;
f7a973d9 801 list_add_tail(&tqt->tqt_thread_list, &tq->tq_thread_list);
472a34ca
BB
802 wake_up(&tq->tq_wait_waitq);
803 set_current_state(TASK_INTERRUPTIBLE);
bcd68186 804
472a34ca 805 while (!kthread_should_stop()) {
bcd68186 806
f0d8bb26
NB
807 if (list_empty(&tq->tq_pend_list) &&
808 list_empty(&tq->tq_prio_list)) {
f7a973d9
BB
809
810 if (taskq_thread_should_stop(tq, tqt)) {
811 wake_up_all(&tq->tq_wait_waitq);
812 break;
813 }
814
3c6ed541 815 add_wait_queue_exclusive(&tq->tq_work_waitq, &wait);
749045bb 816 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
f7a973d9 817
bcd68186 818 schedule();
f7a973d9
BB
819 seq_tasks = 0;
820
749045bb 821 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
3c6ed541 822 remove_wait_queue(&tq->tq_work_waitq, &wait);
bcd68186 823 } else {
824 __set_current_state(TASK_RUNNING);
825 }
826
f7a973d9 827 if ((t = taskq_next_ent(tq)) != NULL) {
472a34ca 828 list_del_init(&t->tqent_list);
8f2503e0 829
44217f7a
PS
830 /* In order to support recursively dispatching a
831 * preallocated taskq_ent_t, tqent_id must be
832 * stored prior to executing tqent_func. */
e7e5f78e 833 tqt->tqt_id = t->tqent_id;
d9acd930 834 tqt->tqt_task = t;
8f2503e0
PS
835
836 /* We must store a copy of the flags prior to
837 * servicing the task (servicing a prealloc'd task
838 * returns the ownership of the tqent back to
839 * the caller of taskq_dispatch). Thus,
840 * tqent_flags _may_ change within the call. */
841 tqt->tqt_flags = t->tqent_flags;
842
2c02b71b 843 taskq_insert_in_order(tq, tqt);
472a34ca 844 tq->tq_nactive++;
749045bb 845 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 846
847 /* Perform the requested task */
472a34ca 848 t->tqent_func(t->tqent_arg);
bcd68186 849
749045bb 850 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
472a34ca 851 tq->tq_nactive--;
2c02b71b 852 list_del_init(&tqt->tqt_active_list);
d9acd930 853 tqt->tqt_task = NULL;
8f2503e0
PS
854
855 /* For prealloc'd tasks, we don't free anything. */
f7a973d9 856 if (!(tqt->tqt_flags & TQENT_FLAG_PREALLOC))
8f2503e0 857 task_done(tq, t);
bcd68186 858
7257ec41
BB
859 /* When the current lowest outstanding taskqid is
860 * done calculate the new lowest outstanding id */
e7e5f78e 861 if (tq->tq_lowest_id == tqt->tqt_id) {
bcd68186 862 tq->tq_lowest_id = taskq_lowest_id(tq);
e7e5f78e 863 ASSERT3S(tq->tq_lowest_id, >, tqt->tqt_id);
bcd68186 864 }
865
f7a973d9
BB
866 /* Spawn additional taskq threads if required. */
867 if (taskq_thread_spawn(tq, ++seq_tasks))
868 seq_tasks = 0;
869
e7e5f78e 870 tqt->tqt_id = 0;
8f2503e0 871 tqt->tqt_flags = 0;
472a34ca 872 wake_up_all(&tq->tq_wait_waitq);
f7a973d9
BB
873 } else {
874 if (taskq_thread_should_stop(tq, tqt))
875 break;
bcd68186 876 }
877
878 set_current_state(TASK_INTERRUPTIBLE);
879
472a34ca 880 }
bcd68186 881
882 __set_current_state(TASK_RUNNING);
472a34ca 883 tq->tq_nthreads--;
2c02b71b 884 list_del_init(&tqt->tqt_thread_list);
f7a973d9
BB
885error:
886 kmem_free(tqt, sizeof (taskq_thread_t));
472a34ca 887 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 888
8d9a23e8 889 return (0);
bcd68186 890}
891
f7a973d9
BB
892static taskq_thread_t *
893taskq_thread_create(taskq_t *tq)
894{
895 static int last_used_cpu = 0;
896 taskq_thread_t *tqt;
897
898 tqt = kmem_alloc(sizeof (*tqt), KM_PUSHPAGE);
899 INIT_LIST_HEAD(&tqt->tqt_thread_list);
900 INIT_LIST_HEAD(&tqt->tqt_active_list);
901 tqt->tqt_tq = tq;
902 tqt->tqt_id = 0;
903
904 tqt->tqt_thread = spl_kthread_create(taskq_thread, tqt,
905 "%s", tq->tq_name);
906 if (tqt->tqt_thread == NULL) {
907 kmem_free(tqt, sizeof (taskq_thread_t));
908 return (NULL);
909 }
910
911 if (spl_taskq_thread_bind) {
912 last_used_cpu = (last_used_cpu + 1) % num_online_cpus();
913 kthread_bind(tqt->tqt_thread, last_used_cpu);
914 }
915
916 set_user_nice(tqt->tqt_thread, PRIO_TO_NICE(tq->tq_pri));
917 wake_up_process(tqt->tqt_thread);
918
919 return (tqt);
920}
921
f1ca4da6 922taskq_t *
aed8671c 923taskq_create(const char *name, int nthreads, pri_t pri,
472a34ca 924 int minalloc, int maxalloc, uint_t flags)
f1ca4da6 925{
472a34ca 926 taskq_t *tq;
2c02b71b 927 taskq_thread_t *tqt;
f7a973d9 928 int count = 0, rc = 0, i;
bcd68186 929
472a34ca
BB
930 ASSERT(name != NULL);
931 ASSERT(pri <= maxclsyspri);
932 ASSERT(minalloc >= 0);
933 ASSERT(maxalloc <= INT_MAX);
f7a973d9 934 ASSERT(!(flags & (TASKQ_CPR_SAFE))); /* Unsupported */
bcd68186 935
915404bd
BB
936 /* Scale the number of threads using nthreads as a percentage */
937 if (flags & TASKQ_THREADS_CPU_PCT) {
938 ASSERT(nthreads <= 100);
939 ASSERT(nthreads >= 0);
940 nthreads = MIN(nthreads, 100);
941 nthreads = MAX(nthreads, 0);
942 nthreads = MAX((num_online_cpus() * nthreads) / 100, 1);
943 }
944
f7a973d9 945 tq = kmem_alloc(sizeof (*tq), KM_PUSHPAGE);
472a34ca 946 if (tq == NULL)
8d9a23e8 947 return (NULL);
bcd68186 948
472a34ca 949 spin_lock_init(&tq->tq_lock);
472a34ca
BB
950 INIT_LIST_HEAD(&tq->tq_thread_list);
951 INIT_LIST_HEAD(&tq->tq_active_list);
f7a973d9
BB
952 tq->tq_name = strdup(name);
953 tq->tq_nactive = 0;
954 tq->tq_nthreads = 0;
955 tq->tq_nspawn = 0;
956 tq->tq_maxthreads = nthreads;
957 tq->tq_pri = pri;
958 tq->tq_minalloc = minalloc;
959 tq->tq_maxalloc = maxalloc;
960 tq->tq_nalloc = 0;
961 tq->tq_flags = (flags | TASKQ_ACTIVE);
962 tq->tq_next_id = 1;
963 tq->tq_lowest_id = 1;
472a34ca
BB
964 INIT_LIST_HEAD(&tq->tq_free_list);
965 INIT_LIST_HEAD(&tq->tq_pend_list);
966 INIT_LIST_HEAD(&tq->tq_prio_list);
d9acd930 967 INIT_LIST_HEAD(&tq->tq_delay_list);
472a34ca
BB
968 init_waitqueue_head(&tq->tq_work_waitq);
969 init_waitqueue_head(&tq->tq_wait_waitq);
bcd68186 970
f7a973d9
BB
971 if (flags & TASKQ_PREPOPULATE) {
972 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
973
472a34ca
BB
974 for (i = 0; i < minalloc; i++)
975 task_done(tq, task_alloc(tq, TQ_PUSHPAGE | TQ_NEW));
6e605b6e 976
f7a973d9
BB
977 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
978 }
979
980 if ((flags & TASKQ_DYNAMIC) && spl_taskq_thread_dynamic)
981 nthreads = 1;
6e605b6e 982
2c02b71b 983 for (i = 0; i < nthreads; i++) {
f7a973d9
BB
984 tqt = taskq_thread_create(tq);
985 if (tqt == NULL)
2c02b71b 986 rc = 1;
f7a973d9
BB
987 else
988 count++;
2c02b71b 989 }
bcd68186 990
472a34ca 991 /* Wait for all threads to be started before potential destroy */
f7a973d9 992 wait_event(tq->tq_wait_waitq, tq->tq_nthreads == count);
bcd68186 993
472a34ca 994 if (rc) {
aed8671c 995 taskq_destroy(tq);
472a34ca
BB
996 tq = NULL;
997 }
bcd68186 998
8d9a23e8 999 return (tq);
f1ca4da6 1000}
aed8671c 1001EXPORT_SYMBOL(taskq_create);
b123971f 1002
1003void
aed8671c 1004taskq_destroy(taskq_t *tq)
b123971f 1005{
2c02b71b
PS
1006 struct task_struct *thread;
1007 taskq_thread_t *tqt;
046a70c9 1008 taskq_ent_t *t;
b123971f 1009
bcd68186 1010 ASSERT(tq);
749045bb 1011 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
f7a973d9 1012 tq->tq_flags &= ~TASKQ_ACTIVE;
749045bb 1013 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 1014
f7a973d9
BB
1015 /*
1016 * When TASKQ_ACTIVE is clear new tasks may not be added nor may
1017 * new worker threads be spawned for dynamic taskq.
1018 */
1019 if (dynamic_taskq != NULL)
1020 taskq_wait_outstanding(dynamic_taskq, 0);
1021
aed8671c 1022 taskq_wait(tq);
bcd68186 1023
472a34ca 1024 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
bcd68186 1025
2c02b71b
PS
1026 /*
1027 * Signal each thread to exit and block until it does. Each thread
1028 * is responsible for removing itself from the list and freeing its
1029 * taskq_thread_t. This allows for idle threads to opt to remove
1030 * themselves from the taskq. They can be recreated as needed.
1031 */
1032 while (!list_empty(&tq->tq_thread_list)) {
1033 tqt = list_entry(tq->tq_thread_list.next,
f7a973d9 1034 taskq_thread_t, tqt_thread_list);
2c02b71b
PS
1035 thread = tqt->tqt_thread;
1036 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
1037
1038 kthread_stop(thread);
1039
472a34ca 1040 spin_lock_irqsave(&tq->tq_lock, tq->tq_lock_flags);
2c02b71b
PS
1041 }
1042
472a34ca 1043 while (!list_empty(&tq->tq_free_list)) {
046a70c9 1044 t = list_entry(tq->tq_free_list.next, taskq_ent_t, tqent_list);
44217f7a
PS
1045
1046 ASSERT(!(t->tqent_flags & TQENT_FLAG_PREALLOC));
1047
472a34ca
BB
1048 list_del_init(&t->tqent_list);
1049 task_free(tq, t);
1050 }
bcd68186 1051
f7a973d9
BB
1052 ASSERT0(tq->tq_nthreads);
1053 ASSERT0(tq->tq_nalloc);
1054 ASSERT0(tq->tq_nspawn);
472a34ca
BB
1055 ASSERT(list_empty(&tq->tq_thread_list));
1056 ASSERT(list_empty(&tq->tq_active_list));
1057 ASSERT(list_empty(&tq->tq_free_list));
1058 ASSERT(list_empty(&tq->tq_pend_list));
1059 ASSERT(list_empty(&tq->tq_prio_list));
d9acd930 1060 ASSERT(list_empty(&tq->tq_delay_list));
bcd68186 1061
472a34ca 1062 spin_unlock_irqrestore(&tq->tq_lock, tq->tq_lock_flags);
2c02b71b 1063
f7a973d9
BB
1064 strfree(tq->tq_name);
1065 kmem_free(tq, sizeof (taskq_t));
b123971f 1066}
aed8671c 1067EXPORT_SYMBOL(taskq_destroy);
e9cb2b4f
BB
1068
1069int
1070spl_taskq_init(void)
1071{
f220894e
BB
1072 /* Solaris creates a dynamic taskq of up to 64 threads, however in
1073 * a Linux environment 1 thread per-core is usually about right */
472a34ca 1074 system_taskq = taskq_create("spl_system_taskq", num_online_cpus(),
f220894e 1075 minclsyspri, 4, 512, TASKQ_PREPOPULATE);
e9cb2b4f 1076 if (system_taskq == NULL)
8d9a23e8 1077 return (1);
e9cb2b4f 1078
f7a973d9
BB
1079 dynamic_taskq = taskq_create("spl_dynamic_taskq", 1,
1080 minclsyspri, boot_ncpus, INT_MAX, TASKQ_PREPOPULATE);
1081 if (dynamic_taskq == NULL) {
1082 taskq_destroy(system_taskq);
1083 return (1);
1084 }
1085
8d9a23e8 1086 return (0);
e9cb2b4f
BB
1087}
1088
1089void
1090spl_taskq_fini(void)
1091{
f7a973d9
BB
1092 taskq_destroy(dynamic_taskq);
1093 dynamic_taskq = NULL;
1094
e9cb2b4f 1095 taskq_destroy(system_taskq);
f7a973d9 1096 system_taskq = NULL;
e9cb2b4f 1097}