1 // SPDX-License-Identifier: GPL-2.0
3 * Basic worker thread pool for io_uring
5 * Copyright (C) 2019 Jens Axboe
8 #include <linux/kernel.h>
9 #include <linux/init.h>
10 #include <linux/errno.h>
11 #include <linux/sched/signal.h>
12 #include <linux/percpu.h>
13 #include <linux/slab.h>
14 #include <linux/rculist_nulls.h>
15 #include <linux/cpu.h>
16 #include <linux/tracehook.h>
20 #define WORKER_IDLE_TIMEOUT (5 * HZ)
23 IO_WORKER_F_UP = 1, /* up and active */
24 IO_WORKER_F_RUNNING = 2, /* account as running */
25 IO_WORKER_F_FREE = 4, /* worker on free list */
26 IO_WORKER_F_BOUND = 8, /* is doing bounded work */
30 IO_WQ_BIT_EXIT = 0, /* wq exiting */
34 IO_ACCT_STALLED_BIT = 0, /* stalled on hash */
38 * One for each thread in a wqe pool
43 struct hlist_nulls_node nulls_node;
44 struct list_head all_list;
45 struct task_struct *task;
48 struct io_wq_work *cur_work;
51 struct completion ref_done;
53 unsigned long create_state;
54 struct callback_head create_work;
59 struct work_struct work;
63 #if BITS_PER_LONG == 64
64 #define IO_WQ_HASH_ORDER 6
66 #define IO_WQ_HASH_ORDER 5
69 #define IO_WQ_NR_HASH_BUCKETS (1u << IO_WQ_HASH_ORDER)
76 struct io_wq_work_list work_list;
87 * Per-node worker thread pool
91 struct io_wqe_acct acct[2];
95 struct hlist_nulls_head free_list;
96 struct list_head all_list;
98 struct wait_queue_entry wait;
101 struct io_wq_work *hash_tail[IO_WQ_NR_HASH_BUCKETS];
103 cpumask_var_t cpu_mask;
112 free_work_fn *free_work;
113 io_wq_work_fn *do_work;
115 struct io_wq_hash *hash;
117 atomic_t worker_refs;
118 struct completion worker_done;
120 struct hlist_node cpuhp_node;
122 struct task_struct *task;
124 struct io_wqe *wqes[];
127 static enum cpuhp_state io_wq_online;
129 struct io_cb_cancel_data {
137 static bool create_io_worker(struct io_wq *wq, struct io_wqe *wqe, int index);
138 static void io_wqe_dec_running(struct io_worker *worker);
139 static bool io_acct_cancel_pending_work(struct io_wqe *wqe,
140 struct io_wqe_acct *acct,
141 struct io_cb_cancel_data *match);
143 static bool io_worker_get(struct io_worker *worker)
145 return refcount_inc_not_zero(&worker->ref);
148 static void io_worker_release(struct io_worker *worker)
150 if (refcount_dec_and_test(&worker->ref))
151 complete(&worker->ref_done);
154 static inline struct io_wqe_acct *io_get_acct(struct io_wqe *wqe, bool bound)
156 return &wqe->acct[bound ? IO_WQ_ACCT_BOUND : IO_WQ_ACCT_UNBOUND];
159 static inline struct io_wqe_acct *io_work_get_acct(struct io_wqe *wqe,
160 struct io_wq_work *work)
162 return io_get_acct(wqe, !(work->flags & IO_WQ_WORK_UNBOUND));
165 static inline struct io_wqe_acct *io_wqe_get_acct(struct io_worker *worker)
167 return io_get_acct(worker->wqe, worker->flags & IO_WORKER_F_BOUND);
170 static void io_worker_ref_put(struct io_wq *wq)
172 if (atomic_dec_and_test(&wq->worker_refs))
173 complete(&wq->worker_done);
176 static void io_worker_exit(struct io_worker *worker)
178 struct io_wqe *wqe = worker->wqe;
179 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
181 if (refcount_dec_and_test(&worker->ref))
182 complete(&worker->ref_done);
183 wait_for_completion(&worker->ref_done);
185 raw_spin_lock(&wqe->lock);
186 if (worker->flags & IO_WORKER_F_FREE)
187 hlist_nulls_del_rcu(&worker->nulls_node);
188 list_del_rcu(&worker->all_list);
191 io_wqe_dec_running(worker);
193 current->flags &= ~PF_IO_WORKER;
195 raw_spin_unlock(&wqe->lock);
197 kfree_rcu(worker, rcu);
198 io_worker_ref_put(wqe->wq);
202 static inline bool io_acct_run_queue(struct io_wqe_acct *acct)
204 if (!wq_list_empty(&acct->work_list) &&
205 !test_bit(IO_ACCT_STALLED_BIT, &acct->flags))
211 * Check head of free list for an available worker. If one isn't available,
212 * caller must create one.
214 static bool io_wqe_activate_free_worker(struct io_wqe *wqe,
215 struct io_wqe_acct *acct)
218 struct hlist_nulls_node *n;
219 struct io_worker *worker;
222 * Iterate free_list and see if we can find an idle worker to
223 * activate. If a given worker is on the free_list but in the process
224 * of exiting, keep trying.
226 hlist_nulls_for_each_entry_rcu(worker, n, &wqe->free_list, nulls_node) {
227 if (!io_worker_get(worker))
229 if (io_wqe_get_acct(worker) != acct) {
230 io_worker_release(worker);
233 if (wake_up_process(worker->task)) {
234 io_worker_release(worker);
237 io_worker_release(worker);
244 * We need a worker. If we find a free one, we're good. If not, and we're
245 * below the max number of workers, create one.
247 static bool io_wqe_create_worker(struct io_wqe *wqe, struct io_wqe_acct *acct)
249 bool do_create = false;
252 * Most likely an attempt to queue unbounded work on an io_wq that
253 * wasn't setup with any unbounded workers.
255 if (unlikely(!acct->max_workers))
256 pr_warn_once("io-wq is not configured for unbound workers");
258 raw_spin_lock(&wqe->lock);
259 if (acct->nr_workers < acct->max_workers) {
263 raw_spin_unlock(&wqe->lock);
265 atomic_inc(&acct->nr_running);
266 atomic_inc(&wqe->wq->worker_refs);
267 return create_io_worker(wqe->wq, wqe, acct->index);
273 static void io_wqe_inc_running(struct io_worker *worker)
275 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
277 atomic_inc(&acct->nr_running);
280 static void create_worker_cb(struct callback_head *cb)
282 struct io_worker *worker;
285 struct io_wqe_acct *acct;
286 bool do_create = false;
288 worker = container_of(cb, struct io_worker, create_work);
291 acct = &wqe->acct[worker->create_index];
292 raw_spin_lock(&wqe->lock);
293 if (acct->nr_workers < acct->max_workers) {
297 raw_spin_unlock(&wqe->lock);
299 create_io_worker(wq, wqe, worker->create_index);
301 atomic_dec(&acct->nr_running);
302 io_worker_ref_put(wq);
304 clear_bit_unlock(0, &worker->create_state);
305 io_worker_release(worker);
308 static bool io_queue_worker_create(struct io_worker *worker,
309 struct io_wqe_acct *acct,
310 task_work_func_t func)
312 struct io_wqe *wqe = worker->wqe;
313 struct io_wq *wq = wqe->wq;
315 /* raced with exit, just ignore create call */
316 if (test_bit(IO_WQ_BIT_EXIT, &wq->state))
318 if (!io_worker_get(worker))
321 * create_state manages ownership of create_work/index. We should
322 * only need one entry per worker, as the worker going to sleep
323 * will trigger the condition, and waking will clear it once it
324 * runs the task_work.
326 if (test_bit(0, &worker->create_state) ||
327 test_and_set_bit_lock(0, &worker->create_state))
330 init_task_work(&worker->create_work, func);
331 worker->create_index = acct->index;
332 if (!task_work_add(wq->task, &worker->create_work, TWA_SIGNAL))
334 clear_bit_unlock(0, &worker->create_state);
336 io_worker_release(worker);
338 atomic_dec(&acct->nr_running);
339 io_worker_ref_put(wq);
343 static void io_wqe_dec_running(struct io_worker *worker)
344 __must_hold(wqe->lock)
346 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
347 struct io_wqe *wqe = worker->wqe;
349 if (!(worker->flags & IO_WORKER_F_UP))
352 if (atomic_dec_and_test(&acct->nr_running) && io_acct_run_queue(acct)) {
353 atomic_inc(&acct->nr_running);
354 atomic_inc(&wqe->wq->worker_refs);
355 io_queue_worker_create(worker, acct, create_worker_cb);
360 * Worker will start processing some work. Move it to the busy list, if
361 * it's currently on the freelist
363 static void __io_worker_busy(struct io_wqe *wqe, struct io_worker *worker,
364 struct io_wq_work *work)
365 __must_hold(wqe->lock)
367 if (worker->flags & IO_WORKER_F_FREE) {
368 worker->flags &= ~IO_WORKER_F_FREE;
369 hlist_nulls_del_init_rcu(&worker->nulls_node);
374 * No work, worker going to sleep. Move to freelist, and unuse mm if we
375 * have one attached. Dropping the mm may potentially sleep, so we drop
376 * the lock in that case and return success. Since the caller has to
377 * retry the loop in that case (we changed task state), we don't regrab
378 * the lock if we return success.
380 static void __io_worker_idle(struct io_wqe *wqe, struct io_worker *worker)
381 __must_hold(wqe->lock)
383 if (!(worker->flags & IO_WORKER_F_FREE)) {
384 worker->flags |= IO_WORKER_F_FREE;
385 hlist_nulls_add_head_rcu(&worker->nulls_node, &wqe->free_list);
389 static inline unsigned int io_get_work_hash(struct io_wq_work *work)
391 return work->flags >> IO_WQ_HASH_SHIFT;
394 static void io_wait_on_hash(struct io_wqe *wqe, unsigned int hash)
396 struct io_wq *wq = wqe->wq;
398 spin_lock_irq(&wq->hash->wait.lock);
399 if (list_empty(&wqe->wait.entry)) {
400 __add_wait_queue(&wq->hash->wait, &wqe->wait);
401 if (!test_bit(hash, &wq->hash->map)) {
402 __set_current_state(TASK_RUNNING);
403 list_del_init(&wqe->wait.entry);
406 spin_unlock_irq(&wq->hash->wait.lock);
409 static struct io_wq_work *io_get_next_work(struct io_wqe_acct *acct,
410 struct io_worker *worker)
411 __must_hold(wqe->lock)
413 struct io_wq_work_node *node, *prev;
414 struct io_wq_work *work, *tail;
415 unsigned int stall_hash = -1U;
416 struct io_wqe *wqe = worker->wqe;
418 wq_list_for_each(node, prev, &acct->work_list) {
421 work = container_of(node, struct io_wq_work, list);
423 /* not hashed, can run anytime */
424 if (!io_wq_is_hashed(work)) {
425 wq_list_del(&acct->work_list, node, prev);
429 hash = io_get_work_hash(work);
430 /* all items with this hash lie in [work, tail] */
431 tail = wqe->hash_tail[hash];
433 /* hashed, can run if not already running */
434 if (!test_and_set_bit(hash, &wqe->wq->hash->map)) {
435 wqe->hash_tail[hash] = NULL;
436 wq_list_cut(&acct->work_list, &tail->list, prev);
439 if (stall_hash == -1U)
441 /* fast forward to a next hash, for-each will fix up @prev */
445 if (stall_hash != -1U) {
447 * Set this before dropping the lock to avoid racing with new
448 * work being added and clearing the stalled bit.
450 set_bit(IO_ACCT_STALLED_BIT, &acct->flags);
451 raw_spin_unlock(&wqe->lock);
452 io_wait_on_hash(wqe, stall_hash);
453 raw_spin_lock(&wqe->lock);
459 static bool io_flush_signals(void)
461 if (unlikely(test_thread_flag(TIF_NOTIFY_SIGNAL))) {
462 __set_current_state(TASK_RUNNING);
463 tracehook_notify_signal();
469 static void io_assign_current_work(struct io_worker *worker,
470 struct io_wq_work *work)
477 spin_lock(&worker->lock);
478 worker->cur_work = work;
479 spin_unlock(&worker->lock);
482 static void io_wqe_enqueue(struct io_wqe *wqe, struct io_wq_work *work);
484 static void io_worker_handle_work(struct io_worker *worker)
485 __releases(wqe->lock)
487 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
488 struct io_wqe *wqe = worker->wqe;
489 struct io_wq *wq = wqe->wq;
490 bool do_kill = test_bit(IO_WQ_BIT_EXIT, &wq->state);
493 struct io_wq_work *work;
496 * If we got some work, mark us as busy. If we didn't, but
497 * the list isn't empty, it means we stalled on hashed work.
498 * Mark us stalled so we don't keep looking for work when we
499 * can't make progress, any work completion or insertion will
500 * clear the stalled flag.
502 work = io_get_next_work(acct, worker);
504 __io_worker_busy(wqe, worker, work);
506 raw_spin_unlock(&wqe->lock);
509 io_assign_current_work(worker, work);
510 __set_current_state(TASK_RUNNING);
512 /* handle a whole dependent link */
514 struct io_wq_work *next_hashed, *linked;
515 unsigned int hash = io_get_work_hash(work);
517 next_hashed = wq_next_work(work);
519 if (unlikely(do_kill) && (work->flags & IO_WQ_WORK_UNBOUND))
520 work->flags |= IO_WQ_WORK_CANCEL;
522 io_assign_current_work(worker, NULL);
524 linked = wq->free_work(work);
526 if (!work && linked && !io_wq_is_hashed(linked)) {
530 io_assign_current_work(worker, work);
532 io_wqe_enqueue(wqe, linked);
534 if (hash != -1U && !next_hashed) {
535 clear_bit(hash, &wq->hash->map);
536 clear_bit(IO_ACCT_STALLED_BIT, &acct->flags);
537 if (wq_has_sleeper(&wq->hash->wait))
538 wake_up(&wq->hash->wait);
539 raw_spin_lock(&wqe->lock);
540 /* skip unnecessary unlock-lock wqe->lock */
543 raw_spin_unlock(&wqe->lock);
547 raw_spin_lock(&wqe->lock);
551 static int io_wqe_worker(void *data)
553 struct io_worker *worker = data;
554 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
555 struct io_wqe *wqe = worker->wqe;
556 struct io_wq *wq = wqe->wq;
557 bool last_timeout = false;
558 char buf[TASK_COMM_LEN];
560 worker->flags |= (IO_WORKER_F_UP | IO_WORKER_F_RUNNING);
562 snprintf(buf, sizeof(buf), "iou-wrk-%d", wq->task->pid);
563 set_task_comm(current, buf);
565 while (!test_bit(IO_WQ_BIT_EXIT, &wq->state)) {
568 set_current_state(TASK_INTERRUPTIBLE);
570 raw_spin_lock(&wqe->lock);
571 if (io_acct_run_queue(acct)) {
572 io_worker_handle_work(worker);
575 /* timed out, exit unless we're the last worker */
576 if (last_timeout && acct->nr_workers > 1) {
577 raw_spin_unlock(&wqe->lock);
578 __set_current_state(TASK_RUNNING);
581 last_timeout = false;
582 __io_worker_idle(wqe, worker);
583 raw_spin_unlock(&wqe->lock);
584 if (io_flush_signals())
586 ret = schedule_timeout(WORKER_IDLE_TIMEOUT);
587 if (signal_pending(current)) {
590 if (!get_signal(&ksig))
592 if (fatal_signal_pending(current))
599 if (test_bit(IO_WQ_BIT_EXIT, &wq->state)) {
600 raw_spin_lock(&wqe->lock);
601 io_worker_handle_work(worker);
604 io_worker_exit(worker);
609 * Called when a worker is scheduled in. Mark us as currently running.
611 void io_wq_worker_running(struct task_struct *tsk)
613 struct io_worker *worker = tsk->pf_io_worker;
617 if (!(worker->flags & IO_WORKER_F_UP))
619 if (worker->flags & IO_WORKER_F_RUNNING)
621 worker->flags |= IO_WORKER_F_RUNNING;
622 io_wqe_inc_running(worker);
626 * Called when worker is going to sleep. If there are no workers currently
627 * running and we have work pending, wake up a free one or create a new one.
629 void io_wq_worker_sleeping(struct task_struct *tsk)
631 struct io_worker *worker = tsk->pf_io_worker;
635 if (!(worker->flags & IO_WORKER_F_UP))
637 if (!(worker->flags & IO_WORKER_F_RUNNING))
640 worker->flags &= ~IO_WORKER_F_RUNNING;
642 raw_spin_lock(&worker->wqe->lock);
643 io_wqe_dec_running(worker);
644 raw_spin_unlock(&worker->wqe->lock);
647 static void io_init_new_worker(struct io_wqe *wqe, struct io_worker *worker,
648 struct task_struct *tsk)
650 tsk->pf_io_worker = worker;
652 set_cpus_allowed_ptr(tsk, wqe->cpu_mask);
653 tsk->flags |= PF_NO_SETAFFINITY;
655 raw_spin_lock(&wqe->lock);
656 hlist_nulls_add_head_rcu(&worker->nulls_node, &wqe->free_list);
657 list_add_tail_rcu(&worker->all_list, &wqe->all_list);
658 worker->flags |= IO_WORKER_F_FREE;
659 raw_spin_unlock(&wqe->lock);
660 wake_up_new_task(tsk);
663 static bool io_wq_work_match_all(struct io_wq_work *work, void *data)
668 static inline bool io_should_retry_thread(long err)
673 case -ERESTARTNOINTR:
674 case -ERESTARTNOHAND:
681 static void create_worker_cont(struct callback_head *cb)
683 struct io_worker *worker;
684 struct task_struct *tsk;
687 worker = container_of(cb, struct io_worker, create_work);
688 clear_bit_unlock(0, &worker->create_state);
690 tsk = create_io_thread(io_wqe_worker, worker, wqe->node);
692 io_init_new_worker(wqe, worker, tsk);
693 io_worker_release(worker);
695 } else if (!io_should_retry_thread(PTR_ERR(tsk))) {
696 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
698 atomic_dec(&acct->nr_running);
699 raw_spin_lock(&wqe->lock);
701 if (!acct->nr_workers) {
702 struct io_cb_cancel_data match = {
703 .fn = io_wq_work_match_all,
707 while (io_acct_cancel_pending_work(wqe, acct, &match))
708 raw_spin_lock(&wqe->lock);
710 raw_spin_unlock(&wqe->lock);
711 io_worker_ref_put(wqe->wq);
715 /* re-create attempts grab a new worker ref, drop the existing one */
716 io_worker_release(worker);
717 schedule_work(&worker->work);
720 static void io_workqueue_create(struct work_struct *work)
722 struct io_worker *worker = container_of(work, struct io_worker, work);
723 struct io_wqe_acct *acct = io_wqe_get_acct(worker);
725 if (!io_queue_worker_create(worker, acct, create_worker_cont)) {
726 clear_bit_unlock(0, &worker->create_state);
727 io_worker_release(worker);
731 static bool create_io_worker(struct io_wq *wq, struct io_wqe *wqe, int index)
733 struct io_wqe_acct *acct = &wqe->acct[index];
734 struct io_worker *worker;
735 struct task_struct *tsk;
737 __set_current_state(TASK_RUNNING);
739 worker = kzalloc_node(sizeof(*worker), GFP_KERNEL, wqe->node);
742 atomic_dec(&acct->nr_running);
743 raw_spin_lock(&wqe->lock);
745 raw_spin_unlock(&wqe->lock);
746 io_worker_ref_put(wq);
750 refcount_set(&worker->ref, 1);
752 spin_lock_init(&worker->lock);
753 init_completion(&worker->ref_done);
755 if (index == IO_WQ_ACCT_BOUND)
756 worker->flags |= IO_WORKER_F_BOUND;
758 tsk = create_io_thread(io_wqe_worker, worker, wqe->node);
760 io_init_new_worker(wqe, worker, tsk);
761 } else if (!io_should_retry_thread(PTR_ERR(tsk))) {
764 INIT_WORK(&worker->work, io_workqueue_create);
765 schedule_work(&worker->work);
772 * Iterate the passed in list and call the specific function for each
773 * worker that isn't exiting
775 static bool io_wq_for_each_worker(struct io_wqe *wqe,
776 bool (*func)(struct io_worker *, void *),
779 struct io_worker *worker;
782 list_for_each_entry_rcu(worker, &wqe->all_list, all_list) {
783 if (io_worker_get(worker)) {
784 /* no task if node is/was offline */
786 ret = func(worker, data);
787 io_worker_release(worker);
796 static bool io_wq_worker_wake(struct io_worker *worker, void *data)
798 set_notify_signal(worker->task);
799 wake_up_process(worker->task);
803 static void io_run_cancel(struct io_wq_work *work, struct io_wqe *wqe)
805 struct io_wq *wq = wqe->wq;
808 work->flags |= IO_WQ_WORK_CANCEL;
810 work = wq->free_work(work);
814 static void io_wqe_insert_work(struct io_wqe *wqe, struct io_wq_work *work)
816 struct io_wqe_acct *acct = io_work_get_acct(wqe, work);
818 struct io_wq_work *tail;
820 if (!io_wq_is_hashed(work)) {
822 wq_list_add_tail(&work->list, &acct->work_list);
826 hash = io_get_work_hash(work);
827 tail = wqe->hash_tail[hash];
828 wqe->hash_tail[hash] = work;
832 wq_list_add_after(&work->list, &tail->list, &acct->work_list);
835 static void io_wqe_enqueue(struct io_wqe *wqe, struct io_wq_work *work)
837 struct io_wqe_acct *acct = io_work_get_acct(wqe, work);
838 unsigned work_flags = work->flags;
842 * If io-wq is exiting for this task, or if the request has explicitly
843 * been marked as one that should not get executed, cancel it here.
845 if (test_bit(IO_WQ_BIT_EXIT, &wqe->wq->state) ||
846 (work->flags & IO_WQ_WORK_CANCEL)) {
848 io_run_cancel(work, wqe);
852 raw_spin_lock(&wqe->lock);
853 io_wqe_insert_work(wqe, work);
854 clear_bit(IO_ACCT_STALLED_BIT, &acct->flags);
857 do_create = !io_wqe_activate_free_worker(wqe, acct);
860 raw_spin_unlock(&wqe->lock);
862 if (do_create && ((work_flags & IO_WQ_WORK_CONCURRENT) ||
863 !atomic_read(&acct->nr_running))) {
866 did_create = io_wqe_create_worker(wqe, acct);
867 if (unlikely(!did_create)) {
868 raw_spin_lock(&wqe->lock);
869 /* fatal condition, failed to create the first worker */
870 if (!acct->nr_workers) {
871 raw_spin_unlock(&wqe->lock);
874 raw_spin_unlock(&wqe->lock);
879 void io_wq_enqueue(struct io_wq *wq, struct io_wq_work *work)
881 struct io_wqe *wqe = wq->wqes[numa_node_id()];
883 io_wqe_enqueue(wqe, work);
887 * Work items that hash to the same value will not be done in parallel.
888 * Used to limit concurrent writes, generally hashed by inode.
890 void io_wq_hash_work(struct io_wq_work *work, void *val)
894 bit = hash_ptr(val, IO_WQ_HASH_ORDER);
895 work->flags |= (IO_WQ_WORK_HASHED | (bit << IO_WQ_HASH_SHIFT));
898 static bool io_wq_worker_cancel(struct io_worker *worker, void *data)
900 struct io_cb_cancel_data *match = data;
903 * Hold the lock to avoid ->cur_work going out of scope, caller
904 * may dereference the passed in work.
906 spin_lock(&worker->lock);
907 if (worker->cur_work &&
908 match->fn(worker->cur_work, match->data)) {
909 set_notify_signal(worker->task);
912 spin_unlock(&worker->lock);
914 return match->nr_running && !match->cancel_all;
917 static inline void io_wqe_remove_pending(struct io_wqe *wqe,
918 struct io_wq_work *work,
919 struct io_wq_work_node *prev)
921 struct io_wqe_acct *acct = io_work_get_acct(wqe, work);
922 unsigned int hash = io_get_work_hash(work);
923 struct io_wq_work *prev_work = NULL;
925 if (io_wq_is_hashed(work) && work == wqe->hash_tail[hash]) {
927 prev_work = container_of(prev, struct io_wq_work, list);
928 if (prev_work && io_get_work_hash(prev_work) == hash)
929 wqe->hash_tail[hash] = prev_work;
931 wqe->hash_tail[hash] = NULL;
933 wq_list_del(&acct->work_list, &work->list, prev);
936 static bool io_acct_cancel_pending_work(struct io_wqe *wqe,
937 struct io_wqe_acct *acct,
938 struct io_cb_cancel_data *match)
939 __releases(wqe->lock)
941 struct io_wq_work_node *node, *prev;
942 struct io_wq_work *work;
944 wq_list_for_each(node, prev, &acct->work_list) {
945 work = container_of(node, struct io_wq_work, list);
946 if (!match->fn(work, match->data))
948 io_wqe_remove_pending(wqe, work, prev);
949 raw_spin_unlock(&wqe->lock);
950 io_run_cancel(work, wqe);
952 /* not safe to continue after unlock */
959 static void io_wqe_cancel_pending_work(struct io_wqe *wqe,
960 struct io_cb_cancel_data *match)
964 raw_spin_lock(&wqe->lock);
965 for (i = 0; i < IO_WQ_ACCT_NR; i++) {
966 struct io_wqe_acct *acct = io_get_acct(wqe, i == 0);
968 if (io_acct_cancel_pending_work(wqe, acct, match)) {
969 if (match->cancel_all)
974 raw_spin_unlock(&wqe->lock);
977 static void io_wqe_cancel_running_work(struct io_wqe *wqe,
978 struct io_cb_cancel_data *match)
981 io_wq_for_each_worker(wqe, io_wq_worker_cancel, match);
985 enum io_wq_cancel io_wq_cancel_cb(struct io_wq *wq, work_cancel_fn *cancel,
986 void *data, bool cancel_all)
988 struct io_cb_cancel_data match = {
991 .cancel_all = cancel_all,
996 * First check pending list, if we're lucky we can just remove it
997 * from there. CANCEL_OK means that the work is returned as-new,
998 * no completion will be posted for it.
1000 for_each_node(node) {
1001 struct io_wqe *wqe = wq->wqes[node];
1003 io_wqe_cancel_pending_work(wqe, &match);
1004 if (match.nr_pending && !match.cancel_all)
1005 return IO_WQ_CANCEL_OK;
1009 * Now check if a free (going busy) or busy worker has the work
1010 * currently running. If we find it there, we'll return CANCEL_RUNNING
1011 * as an indication that we attempt to signal cancellation. The
1012 * completion will run normally in this case.
1014 for_each_node(node) {
1015 struct io_wqe *wqe = wq->wqes[node];
1017 io_wqe_cancel_running_work(wqe, &match);
1018 if (match.nr_running && !match.cancel_all)
1019 return IO_WQ_CANCEL_RUNNING;
1022 if (match.nr_running)
1023 return IO_WQ_CANCEL_RUNNING;
1024 if (match.nr_pending)
1025 return IO_WQ_CANCEL_OK;
1026 return IO_WQ_CANCEL_NOTFOUND;
1029 static int io_wqe_hash_wake(struct wait_queue_entry *wait, unsigned mode,
1030 int sync, void *key)
1032 struct io_wqe *wqe = container_of(wait, struct io_wqe, wait);
1035 list_del_init(&wait->entry);
1038 for (i = 0; i < IO_WQ_ACCT_NR; i++) {
1039 struct io_wqe_acct *acct = &wqe->acct[i];
1041 if (test_and_clear_bit(IO_ACCT_STALLED_BIT, &acct->flags))
1042 io_wqe_activate_free_worker(wqe, acct);
1048 struct io_wq *io_wq_create(unsigned bounded, struct io_wq_data *data)
1053 if (WARN_ON_ONCE(!data->free_work || !data->do_work))
1054 return ERR_PTR(-EINVAL);
1055 if (WARN_ON_ONCE(!bounded))
1056 return ERR_PTR(-EINVAL);
1058 wq = kzalloc(struct_size(wq, wqes, nr_node_ids), GFP_KERNEL);
1060 return ERR_PTR(-ENOMEM);
1061 ret = cpuhp_state_add_instance_nocalls(io_wq_online, &wq->cpuhp_node);
1065 refcount_inc(&data->hash->refs);
1066 wq->hash = data->hash;
1067 wq->free_work = data->free_work;
1068 wq->do_work = data->do_work;
1071 for_each_node(node) {
1073 int alloc_node = node;
1075 if (!node_online(alloc_node))
1076 alloc_node = NUMA_NO_NODE;
1077 wqe = kzalloc_node(sizeof(struct io_wqe), GFP_KERNEL, alloc_node);
1080 if (!alloc_cpumask_var(&wqe->cpu_mask, GFP_KERNEL))
1082 cpumask_copy(wqe->cpu_mask, cpumask_of_node(node));
1083 wq->wqes[node] = wqe;
1084 wqe->node = alloc_node;
1085 wqe->acct[IO_WQ_ACCT_BOUND].max_workers = bounded;
1086 wqe->acct[IO_WQ_ACCT_UNBOUND].max_workers =
1087 task_rlimit(current, RLIMIT_NPROC);
1088 INIT_LIST_HEAD(&wqe->wait.entry);
1089 wqe->wait.func = io_wqe_hash_wake;
1090 for (i = 0; i < IO_WQ_ACCT_NR; i++) {
1091 struct io_wqe_acct *acct = &wqe->acct[i];
1094 atomic_set(&acct->nr_running, 0);
1095 INIT_WQ_LIST(&acct->work_list);
1098 raw_spin_lock_init(&wqe->lock);
1099 INIT_HLIST_NULLS_HEAD(&wqe->free_list, 0);
1100 INIT_LIST_HEAD(&wqe->all_list);
1103 wq->task = get_task_struct(data->task);
1104 atomic_set(&wq->worker_refs, 1);
1105 init_completion(&wq->worker_done);
1108 io_wq_put_hash(data->hash);
1109 cpuhp_state_remove_instance_nocalls(io_wq_online, &wq->cpuhp_node);
1110 for_each_node(node) {
1111 if (!wq->wqes[node])
1113 free_cpumask_var(wq->wqes[node]->cpu_mask);
1114 kfree(wq->wqes[node]);
1118 return ERR_PTR(ret);
1121 static bool io_task_work_match(struct callback_head *cb, void *data)
1123 struct io_worker *worker;
1125 if (cb->func != create_worker_cb || cb->func != create_worker_cont)
1127 worker = container_of(cb, struct io_worker, create_work);
1128 return worker->wqe->wq == data;
1131 void io_wq_exit_start(struct io_wq *wq)
1133 set_bit(IO_WQ_BIT_EXIT, &wq->state);
1136 static void io_wq_exit_workers(struct io_wq *wq)
1138 struct callback_head *cb;
1144 while ((cb = task_work_cancel_match(wq->task, io_task_work_match, wq)) != NULL) {
1145 struct io_worker *worker;
1147 worker = container_of(cb, struct io_worker, create_work);
1148 atomic_dec(&worker->wqe->acct[worker->create_index].nr_running);
1149 io_worker_ref_put(wq);
1150 clear_bit_unlock(0, &worker->create_state);
1151 io_worker_release(worker);
1155 for_each_node(node) {
1156 struct io_wqe *wqe = wq->wqes[node];
1158 io_wq_for_each_worker(wqe, io_wq_worker_wake, NULL);
1161 io_worker_ref_put(wq);
1162 wait_for_completion(&wq->worker_done);
1164 for_each_node(node) {
1165 spin_lock_irq(&wq->hash->wait.lock);
1166 list_del_init(&wq->wqes[node]->wait.entry);
1167 spin_unlock_irq(&wq->hash->wait.lock);
1169 put_task_struct(wq->task);
1173 static void io_wq_destroy(struct io_wq *wq)
1177 cpuhp_state_remove_instance_nocalls(io_wq_online, &wq->cpuhp_node);
1179 for_each_node(node) {
1180 struct io_wqe *wqe = wq->wqes[node];
1181 struct io_cb_cancel_data match = {
1182 .fn = io_wq_work_match_all,
1185 io_wqe_cancel_pending_work(wqe, &match);
1186 free_cpumask_var(wqe->cpu_mask);
1189 io_wq_put_hash(wq->hash);
1193 void io_wq_put_and_exit(struct io_wq *wq)
1195 WARN_ON_ONCE(!test_bit(IO_WQ_BIT_EXIT, &wq->state));
1197 io_wq_exit_workers(wq);
1201 struct online_data {
1206 static bool io_wq_worker_affinity(struct io_worker *worker, void *data)
1208 struct online_data *od = data;
1211 cpumask_set_cpu(od->cpu, worker->wqe->cpu_mask);
1213 cpumask_clear_cpu(od->cpu, worker->wqe->cpu_mask);
1217 static int __io_wq_cpu_online(struct io_wq *wq, unsigned int cpu, bool online)
1219 struct online_data od = {
1227 io_wq_for_each_worker(wq->wqes[i], io_wq_worker_affinity, &od);
1232 static int io_wq_cpu_online(unsigned int cpu, struct hlist_node *node)
1234 struct io_wq *wq = hlist_entry_safe(node, struct io_wq, cpuhp_node);
1236 return __io_wq_cpu_online(wq, cpu, true);
1239 static int io_wq_cpu_offline(unsigned int cpu, struct hlist_node *node)
1241 struct io_wq *wq = hlist_entry_safe(node, struct io_wq, cpuhp_node);
1243 return __io_wq_cpu_online(wq, cpu, false);
1246 int io_wq_cpu_affinity(struct io_wq *wq, cpumask_var_t mask)
1252 struct io_wqe *wqe = wq->wqes[i];
1255 cpumask_copy(wqe->cpu_mask, mask);
1257 cpumask_copy(wqe->cpu_mask, cpumask_of_node(i));
1264 * Set max number of unbounded workers, returns old value. If new_count is 0,
1265 * then just return the old value.
1267 int io_wq_max_workers(struct io_wq *wq, int *new_count)
1269 int i, node, prev = 0;
1271 for (i = 0; i < 2; i++) {
1272 if (new_count[i] > task_rlimit(current, RLIMIT_NPROC))
1273 new_count[i] = task_rlimit(current, RLIMIT_NPROC);
1277 for_each_node(node) {
1278 struct io_wqe_acct *acct;
1280 for (i = 0; i < IO_WQ_ACCT_NR; i++) {
1281 acct = &wq->wqes[node]->acct[i];
1282 prev = max_t(int, acct->max_workers, prev);
1284 acct->max_workers = new_count[i];
1285 new_count[i] = prev;
1292 static __init int io_wq_init(void)
1296 ret = cpuhp_setup_state_multi(CPUHP_AP_ONLINE_DYN, "io-wq/online",
1297 io_wq_cpu_online, io_wq_cpu_offline);
1303 subsys_initcall(io_wq_init);