1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Basic worker thread pool for io_uring 4 * 5 * Copyright (C) 2019 Jens Axboe 6 * 7 */ 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/task_work.h> 17 #include <linux/audit.h> 18 #include <linux/mmu_context.h> 19 #include <uapi/linux/io_uring.h> 20 21 #include "io-wq.h" 22 #include "slist.h" 23 #include "io_uring.h" 24 25 #define WORKER_IDLE_TIMEOUT (5 * HZ) 26 27 enum { 28 IO_WORKER_F_UP = 1, /* up and active */ 29 IO_WORKER_F_RUNNING = 2, /* account as running */ 30 IO_WORKER_F_FREE = 4, /* worker on free list */ 31 IO_WORKER_F_BOUND = 8, /* is doing bounded work */ 32 }; 33 34 enum { 35 IO_WQ_BIT_EXIT = 0, /* wq exiting */ 36 }; 37 38 enum { 39 IO_ACCT_STALLED_BIT = 0, /* stalled on hash */ 40 }; 41 42 /* 43 * One for each thread in a wq pool 44 */ 45 struct io_worker { 46 refcount_t ref; 47 unsigned flags; 48 struct hlist_nulls_node nulls_node; 49 struct list_head all_list; 50 struct task_struct *task; 51 struct io_wq *wq; 52 53 struct io_wq_work *cur_work; 54 struct io_wq_work *next_work; 55 raw_spinlock_t lock; 56 57 struct completion ref_done; 58 59 unsigned long create_state; 60 struct callback_head create_work; 61 int create_index; 62 63 union { 64 struct rcu_head rcu; 65 struct work_struct work; 66 }; 67 }; 68 69 #if BITS_PER_LONG == 64 70 #define IO_WQ_HASH_ORDER 6 71 #else 72 #define IO_WQ_HASH_ORDER 5 73 #endif 74 75 #define IO_WQ_NR_HASH_BUCKETS (1u << IO_WQ_HASH_ORDER) 76 77 struct io_wq_acct { 78 unsigned nr_workers; 79 unsigned max_workers; 80 int index; 81 atomic_t nr_running; 82 raw_spinlock_t lock; 83 struct io_wq_work_list work_list; 84 unsigned long flags; 85 }; 86 87 enum { 88 IO_WQ_ACCT_BOUND, 89 IO_WQ_ACCT_UNBOUND, 90 IO_WQ_ACCT_NR, 91 }; 92 93 /* 94 * Per io_wq state 95 */ 96 struct io_wq { 97 unsigned long state; 98 99 free_work_fn *free_work; 100 io_wq_work_fn *do_work; 101 102 struct io_wq_hash *hash; 103 104 atomic_t worker_refs; 105 struct completion worker_done; 106 107 struct hlist_node cpuhp_node; 108 109 struct task_struct *task; 110 111 struct io_wq_acct acct[IO_WQ_ACCT_NR]; 112 113 /* lock protects access to elements below */ 114 raw_spinlock_t lock; 115 116 struct hlist_nulls_head free_list; 117 struct list_head all_list; 118 119 struct wait_queue_entry wait; 120 121 struct io_wq_work *hash_tail[IO_WQ_NR_HASH_BUCKETS]; 122 123 cpumask_var_t cpu_mask; 124 }; 125 126 static enum cpuhp_state io_wq_online; 127 128 struct io_cb_cancel_data { 129 work_cancel_fn *fn; 130 void *data; 131 int nr_running; 132 int nr_pending; 133 bool cancel_all; 134 }; 135 136 static bool create_io_worker(struct io_wq *wq, int index); 137 static void io_wq_dec_running(struct io_worker *worker); 138 static bool io_acct_cancel_pending_work(struct io_wq *wq, 139 struct io_wq_acct *acct, 140 struct io_cb_cancel_data *match); 141 static void create_worker_cb(struct callback_head *cb); 142 static void io_wq_cancel_tw_create(struct io_wq *wq); 143 144 static bool io_worker_get(struct io_worker *worker) 145 { 146 return refcount_inc_not_zero(&worker->ref); 147 } 148 149 static void io_worker_release(struct io_worker *worker) 150 { 151 if (refcount_dec_and_test(&worker->ref)) 152 complete(&worker->ref_done); 153 } 154 155 static inline struct io_wq_acct *io_get_acct(struct io_wq *wq, bool bound) 156 { 157 return &wq->acct[bound ? IO_WQ_ACCT_BOUND : IO_WQ_ACCT_UNBOUND]; 158 } 159 160 static inline struct io_wq_acct *io_work_get_acct(struct io_wq *wq, 161 struct io_wq_work *work) 162 { 163 return io_get_acct(wq, !(work->flags & IO_WQ_WORK_UNBOUND)); 164 } 165 166 static inline struct io_wq_acct *io_wq_get_acct(struct io_worker *worker) 167 { 168 return io_get_acct(worker->wq, worker->flags & IO_WORKER_F_BOUND); 169 } 170 171 static void io_worker_ref_put(struct io_wq *wq) 172 { 173 if (atomic_dec_and_test(&wq->worker_refs)) 174 complete(&wq->worker_done); 175 } 176 177 bool io_wq_worker_stopped(void) 178 { 179 struct io_worker *worker = current->worker_private; 180 181 if (WARN_ON_ONCE(!io_wq_current_is_worker())) 182 return true; 183 184 return test_bit(IO_WQ_BIT_EXIT, &worker->wq->state); 185 } 186 187 static void io_worker_cancel_cb(struct io_worker *worker) 188 { 189 struct io_wq_acct *acct = io_wq_get_acct(worker); 190 struct io_wq *wq = worker->wq; 191 192 atomic_dec(&acct->nr_running); 193 raw_spin_lock(&wq->lock); 194 acct->nr_workers--; 195 raw_spin_unlock(&wq->lock); 196 io_worker_ref_put(wq); 197 clear_bit_unlock(0, &worker->create_state); 198 io_worker_release(worker); 199 } 200 201 static bool io_task_worker_match(struct callback_head *cb, void *data) 202 { 203 struct io_worker *worker; 204 205 if (cb->func != create_worker_cb) 206 return false; 207 worker = container_of(cb, struct io_worker, create_work); 208 return worker == data; 209 } 210 211 static void io_worker_exit(struct io_worker *worker) 212 { 213 struct io_wq *wq = worker->wq; 214 215 while (1) { 216 struct callback_head *cb = task_work_cancel_match(wq->task, 217 io_task_worker_match, worker); 218 219 if (!cb) 220 break; 221 io_worker_cancel_cb(worker); 222 } 223 224 io_worker_release(worker); 225 wait_for_completion(&worker->ref_done); 226 227 raw_spin_lock(&wq->lock); 228 if (worker->flags & IO_WORKER_F_FREE) 229 hlist_nulls_del_rcu(&worker->nulls_node); 230 list_del_rcu(&worker->all_list); 231 raw_spin_unlock(&wq->lock); 232 io_wq_dec_running(worker); 233 /* 234 * this worker is a goner, clear ->worker_private to avoid any 235 * inc/dec running calls that could happen as part of exit from 236 * touching 'worker'. 237 */ 238 current->worker_private = NULL; 239 240 kfree_rcu(worker, rcu); 241 io_worker_ref_put(wq); 242 do_exit(0); 243 } 244 245 static inline bool __io_acct_run_queue(struct io_wq_acct *acct) 246 { 247 return !test_bit(IO_ACCT_STALLED_BIT, &acct->flags) && 248 !wq_list_empty(&acct->work_list); 249 } 250 251 /* 252 * If there's work to do, returns true with acct->lock acquired. If not, 253 * returns false with no lock held. 254 */ 255 static inline bool io_acct_run_queue(struct io_wq_acct *acct) 256 __acquires(&acct->lock) 257 { 258 raw_spin_lock(&acct->lock); 259 if (__io_acct_run_queue(acct)) 260 return true; 261 262 raw_spin_unlock(&acct->lock); 263 return false; 264 } 265 266 /* 267 * Check head of free list for an available worker. If one isn't available, 268 * caller must create one. 269 */ 270 static bool io_wq_activate_free_worker(struct io_wq *wq, 271 struct io_wq_acct *acct) 272 __must_hold(RCU) 273 { 274 struct hlist_nulls_node *n; 275 struct io_worker *worker; 276 277 /* 278 * Iterate free_list and see if we can find an idle worker to 279 * activate. If a given worker is on the free_list but in the process 280 * of exiting, keep trying. 281 */ 282 hlist_nulls_for_each_entry_rcu(worker, n, &wq->free_list, nulls_node) { 283 if (!io_worker_get(worker)) 284 continue; 285 if (io_wq_get_acct(worker) != acct) { 286 io_worker_release(worker); 287 continue; 288 } 289 /* 290 * If the worker is already running, it's either already 291 * starting work or finishing work. In either case, if it does 292 * to go sleep, we'll kick off a new task for this work anyway. 293 */ 294 wake_up_process(worker->task); 295 io_worker_release(worker); 296 return true; 297 } 298 299 return false; 300 } 301 302 /* 303 * We need a worker. If we find a free one, we're good. If not, and we're 304 * below the max number of workers, create one. 305 */ 306 static bool io_wq_create_worker(struct io_wq *wq, struct io_wq_acct *acct) 307 { 308 /* 309 * Most likely an attempt to queue unbounded work on an io_wq that 310 * wasn't setup with any unbounded workers. 311 */ 312 if (unlikely(!acct->max_workers)) 313 pr_warn_once("io-wq is not configured for unbound workers"); 314 315 raw_spin_lock(&wq->lock); 316 if (acct->nr_workers >= acct->max_workers) { 317 raw_spin_unlock(&wq->lock); 318 return true; 319 } 320 acct->nr_workers++; 321 raw_spin_unlock(&wq->lock); 322 atomic_inc(&acct->nr_running); 323 atomic_inc(&wq->worker_refs); 324 return create_io_worker(wq, acct->index); 325 } 326 327 static void io_wq_inc_running(struct io_worker *worker) 328 { 329 struct io_wq_acct *acct = io_wq_get_acct(worker); 330 331 atomic_inc(&acct->nr_running); 332 } 333 334 static void create_worker_cb(struct callback_head *cb) 335 { 336 struct io_worker *worker; 337 struct io_wq *wq; 338 339 struct io_wq_acct *acct; 340 bool do_create = false; 341 342 worker = container_of(cb, struct io_worker, create_work); 343 wq = worker->wq; 344 acct = &wq->acct[worker->create_index]; 345 raw_spin_lock(&wq->lock); 346 347 if (acct->nr_workers < acct->max_workers) { 348 acct->nr_workers++; 349 do_create = true; 350 } 351 raw_spin_unlock(&wq->lock); 352 if (do_create) { 353 create_io_worker(wq, worker->create_index); 354 } else { 355 atomic_dec(&acct->nr_running); 356 io_worker_ref_put(wq); 357 } 358 clear_bit_unlock(0, &worker->create_state); 359 io_worker_release(worker); 360 } 361 362 static bool io_queue_worker_create(struct io_worker *worker, 363 struct io_wq_acct *acct, 364 task_work_func_t func) 365 { 366 struct io_wq *wq = worker->wq; 367 368 /* raced with exit, just ignore create call */ 369 if (test_bit(IO_WQ_BIT_EXIT, &wq->state)) 370 goto fail; 371 if (!io_worker_get(worker)) 372 goto fail; 373 /* 374 * create_state manages ownership of create_work/index. We should 375 * only need one entry per worker, as the worker going to sleep 376 * will trigger the condition, and waking will clear it once it 377 * runs the task_work. 378 */ 379 if (test_bit(0, &worker->create_state) || 380 test_and_set_bit_lock(0, &worker->create_state)) 381 goto fail_release; 382 383 atomic_inc(&wq->worker_refs); 384 init_task_work(&worker->create_work, func); 385 worker->create_index = acct->index; 386 if (!task_work_add(wq->task, &worker->create_work, TWA_SIGNAL)) { 387 /* 388 * EXIT may have been set after checking it above, check after 389 * adding the task_work and remove any creation item if it is 390 * now set. wq exit does that too, but we can have added this 391 * work item after we canceled in io_wq_exit_workers(). 392 */ 393 if (test_bit(IO_WQ_BIT_EXIT, &wq->state)) 394 io_wq_cancel_tw_create(wq); 395 io_worker_ref_put(wq); 396 return true; 397 } 398 io_worker_ref_put(wq); 399 clear_bit_unlock(0, &worker->create_state); 400 fail_release: 401 io_worker_release(worker); 402 fail: 403 atomic_dec(&acct->nr_running); 404 io_worker_ref_put(wq); 405 return false; 406 } 407 408 static void io_wq_dec_running(struct io_worker *worker) 409 { 410 struct io_wq_acct *acct = io_wq_get_acct(worker); 411 struct io_wq *wq = worker->wq; 412 413 if (!(worker->flags & IO_WORKER_F_UP)) 414 return; 415 416 if (!atomic_dec_and_test(&acct->nr_running)) 417 return; 418 if (!io_acct_run_queue(acct)) 419 return; 420 421 raw_spin_unlock(&acct->lock); 422 atomic_inc(&acct->nr_running); 423 atomic_inc(&wq->worker_refs); 424 io_queue_worker_create(worker, acct, create_worker_cb); 425 } 426 427 /* 428 * Worker will start processing some work. Move it to the busy list, if 429 * it's currently on the freelist 430 */ 431 static void __io_worker_busy(struct io_wq *wq, struct io_worker *worker) 432 { 433 if (worker->flags & IO_WORKER_F_FREE) { 434 worker->flags &= ~IO_WORKER_F_FREE; 435 raw_spin_lock(&wq->lock); 436 hlist_nulls_del_init_rcu(&worker->nulls_node); 437 raw_spin_unlock(&wq->lock); 438 } 439 } 440 441 /* 442 * No work, worker going to sleep. Move to freelist. 443 */ 444 static void __io_worker_idle(struct io_wq *wq, struct io_worker *worker) 445 __must_hold(wq->lock) 446 { 447 if (!(worker->flags & IO_WORKER_F_FREE)) { 448 worker->flags |= IO_WORKER_F_FREE; 449 hlist_nulls_add_head_rcu(&worker->nulls_node, &wq->free_list); 450 } 451 } 452 453 static inline unsigned int io_get_work_hash(struct io_wq_work *work) 454 { 455 return work->flags >> IO_WQ_HASH_SHIFT; 456 } 457 458 static bool io_wait_on_hash(struct io_wq *wq, unsigned int hash) 459 { 460 bool ret = false; 461 462 spin_lock_irq(&wq->hash->wait.lock); 463 if (list_empty(&wq->wait.entry)) { 464 __add_wait_queue(&wq->hash->wait, &wq->wait); 465 if (!test_bit(hash, &wq->hash->map)) { 466 __set_current_state(TASK_RUNNING); 467 list_del_init(&wq->wait.entry); 468 ret = true; 469 } 470 } 471 spin_unlock_irq(&wq->hash->wait.lock); 472 return ret; 473 } 474 475 static struct io_wq_work *io_get_next_work(struct io_wq_acct *acct, 476 struct io_worker *worker) 477 __must_hold(acct->lock) 478 { 479 struct io_wq_work_node *node, *prev; 480 struct io_wq_work *work, *tail; 481 unsigned int stall_hash = -1U; 482 struct io_wq *wq = worker->wq; 483 484 wq_list_for_each(node, prev, &acct->work_list) { 485 unsigned int hash; 486 487 work = container_of(node, struct io_wq_work, list); 488 489 /* not hashed, can run anytime */ 490 if (!io_wq_is_hashed(work)) { 491 wq_list_del(&acct->work_list, node, prev); 492 return work; 493 } 494 495 hash = io_get_work_hash(work); 496 /* all items with this hash lie in [work, tail] */ 497 tail = wq->hash_tail[hash]; 498 499 /* hashed, can run if not already running */ 500 if (!test_and_set_bit(hash, &wq->hash->map)) { 501 wq->hash_tail[hash] = NULL; 502 wq_list_cut(&acct->work_list, &tail->list, prev); 503 return work; 504 } 505 if (stall_hash == -1U) 506 stall_hash = hash; 507 /* fast forward to a next hash, for-each will fix up @prev */ 508 node = &tail->list; 509 } 510 511 if (stall_hash != -1U) { 512 bool unstalled; 513 514 /* 515 * Set this before dropping the lock to avoid racing with new 516 * work being added and clearing the stalled bit. 517 */ 518 set_bit(IO_ACCT_STALLED_BIT, &acct->flags); 519 raw_spin_unlock(&acct->lock); 520 unstalled = io_wait_on_hash(wq, stall_hash); 521 raw_spin_lock(&acct->lock); 522 if (unstalled) { 523 clear_bit(IO_ACCT_STALLED_BIT, &acct->flags); 524 if (wq_has_sleeper(&wq->hash->wait)) 525 wake_up(&wq->hash->wait); 526 } 527 } 528 529 return NULL; 530 } 531 532 static void io_assign_current_work(struct io_worker *worker, 533 struct io_wq_work *work) 534 { 535 if (work) { 536 io_run_task_work(); 537 cond_resched(); 538 } 539 540 raw_spin_lock(&worker->lock); 541 worker->cur_work = work; 542 worker->next_work = NULL; 543 raw_spin_unlock(&worker->lock); 544 } 545 546 /* 547 * Called with acct->lock held, drops it before returning 548 */ 549 static void io_worker_handle_work(struct io_wq_acct *acct, 550 struct io_worker *worker) 551 __releases(&acct->lock) 552 { 553 struct io_wq *wq = worker->wq; 554 bool do_kill = test_bit(IO_WQ_BIT_EXIT, &wq->state); 555 556 do { 557 struct io_wq_work *work; 558 559 /* 560 * If we got some work, mark us as busy. If we didn't, but 561 * the list isn't empty, it means we stalled on hashed work. 562 * Mark us stalled so we don't keep looking for work when we 563 * can't make progress, any work completion or insertion will 564 * clear the stalled flag. 565 */ 566 work = io_get_next_work(acct, worker); 567 if (work) { 568 /* 569 * Make sure cancelation can find this, even before 570 * it becomes the active work. That avoids a window 571 * where the work has been removed from our general 572 * work list, but isn't yet discoverable as the 573 * current work item for this worker. 574 */ 575 raw_spin_lock(&worker->lock); 576 worker->next_work = work; 577 raw_spin_unlock(&worker->lock); 578 } 579 580 raw_spin_unlock(&acct->lock); 581 582 if (!work) 583 break; 584 585 __io_worker_busy(wq, worker); 586 587 io_assign_current_work(worker, work); 588 __set_current_state(TASK_RUNNING); 589 590 /* handle a whole dependent link */ 591 do { 592 struct io_wq_work *next_hashed, *linked; 593 unsigned int hash = io_get_work_hash(work); 594 595 next_hashed = wq_next_work(work); 596 597 if (unlikely(do_kill) && (work->flags & IO_WQ_WORK_UNBOUND)) 598 work->flags |= IO_WQ_WORK_CANCEL; 599 wq->do_work(work); 600 io_assign_current_work(worker, NULL); 601 602 linked = wq->free_work(work); 603 work = next_hashed; 604 if (!work && linked && !io_wq_is_hashed(linked)) { 605 work = linked; 606 linked = NULL; 607 } 608 io_assign_current_work(worker, work); 609 if (linked) 610 io_wq_enqueue(wq, linked); 611 612 if (hash != -1U && !next_hashed) { 613 /* serialize hash clear with wake_up() */ 614 spin_lock_irq(&wq->hash->wait.lock); 615 clear_bit(hash, &wq->hash->map); 616 clear_bit(IO_ACCT_STALLED_BIT, &acct->flags); 617 spin_unlock_irq(&wq->hash->wait.lock); 618 if (wq_has_sleeper(&wq->hash->wait)) 619 wake_up(&wq->hash->wait); 620 } 621 } while (work); 622 623 if (!__io_acct_run_queue(acct)) 624 break; 625 raw_spin_lock(&acct->lock); 626 } while (1); 627 } 628 629 static int io_wq_worker(void *data) 630 { 631 struct io_worker *worker = data; 632 struct io_wq_acct *acct = io_wq_get_acct(worker); 633 struct io_wq *wq = worker->wq; 634 bool exit_mask = false, last_timeout = false; 635 char buf[TASK_COMM_LEN]; 636 637 worker->flags |= (IO_WORKER_F_UP | IO_WORKER_F_RUNNING); 638 639 snprintf(buf, sizeof(buf), "iou-wrk-%d", wq->task->pid); 640 set_task_comm(current, buf); 641 642 while (!test_bit(IO_WQ_BIT_EXIT, &wq->state)) { 643 long ret; 644 645 set_current_state(TASK_INTERRUPTIBLE); 646 647 /* 648 * If we have work to do, io_acct_run_queue() returns with 649 * the acct->lock held. If not, it will drop it. 650 */ 651 while (io_acct_run_queue(acct)) 652 io_worker_handle_work(acct, worker); 653 654 raw_spin_lock(&wq->lock); 655 /* 656 * Last sleep timed out. Exit if we're not the last worker, 657 * or if someone modified our affinity. 658 */ 659 if (last_timeout && (exit_mask || acct->nr_workers > 1)) { 660 acct->nr_workers--; 661 raw_spin_unlock(&wq->lock); 662 __set_current_state(TASK_RUNNING); 663 break; 664 } 665 last_timeout = false; 666 __io_worker_idle(wq, worker); 667 raw_spin_unlock(&wq->lock); 668 if (io_run_task_work()) 669 continue; 670 ret = schedule_timeout(WORKER_IDLE_TIMEOUT); 671 if (signal_pending(current)) { 672 struct ksignal ksig; 673 674 if (!get_signal(&ksig)) 675 continue; 676 break; 677 } 678 if (!ret) { 679 last_timeout = true; 680 exit_mask = !cpumask_test_cpu(raw_smp_processor_id(), 681 wq->cpu_mask); 682 } 683 } 684 685 if (test_bit(IO_WQ_BIT_EXIT, &wq->state) && io_acct_run_queue(acct)) 686 io_worker_handle_work(acct, worker); 687 688 io_worker_exit(worker); 689 return 0; 690 } 691 692 /* 693 * Called when a worker is scheduled in. Mark us as currently running. 694 */ 695 void io_wq_worker_running(struct task_struct *tsk) 696 { 697 struct io_worker *worker = tsk->worker_private; 698 699 if (!worker) 700 return; 701 if (!(worker->flags & IO_WORKER_F_UP)) 702 return; 703 if (worker->flags & IO_WORKER_F_RUNNING) 704 return; 705 worker->flags |= IO_WORKER_F_RUNNING; 706 io_wq_inc_running(worker); 707 } 708 709 /* 710 * Called when worker is going to sleep. If there are no workers currently 711 * running and we have work pending, wake up a free one or create a new one. 712 */ 713 void io_wq_worker_sleeping(struct task_struct *tsk) 714 { 715 struct io_worker *worker = tsk->worker_private; 716 717 if (!worker) 718 return; 719 if (!(worker->flags & IO_WORKER_F_UP)) 720 return; 721 if (!(worker->flags & IO_WORKER_F_RUNNING)) 722 return; 723 724 worker->flags &= ~IO_WORKER_F_RUNNING; 725 io_wq_dec_running(worker); 726 } 727 728 static void io_init_new_worker(struct io_wq *wq, struct io_worker *worker, 729 struct task_struct *tsk) 730 { 731 tsk->worker_private = worker; 732 worker->task = tsk; 733 set_cpus_allowed_ptr(tsk, wq->cpu_mask); 734 735 raw_spin_lock(&wq->lock); 736 hlist_nulls_add_head_rcu(&worker->nulls_node, &wq->free_list); 737 list_add_tail_rcu(&worker->all_list, &wq->all_list); 738 worker->flags |= IO_WORKER_F_FREE; 739 raw_spin_unlock(&wq->lock); 740 wake_up_new_task(tsk); 741 } 742 743 static bool io_wq_work_match_all(struct io_wq_work *work, void *data) 744 { 745 return true; 746 } 747 748 static inline bool io_should_retry_thread(long err) 749 { 750 /* 751 * Prevent perpetual task_work retry, if the task (or its group) is 752 * exiting. 753 */ 754 if (fatal_signal_pending(current)) 755 return false; 756 757 switch (err) { 758 case -EAGAIN: 759 case -ERESTARTSYS: 760 case -ERESTARTNOINTR: 761 case -ERESTARTNOHAND: 762 return true; 763 default: 764 return false; 765 } 766 } 767 768 static void create_worker_cont(struct callback_head *cb) 769 { 770 struct io_worker *worker; 771 struct task_struct *tsk; 772 struct io_wq *wq; 773 774 worker = container_of(cb, struct io_worker, create_work); 775 clear_bit_unlock(0, &worker->create_state); 776 wq = worker->wq; 777 tsk = create_io_thread(io_wq_worker, worker, NUMA_NO_NODE); 778 if (!IS_ERR(tsk)) { 779 io_init_new_worker(wq, worker, tsk); 780 io_worker_release(worker); 781 return; 782 } else if (!io_should_retry_thread(PTR_ERR(tsk))) { 783 struct io_wq_acct *acct = io_wq_get_acct(worker); 784 785 atomic_dec(&acct->nr_running); 786 raw_spin_lock(&wq->lock); 787 acct->nr_workers--; 788 if (!acct->nr_workers) { 789 struct io_cb_cancel_data match = { 790 .fn = io_wq_work_match_all, 791 .cancel_all = true, 792 }; 793 794 raw_spin_unlock(&wq->lock); 795 while (io_acct_cancel_pending_work(wq, acct, &match)) 796 ; 797 } else { 798 raw_spin_unlock(&wq->lock); 799 } 800 io_worker_ref_put(wq); 801 kfree(worker); 802 return; 803 } 804 805 /* re-create attempts grab a new worker ref, drop the existing one */ 806 io_worker_release(worker); 807 schedule_work(&worker->work); 808 } 809 810 static void io_workqueue_create(struct work_struct *work) 811 { 812 struct io_worker *worker = container_of(work, struct io_worker, work); 813 struct io_wq_acct *acct = io_wq_get_acct(worker); 814 815 if (!io_queue_worker_create(worker, acct, create_worker_cont)) 816 kfree(worker); 817 } 818 819 static bool create_io_worker(struct io_wq *wq, int index) 820 { 821 struct io_wq_acct *acct = &wq->acct[index]; 822 struct io_worker *worker; 823 struct task_struct *tsk; 824 825 __set_current_state(TASK_RUNNING); 826 827 worker = kzalloc(sizeof(*worker), GFP_KERNEL); 828 if (!worker) { 829 fail: 830 atomic_dec(&acct->nr_running); 831 raw_spin_lock(&wq->lock); 832 acct->nr_workers--; 833 raw_spin_unlock(&wq->lock); 834 io_worker_ref_put(wq); 835 return false; 836 } 837 838 refcount_set(&worker->ref, 1); 839 worker->wq = wq; 840 raw_spin_lock_init(&worker->lock); 841 init_completion(&worker->ref_done); 842 843 if (index == IO_WQ_ACCT_BOUND) 844 worker->flags |= IO_WORKER_F_BOUND; 845 846 tsk = create_io_thread(io_wq_worker, worker, NUMA_NO_NODE); 847 if (!IS_ERR(tsk)) { 848 io_init_new_worker(wq, worker, tsk); 849 } else if (!io_should_retry_thread(PTR_ERR(tsk))) { 850 kfree(worker); 851 goto fail; 852 } else { 853 INIT_WORK(&worker->work, io_workqueue_create); 854 schedule_work(&worker->work); 855 } 856 857 return true; 858 } 859 860 /* 861 * Iterate the passed in list and call the specific function for each 862 * worker that isn't exiting 863 */ 864 static bool io_wq_for_each_worker(struct io_wq *wq, 865 bool (*func)(struct io_worker *, void *), 866 void *data) 867 { 868 struct io_worker *worker; 869 bool ret = false; 870 871 list_for_each_entry_rcu(worker, &wq->all_list, all_list) { 872 if (io_worker_get(worker)) { 873 /* no task if node is/was offline */ 874 if (worker->task) 875 ret = func(worker, data); 876 io_worker_release(worker); 877 if (ret) 878 break; 879 } 880 } 881 882 return ret; 883 } 884 885 static bool io_wq_worker_wake(struct io_worker *worker, void *data) 886 { 887 __set_notify_signal(worker->task); 888 wake_up_process(worker->task); 889 return false; 890 } 891 892 static void io_run_cancel(struct io_wq_work *work, struct io_wq *wq) 893 { 894 do { 895 work->flags |= IO_WQ_WORK_CANCEL; 896 wq->do_work(work); 897 work = wq->free_work(work); 898 } while (work); 899 } 900 901 static void io_wq_insert_work(struct io_wq *wq, struct io_wq_work *work) 902 { 903 struct io_wq_acct *acct = io_work_get_acct(wq, work); 904 unsigned int hash; 905 struct io_wq_work *tail; 906 907 if (!io_wq_is_hashed(work)) { 908 append: 909 wq_list_add_tail(&work->list, &acct->work_list); 910 return; 911 } 912 913 hash = io_get_work_hash(work); 914 tail = wq->hash_tail[hash]; 915 wq->hash_tail[hash] = work; 916 if (!tail) 917 goto append; 918 919 wq_list_add_after(&work->list, &tail->list, &acct->work_list); 920 } 921 922 static bool io_wq_work_match_item(struct io_wq_work *work, void *data) 923 { 924 return work == data; 925 } 926 927 void io_wq_enqueue(struct io_wq *wq, struct io_wq_work *work) 928 { 929 struct io_wq_acct *acct = io_work_get_acct(wq, work); 930 struct io_cb_cancel_data match; 931 unsigned work_flags = work->flags; 932 bool do_create; 933 934 /* 935 * If io-wq is exiting for this task, or if the request has explicitly 936 * been marked as one that should not get executed, cancel it here. 937 */ 938 if (test_bit(IO_WQ_BIT_EXIT, &wq->state) || 939 (work->flags & IO_WQ_WORK_CANCEL)) { 940 io_run_cancel(work, wq); 941 return; 942 } 943 944 raw_spin_lock(&acct->lock); 945 io_wq_insert_work(wq, work); 946 clear_bit(IO_ACCT_STALLED_BIT, &acct->flags); 947 raw_spin_unlock(&acct->lock); 948 949 rcu_read_lock(); 950 do_create = !io_wq_activate_free_worker(wq, acct); 951 rcu_read_unlock(); 952 953 if (do_create && ((work_flags & IO_WQ_WORK_CONCURRENT) || 954 !atomic_read(&acct->nr_running))) { 955 bool did_create; 956 957 did_create = io_wq_create_worker(wq, acct); 958 if (likely(did_create)) 959 return; 960 961 raw_spin_lock(&wq->lock); 962 if (acct->nr_workers) { 963 raw_spin_unlock(&wq->lock); 964 return; 965 } 966 raw_spin_unlock(&wq->lock); 967 968 /* fatal condition, failed to create the first worker */ 969 match.fn = io_wq_work_match_item, 970 match.data = work, 971 match.cancel_all = false, 972 973 io_acct_cancel_pending_work(wq, acct, &match); 974 } 975 } 976 977 /* 978 * Work items that hash to the same value will not be done in parallel. 979 * Used to limit concurrent writes, generally hashed by inode. 980 */ 981 void io_wq_hash_work(struct io_wq_work *work, void *val) 982 { 983 unsigned int bit; 984 985 bit = hash_ptr(val, IO_WQ_HASH_ORDER); 986 work->flags |= (IO_WQ_WORK_HASHED | (bit << IO_WQ_HASH_SHIFT)); 987 } 988 989 static bool __io_wq_worker_cancel(struct io_worker *worker, 990 struct io_cb_cancel_data *match, 991 struct io_wq_work *work) 992 { 993 if (work && match->fn(work, match->data)) { 994 work->flags |= IO_WQ_WORK_CANCEL; 995 __set_notify_signal(worker->task); 996 return true; 997 } 998 999 return false; 1000 } 1001 1002 static bool io_wq_worker_cancel(struct io_worker *worker, void *data) 1003 { 1004 struct io_cb_cancel_data *match = data; 1005 1006 /* 1007 * Hold the lock to avoid ->cur_work going out of scope, caller 1008 * may dereference the passed in work. 1009 */ 1010 raw_spin_lock(&worker->lock); 1011 if (__io_wq_worker_cancel(worker, match, worker->cur_work) || 1012 __io_wq_worker_cancel(worker, match, worker->next_work)) 1013 match->nr_running++; 1014 raw_spin_unlock(&worker->lock); 1015 1016 return match->nr_running && !match->cancel_all; 1017 } 1018 1019 static inline void io_wq_remove_pending(struct io_wq *wq, 1020 struct io_wq_work *work, 1021 struct io_wq_work_node *prev) 1022 { 1023 struct io_wq_acct *acct = io_work_get_acct(wq, work); 1024 unsigned int hash = io_get_work_hash(work); 1025 struct io_wq_work *prev_work = NULL; 1026 1027 if (io_wq_is_hashed(work) && work == wq->hash_tail[hash]) { 1028 if (prev) 1029 prev_work = container_of(prev, struct io_wq_work, list); 1030 if (prev_work && io_get_work_hash(prev_work) == hash) 1031 wq->hash_tail[hash] = prev_work; 1032 else 1033 wq->hash_tail[hash] = NULL; 1034 } 1035 wq_list_del(&acct->work_list, &work->list, prev); 1036 } 1037 1038 static bool io_acct_cancel_pending_work(struct io_wq *wq, 1039 struct io_wq_acct *acct, 1040 struct io_cb_cancel_data *match) 1041 { 1042 struct io_wq_work_node *node, *prev; 1043 struct io_wq_work *work; 1044 1045 raw_spin_lock(&acct->lock); 1046 wq_list_for_each(node, prev, &acct->work_list) { 1047 work = container_of(node, struct io_wq_work, list); 1048 if (!match->fn(work, match->data)) 1049 continue; 1050 io_wq_remove_pending(wq, work, prev); 1051 raw_spin_unlock(&acct->lock); 1052 io_run_cancel(work, wq); 1053 match->nr_pending++; 1054 /* not safe to continue after unlock */ 1055 return true; 1056 } 1057 raw_spin_unlock(&acct->lock); 1058 1059 return false; 1060 } 1061 1062 static void io_wq_cancel_pending_work(struct io_wq *wq, 1063 struct io_cb_cancel_data *match) 1064 { 1065 int i; 1066 retry: 1067 for (i = 0; i < IO_WQ_ACCT_NR; i++) { 1068 struct io_wq_acct *acct = io_get_acct(wq, i == 0); 1069 1070 if (io_acct_cancel_pending_work(wq, acct, match)) { 1071 if (match->cancel_all) 1072 goto retry; 1073 break; 1074 } 1075 } 1076 } 1077 1078 static void io_wq_cancel_running_work(struct io_wq *wq, 1079 struct io_cb_cancel_data *match) 1080 { 1081 rcu_read_lock(); 1082 io_wq_for_each_worker(wq, io_wq_worker_cancel, match); 1083 rcu_read_unlock(); 1084 } 1085 1086 enum io_wq_cancel io_wq_cancel_cb(struct io_wq *wq, work_cancel_fn *cancel, 1087 void *data, bool cancel_all) 1088 { 1089 struct io_cb_cancel_data match = { 1090 .fn = cancel, 1091 .data = data, 1092 .cancel_all = cancel_all, 1093 }; 1094 1095 /* 1096 * First check pending list, if we're lucky we can just remove it 1097 * from there. CANCEL_OK means that the work is returned as-new, 1098 * no completion will be posted for it. 1099 * 1100 * Then check if a free (going busy) or busy worker has the work 1101 * currently running. If we find it there, we'll return CANCEL_RUNNING 1102 * as an indication that we attempt to signal cancellation. The 1103 * completion will run normally in this case. 1104 * 1105 * Do both of these while holding the wq->lock, to ensure that 1106 * we'll find a work item regardless of state. 1107 */ 1108 io_wq_cancel_pending_work(wq, &match); 1109 if (match.nr_pending && !match.cancel_all) 1110 return IO_WQ_CANCEL_OK; 1111 1112 raw_spin_lock(&wq->lock); 1113 io_wq_cancel_running_work(wq, &match); 1114 raw_spin_unlock(&wq->lock); 1115 if (match.nr_running && !match.cancel_all) 1116 return IO_WQ_CANCEL_RUNNING; 1117 1118 if (match.nr_running) 1119 return IO_WQ_CANCEL_RUNNING; 1120 if (match.nr_pending) 1121 return IO_WQ_CANCEL_OK; 1122 return IO_WQ_CANCEL_NOTFOUND; 1123 } 1124 1125 static int io_wq_hash_wake(struct wait_queue_entry *wait, unsigned mode, 1126 int sync, void *key) 1127 { 1128 struct io_wq *wq = container_of(wait, struct io_wq, wait); 1129 int i; 1130 1131 list_del_init(&wait->entry); 1132 1133 rcu_read_lock(); 1134 for (i = 0; i < IO_WQ_ACCT_NR; i++) { 1135 struct io_wq_acct *acct = &wq->acct[i]; 1136 1137 if (test_and_clear_bit(IO_ACCT_STALLED_BIT, &acct->flags)) 1138 io_wq_activate_free_worker(wq, acct); 1139 } 1140 rcu_read_unlock(); 1141 return 1; 1142 } 1143 1144 struct io_wq *io_wq_create(unsigned bounded, struct io_wq_data *data) 1145 { 1146 int ret, i; 1147 struct io_wq *wq; 1148 1149 if (WARN_ON_ONCE(!data->free_work || !data->do_work)) 1150 return ERR_PTR(-EINVAL); 1151 if (WARN_ON_ONCE(!bounded)) 1152 return ERR_PTR(-EINVAL); 1153 1154 wq = kzalloc(sizeof(struct io_wq), GFP_KERNEL); 1155 if (!wq) 1156 return ERR_PTR(-ENOMEM); 1157 1158 refcount_inc(&data->hash->refs); 1159 wq->hash = data->hash; 1160 wq->free_work = data->free_work; 1161 wq->do_work = data->do_work; 1162 1163 ret = -ENOMEM; 1164 1165 if (!alloc_cpumask_var(&wq->cpu_mask, GFP_KERNEL)) 1166 goto err; 1167 cpumask_copy(wq->cpu_mask, cpu_possible_mask); 1168 wq->acct[IO_WQ_ACCT_BOUND].max_workers = bounded; 1169 wq->acct[IO_WQ_ACCT_UNBOUND].max_workers = 1170 task_rlimit(current, RLIMIT_NPROC); 1171 INIT_LIST_HEAD(&wq->wait.entry); 1172 wq->wait.func = io_wq_hash_wake; 1173 for (i = 0; i < IO_WQ_ACCT_NR; i++) { 1174 struct io_wq_acct *acct = &wq->acct[i]; 1175 1176 acct->index = i; 1177 atomic_set(&acct->nr_running, 0); 1178 INIT_WQ_LIST(&acct->work_list); 1179 raw_spin_lock_init(&acct->lock); 1180 } 1181 1182 raw_spin_lock_init(&wq->lock); 1183 INIT_HLIST_NULLS_HEAD(&wq->free_list, 0); 1184 INIT_LIST_HEAD(&wq->all_list); 1185 1186 wq->task = get_task_struct(data->task); 1187 atomic_set(&wq->worker_refs, 1); 1188 init_completion(&wq->worker_done); 1189 ret = cpuhp_state_add_instance_nocalls(io_wq_online, &wq->cpuhp_node); 1190 if (ret) 1191 goto err; 1192 1193 return wq; 1194 err: 1195 io_wq_put_hash(data->hash); 1196 free_cpumask_var(wq->cpu_mask); 1197 kfree(wq); 1198 return ERR_PTR(ret); 1199 } 1200 1201 static bool io_task_work_match(struct callback_head *cb, void *data) 1202 { 1203 struct io_worker *worker; 1204 1205 if (cb->func != create_worker_cb && cb->func != create_worker_cont) 1206 return false; 1207 worker = container_of(cb, struct io_worker, create_work); 1208 return worker->wq == data; 1209 } 1210 1211 void io_wq_exit_start(struct io_wq *wq) 1212 { 1213 set_bit(IO_WQ_BIT_EXIT, &wq->state); 1214 } 1215 1216 static void io_wq_cancel_tw_create(struct io_wq *wq) 1217 { 1218 struct callback_head *cb; 1219 1220 while ((cb = task_work_cancel_match(wq->task, io_task_work_match, wq)) != NULL) { 1221 struct io_worker *worker; 1222 1223 worker = container_of(cb, struct io_worker, create_work); 1224 io_worker_cancel_cb(worker); 1225 /* 1226 * Only the worker continuation helper has worker allocated and 1227 * hence needs freeing. 1228 */ 1229 if (cb->func == create_worker_cont) 1230 kfree(worker); 1231 } 1232 } 1233 1234 static void io_wq_exit_workers(struct io_wq *wq) 1235 { 1236 if (!wq->task) 1237 return; 1238 1239 io_wq_cancel_tw_create(wq); 1240 1241 rcu_read_lock(); 1242 io_wq_for_each_worker(wq, io_wq_worker_wake, NULL); 1243 rcu_read_unlock(); 1244 io_worker_ref_put(wq); 1245 wait_for_completion(&wq->worker_done); 1246 1247 spin_lock_irq(&wq->hash->wait.lock); 1248 list_del_init(&wq->wait.entry); 1249 spin_unlock_irq(&wq->hash->wait.lock); 1250 1251 put_task_struct(wq->task); 1252 wq->task = NULL; 1253 } 1254 1255 static void io_wq_destroy(struct io_wq *wq) 1256 { 1257 struct io_cb_cancel_data match = { 1258 .fn = io_wq_work_match_all, 1259 .cancel_all = true, 1260 }; 1261 1262 cpuhp_state_remove_instance_nocalls(io_wq_online, &wq->cpuhp_node); 1263 io_wq_cancel_pending_work(wq, &match); 1264 free_cpumask_var(wq->cpu_mask); 1265 io_wq_put_hash(wq->hash); 1266 kfree(wq); 1267 } 1268 1269 void io_wq_put_and_exit(struct io_wq *wq) 1270 { 1271 WARN_ON_ONCE(!test_bit(IO_WQ_BIT_EXIT, &wq->state)); 1272 1273 io_wq_exit_workers(wq); 1274 io_wq_destroy(wq); 1275 } 1276 1277 struct online_data { 1278 unsigned int cpu; 1279 bool online; 1280 }; 1281 1282 static bool io_wq_worker_affinity(struct io_worker *worker, void *data) 1283 { 1284 struct online_data *od = data; 1285 1286 if (od->online) 1287 cpumask_set_cpu(od->cpu, worker->wq->cpu_mask); 1288 else 1289 cpumask_clear_cpu(od->cpu, worker->wq->cpu_mask); 1290 return false; 1291 } 1292 1293 static int __io_wq_cpu_online(struct io_wq *wq, unsigned int cpu, bool online) 1294 { 1295 struct online_data od = { 1296 .cpu = cpu, 1297 .online = online 1298 }; 1299 1300 rcu_read_lock(); 1301 io_wq_for_each_worker(wq, io_wq_worker_affinity, &od); 1302 rcu_read_unlock(); 1303 return 0; 1304 } 1305 1306 static int io_wq_cpu_online(unsigned int cpu, struct hlist_node *node) 1307 { 1308 struct io_wq *wq = hlist_entry_safe(node, struct io_wq, cpuhp_node); 1309 1310 return __io_wq_cpu_online(wq, cpu, true); 1311 } 1312 1313 static int io_wq_cpu_offline(unsigned int cpu, struct hlist_node *node) 1314 { 1315 struct io_wq *wq = hlist_entry_safe(node, struct io_wq, cpuhp_node); 1316 1317 return __io_wq_cpu_online(wq, cpu, false); 1318 } 1319 1320 int io_wq_cpu_affinity(struct io_uring_task *tctx, cpumask_var_t mask) 1321 { 1322 if (!tctx || !tctx->io_wq) 1323 return -EINVAL; 1324 1325 rcu_read_lock(); 1326 if (mask) 1327 cpumask_copy(tctx->io_wq->cpu_mask, mask); 1328 else 1329 cpumask_copy(tctx->io_wq->cpu_mask, cpu_possible_mask); 1330 rcu_read_unlock(); 1331 1332 return 0; 1333 } 1334 1335 /* 1336 * Set max number of unbounded workers, returns old value. If new_count is 0, 1337 * then just return the old value. 1338 */ 1339 int io_wq_max_workers(struct io_wq *wq, int *new_count) 1340 { 1341 struct io_wq_acct *acct; 1342 int prev[IO_WQ_ACCT_NR]; 1343 int i; 1344 1345 BUILD_BUG_ON((int) IO_WQ_ACCT_BOUND != (int) IO_WQ_BOUND); 1346 BUILD_BUG_ON((int) IO_WQ_ACCT_UNBOUND != (int) IO_WQ_UNBOUND); 1347 BUILD_BUG_ON((int) IO_WQ_ACCT_NR != 2); 1348 1349 for (i = 0; i < IO_WQ_ACCT_NR; i++) { 1350 if (new_count[i] > task_rlimit(current, RLIMIT_NPROC)) 1351 new_count[i] = task_rlimit(current, RLIMIT_NPROC); 1352 } 1353 1354 for (i = 0; i < IO_WQ_ACCT_NR; i++) 1355 prev[i] = 0; 1356 1357 rcu_read_lock(); 1358 1359 raw_spin_lock(&wq->lock); 1360 for (i = 0; i < IO_WQ_ACCT_NR; i++) { 1361 acct = &wq->acct[i]; 1362 prev[i] = max_t(int, acct->max_workers, prev[i]); 1363 if (new_count[i]) 1364 acct->max_workers = new_count[i]; 1365 } 1366 raw_spin_unlock(&wq->lock); 1367 rcu_read_unlock(); 1368 1369 for (i = 0; i < IO_WQ_ACCT_NR; i++) 1370 new_count[i] = prev[i]; 1371 1372 return 0; 1373 } 1374 1375 static __init int io_wq_init(void) 1376 { 1377 int ret; 1378 1379 ret = cpuhp_setup_state_multi(CPUHP_AP_ONLINE_DYN, "io-wq/online", 1380 io_wq_cpu_online, io_wq_cpu_offline); 1381 if (ret < 0) 1382 return ret; 1383 io_wq_online = ret; 1384 return 0; 1385 } 1386 subsys_initcall(io_wq_init); 1387