1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * linux/net/sunrpc/sched.c 4 * 5 * Scheduling for synchronous and asynchronous RPC requests. 6 * 7 * Copyright (C) 1996 Olaf Kirch, <okir@monad.swb.de> 8 * 9 * TCP NFS related read + write fixes 10 * (C) 1999 Dave Airlie, University of Limerick, Ireland <airlied@linux.ie> 11 */ 12 13 #include <linux/module.h> 14 15 #include <linux/sched.h> 16 #include <linux/interrupt.h> 17 #include <linux/slab.h> 18 #include <linux/mempool.h> 19 #include <linux/smp.h> 20 #include <linux/spinlock.h> 21 #include <linux/mutex.h> 22 #include <linux/freezer.h> 23 #include <linux/sched/mm.h> 24 25 #include <linux/sunrpc/clnt.h> 26 #include <linux/sunrpc/metrics.h> 27 28 #include "sunrpc.h" 29 30 #define CREATE_TRACE_POINTS 31 #include <trace/events/sunrpc.h> 32 33 /* 34 * RPC slabs and memory pools 35 */ 36 #define RPC_BUFFER_MAXSIZE (2048) 37 #define RPC_BUFFER_POOLSIZE (8) 38 #define RPC_TASK_POOLSIZE (8) 39 static struct kmem_cache *rpc_task_slabp __read_mostly; 40 static struct kmem_cache *rpc_buffer_slabp __read_mostly; 41 static mempool_t *rpc_task_mempool __read_mostly; 42 static mempool_t *rpc_buffer_mempool __read_mostly; 43 44 static void rpc_async_schedule(struct work_struct *); 45 static void rpc_release_task(struct rpc_task *task); 46 static void __rpc_queue_timer_fn(struct work_struct *); 47 48 /* 49 * RPC tasks sit here while waiting for conditions to improve. 50 */ 51 static struct rpc_wait_queue delay_queue; 52 53 /* 54 * rpciod-related stuff 55 */ 56 struct workqueue_struct *rpciod_workqueue __read_mostly; 57 struct workqueue_struct *xprtiod_workqueue __read_mostly; 58 EXPORT_SYMBOL_GPL(xprtiod_workqueue); 59 60 gfp_t rpc_task_gfp_mask(void) 61 { 62 if (current->flags & PF_WQ_WORKER) 63 return GFP_KERNEL | __GFP_NORETRY | __GFP_NOWARN; 64 return GFP_KERNEL; 65 } 66 EXPORT_SYMBOL_GPL(rpc_task_gfp_mask); 67 68 bool rpc_task_set_rpc_status(struct rpc_task *task, int rpc_status) 69 { 70 if (cmpxchg(&task->tk_rpc_status, 0, rpc_status) == 0) 71 return true; 72 return false; 73 } 74 75 unsigned long 76 rpc_task_timeout(const struct rpc_task *task) 77 { 78 unsigned long timeout = READ_ONCE(task->tk_timeout); 79 80 if (timeout != 0) { 81 unsigned long now = jiffies; 82 if (time_before(now, timeout)) 83 return timeout - now; 84 } 85 return 0; 86 } 87 EXPORT_SYMBOL_GPL(rpc_task_timeout); 88 89 /* 90 * Disable the timer for a given RPC task. Should be called with 91 * queue->lock and bh_disabled in order to avoid races within 92 * rpc_run_timer(). 93 */ 94 static void 95 __rpc_disable_timer(struct rpc_wait_queue *queue, struct rpc_task *task) 96 { 97 if (list_empty(&task->u.tk_wait.timer_list)) 98 return; 99 task->tk_timeout = 0; 100 list_del(&task->u.tk_wait.timer_list); 101 if (list_empty(&queue->timer_list.list)) 102 cancel_delayed_work(&queue->timer_list.dwork); 103 } 104 105 static void 106 rpc_set_queue_timer(struct rpc_wait_queue *queue, unsigned long expires) 107 { 108 unsigned long now = jiffies; 109 queue->timer_list.expires = expires; 110 if (time_before_eq(expires, now)) 111 expires = 0; 112 else 113 expires -= now; 114 mod_delayed_work(rpciod_workqueue, &queue->timer_list.dwork, expires); 115 } 116 117 /* 118 * Set up a timer for the current task. 119 */ 120 static void 121 __rpc_add_timer(struct rpc_wait_queue *queue, struct rpc_task *task, 122 unsigned long timeout) 123 { 124 task->tk_timeout = timeout; 125 if (list_empty(&queue->timer_list.list) || time_before(timeout, queue->timer_list.expires)) 126 rpc_set_queue_timer(queue, timeout); 127 list_add(&task->u.tk_wait.timer_list, &queue->timer_list.list); 128 } 129 130 static void rpc_set_waitqueue_priority(struct rpc_wait_queue *queue, int priority) 131 { 132 if (queue->priority != priority) { 133 queue->priority = priority; 134 queue->nr = 1U << priority; 135 } 136 } 137 138 static void rpc_reset_waitqueue_priority(struct rpc_wait_queue *queue) 139 { 140 rpc_set_waitqueue_priority(queue, queue->maxpriority); 141 } 142 143 /* 144 * Add a request to a queue list 145 */ 146 static void 147 __rpc_list_enqueue_task(struct list_head *q, struct rpc_task *task) 148 { 149 struct rpc_task *t; 150 151 list_for_each_entry(t, q, u.tk_wait.list) { 152 if (t->tk_owner == task->tk_owner) { 153 list_add_tail(&task->u.tk_wait.links, 154 &t->u.tk_wait.links); 155 /* Cache the queue head in task->u.tk_wait.list */ 156 task->u.tk_wait.list.next = q; 157 task->u.tk_wait.list.prev = NULL; 158 return; 159 } 160 } 161 INIT_LIST_HEAD(&task->u.tk_wait.links); 162 list_add_tail(&task->u.tk_wait.list, q); 163 } 164 165 /* 166 * Remove request from a queue list 167 */ 168 static void 169 __rpc_list_dequeue_task(struct rpc_task *task) 170 { 171 struct list_head *q; 172 struct rpc_task *t; 173 174 if (task->u.tk_wait.list.prev == NULL) { 175 list_del(&task->u.tk_wait.links); 176 return; 177 } 178 if (!list_empty(&task->u.tk_wait.links)) { 179 t = list_first_entry(&task->u.tk_wait.links, 180 struct rpc_task, 181 u.tk_wait.links); 182 /* Assume __rpc_list_enqueue_task() cached the queue head */ 183 q = t->u.tk_wait.list.next; 184 list_add_tail(&t->u.tk_wait.list, q); 185 list_del(&task->u.tk_wait.links); 186 } 187 list_del(&task->u.tk_wait.list); 188 } 189 190 /* 191 * Add new request to a priority queue. 192 */ 193 static void __rpc_add_wait_queue_priority(struct rpc_wait_queue *queue, 194 struct rpc_task *task, 195 unsigned char queue_priority) 196 { 197 if (unlikely(queue_priority > queue->maxpriority)) 198 queue_priority = queue->maxpriority; 199 __rpc_list_enqueue_task(&queue->tasks[queue_priority], task); 200 } 201 202 /* 203 * Add new request to wait queue. 204 */ 205 static void __rpc_add_wait_queue(struct rpc_wait_queue *queue, 206 struct rpc_task *task, 207 unsigned char queue_priority) 208 { 209 INIT_LIST_HEAD(&task->u.tk_wait.timer_list); 210 if (RPC_IS_PRIORITY(queue)) 211 __rpc_add_wait_queue_priority(queue, task, queue_priority); 212 else 213 list_add_tail(&task->u.tk_wait.list, &queue->tasks[0]); 214 task->tk_waitqueue = queue; 215 queue->qlen++; 216 /* barrier matches the read in rpc_wake_up_task_queue_locked() */ 217 smp_wmb(); 218 rpc_set_queued(task); 219 } 220 221 /* 222 * Remove request from a priority queue. 223 */ 224 static void __rpc_remove_wait_queue_priority(struct rpc_task *task) 225 { 226 __rpc_list_dequeue_task(task); 227 } 228 229 /* 230 * Remove request from queue. 231 * Note: must be called with spin lock held. 232 */ 233 static void __rpc_remove_wait_queue(struct rpc_wait_queue *queue, struct rpc_task *task) 234 { 235 __rpc_disable_timer(queue, task); 236 if (RPC_IS_PRIORITY(queue)) 237 __rpc_remove_wait_queue_priority(task); 238 else 239 list_del(&task->u.tk_wait.list); 240 queue->qlen--; 241 } 242 243 static void __rpc_init_priority_wait_queue(struct rpc_wait_queue *queue, const char *qname, unsigned char nr_queues) 244 { 245 int i; 246 247 spin_lock_init(&queue->lock); 248 for (i = 0; i < ARRAY_SIZE(queue->tasks); i++) 249 INIT_LIST_HEAD(&queue->tasks[i]); 250 queue->maxpriority = nr_queues - 1; 251 rpc_reset_waitqueue_priority(queue); 252 queue->qlen = 0; 253 queue->timer_list.expires = 0; 254 INIT_DELAYED_WORK(&queue->timer_list.dwork, __rpc_queue_timer_fn); 255 INIT_LIST_HEAD(&queue->timer_list.list); 256 rpc_assign_waitqueue_name(queue, qname); 257 } 258 259 void rpc_init_priority_wait_queue(struct rpc_wait_queue *queue, const char *qname) 260 { 261 __rpc_init_priority_wait_queue(queue, qname, RPC_NR_PRIORITY); 262 } 263 EXPORT_SYMBOL_GPL(rpc_init_priority_wait_queue); 264 265 void rpc_init_wait_queue(struct rpc_wait_queue *queue, const char *qname) 266 { 267 __rpc_init_priority_wait_queue(queue, qname, 1); 268 } 269 EXPORT_SYMBOL_GPL(rpc_init_wait_queue); 270 271 void rpc_destroy_wait_queue(struct rpc_wait_queue *queue) 272 { 273 cancel_delayed_work_sync(&queue->timer_list.dwork); 274 } 275 EXPORT_SYMBOL_GPL(rpc_destroy_wait_queue); 276 277 static int rpc_wait_bit_killable(struct wait_bit_key *key, int mode) 278 { 279 if (unlikely(current->flags & PF_EXITING)) 280 return -EINTR; 281 schedule(); 282 if (signal_pending_state(mode, current)) 283 return -ERESTARTSYS; 284 return 0; 285 } 286 287 #if IS_ENABLED(CONFIG_SUNRPC_DEBUG) || IS_ENABLED(CONFIG_TRACEPOINTS) 288 static void rpc_task_set_debuginfo(struct rpc_task *task) 289 { 290 struct rpc_clnt *clnt = task->tk_client; 291 292 /* Might be a task carrying a reverse-direction operation */ 293 if (!clnt) { 294 static atomic_t rpc_pid; 295 296 task->tk_pid = atomic_inc_return(&rpc_pid); 297 return; 298 } 299 300 task->tk_pid = atomic_inc_return(&clnt->cl_pid); 301 } 302 #else 303 static inline void rpc_task_set_debuginfo(struct rpc_task *task) 304 { 305 } 306 #endif 307 308 static void rpc_set_active(struct rpc_task *task) 309 { 310 rpc_task_set_debuginfo(task); 311 set_bit(RPC_TASK_ACTIVE, &task->tk_runstate); 312 trace_rpc_task_begin(task, NULL); 313 } 314 315 /* 316 * Mark an RPC call as having completed by clearing the 'active' bit 317 * and then waking up all tasks that were sleeping. 318 */ 319 static int rpc_complete_task(struct rpc_task *task) 320 { 321 void *m = &task->tk_runstate; 322 wait_queue_head_t *wq = bit_waitqueue(m, RPC_TASK_ACTIVE); 323 struct wait_bit_key k = __WAIT_BIT_KEY_INITIALIZER(m, RPC_TASK_ACTIVE); 324 unsigned long flags; 325 int ret; 326 327 trace_rpc_task_complete(task, NULL); 328 329 spin_lock_irqsave(&wq->lock, flags); 330 clear_bit(RPC_TASK_ACTIVE, &task->tk_runstate); 331 ret = atomic_dec_and_test(&task->tk_count); 332 if (waitqueue_active(wq)) 333 __wake_up_locked_key(wq, TASK_NORMAL, &k); 334 spin_unlock_irqrestore(&wq->lock, flags); 335 return ret; 336 } 337 338 /* 339 * Allow callers to wait for completion of an RPC call 340 * 341 * Note the use of out_of_line_wait_on_bit() rather than wait_on_bit() 342 * to enforce taking of the wq->lock and hence avoid races with 343 * rpc_complete_task(). 344 */ 345 int rpc_wait_for_completion_task(struct rpc_task *task) 346 { 347 return out_of_line_wait_on_bit(&task->tk_runstate, RPC_TASK_ACTIVE, 348 rpc_wait_bit_killable, TASK_KILLABLE|TASK_FREEZABLE_UNSAFE); 349 } 350 EXPORT_SYMBOL_GPL(rpc_wait_for_completion_task); 351 352 /* 353 * Make an RPC task runnable. 354 * 355 * Note: If the task is ASYNC, and is being made runnable after sitting on an 356 * rpc_wait_queue, this must be called with the queue spinlock held to protect 357 * the wait queue operation. 358 * Note the ordering of rpc_test_and_set_running() and rpc_clear_queued(), 359 * which is needed to ensure that __rpc_execute() doesn't loop (due to the 360 * lockless RPC_IS_QUEUED() test) before we've had a chance to test 361 * the RPC_TASK_RUNNING flag. 362 */ 363 static void rpc_make_runnable(struct workqueue_struct *wq, 364 struct rpc_task *task) 365 { 366 bool need_wakeup = !rpc_test_and_set_running(task); 367 368 rpc_clear_queued(task); 369 if (!need_wakeup) 370 return; 371 if (RPC_IS_ASYNC(task)) { 372 INIT_WORK(&task->u.tk_work, rpc_async_schedule); 373 queue_work(wq, &task->u.tk_work); 374 } else { 375 smp_mb__after_atomic(); 376 wake_up_bit(&task->tk_runstate, RPC_TASK_QUEUED); 377 } 378 } 379 380 /* 381 * Prepare for sleeping on a wait queue. 382 * By always appending tasks to the list we ensure FIFO behavior. 383 * NB: An RPC task will only receive interrupt-driven events as long 384 * as it's on a wait queue. 385 */ 386 static void __rpc_do_sleep_on_priority(struct rpc_wait_queue *q, 387 struct rpc_task *task, 388 unsigned char queue_priority) 389 { 390 trace_rpc_task_sleep(task, q); 391 392 __rpc_add_wait_queue(q, task, queue_priority); 393 } 394 395 static void __rpc_sleep_on_priority(struct rpc_wait_queue *q, 396 struct rpc_task *task, 397 unsigned char queue_priority) 398 { 399 if (WARN_ON_ONCE(RPC_IS_QUEUED(task))) 400 return; 401 __rpc_do_sleep_on_priority(q, task, queue_priority); 402 } 403 404 static void __rpc_sleep_on_priority_timeout(struct rpc_wait_queue *q, 405 struct rpc_task *task, unsigned long timeout, 406 unsigned char queue_priority) 407 { 408 if (WARN_ON_ONCE(RPC_IS_QUEUED(task))) 409 return; 410 if (time_is_after_jiffies(timeout)) { 411 __rpc_do_sleep_on_priority(q, task, queue_priority); 412 __rpc_add_timer(q, task, timeout); 413 } else 414 task->tk_status = -ETIMEDOUT; 415 } 416 417 static void rpc_set_tk_callback(struct rpc_task *task, rpc_action action) 418 { 419 if (action && !WARN_ON_ONCE(task->tk_callback != NULL)) 420 task->tk_callback = action; 421 } 422 423 static bool rpc_sleep_check_activated(struct rpc_task *task) 424 { 425 /* We shouldn't ever put an inactive task to sleep */ 426 if (WARN_ON_ONCE(!RPC_IS_ACTIVATED(task))) { 427 task->tk_status = -EIO; 428 rpc_put_task_async(task); 429 return false; 430 } 431 return true; 432 } 433 434 void rpc_sleep_on_timeout(struct rpc_wait_queue *q, struct rpc_task *task, 435 rpc_action action, unsigned long timeout) 436 { 437 if (!rpc_sleep_check_activated(task)) 438 return; 439 440 rpc_set_tk_callback(task, action); 441 442 /* 443 * Protect the queue operations. 444 */ 445 spin_lock(&q->lock); 446 __rpc_sleep_on_priority_timeout(q, task, timeout, task->tk_priority); 447 spin_unlock(&q->lock); 448 } 449 EXPORT_SYMBOL_GPL(rpc_sleep_on_timeout); 450 451 void rpc_sleep_on(struct rpc_wait_queue *q, struct rpc_task *task, 452 rpc_action action) 453 { 454 if (!rpc_sleep_check_activated(task)) 455 return; 456 457 rpc_set_tk_callback(task, action); 458 459 WARN_ON_ONCE(task->tk_timeout != 0); 460 /* 461 * Protect the queue operations. 462 */ 463 spin_lock(&q->lock); 464 __rpc_sleep_on_priority(q, task, task->tk_priority); 465 spin_unlock(&q->lock); 466 } 467 EXPORT_SYMBOL_GPL(rpc_sleep_on); 468 469 void rpc_sleep_on_priority_timeout(struct rpc_wait_queue *q, 470 struct rpc_task *task, unsigned long timeout, int priority) 471 { 472 if (!rpc_sleep_check_activated(task)) 473 return; 474 475 priority -= RPC_PRIORITY_LOW; 476 /* 477 * Protect the queue operations. 478 */ 479 spin_lock(&q->lock); 480 __rpc_sleep_on_priority_timeout(q, task, timeout, priority); 481 spin_unlock(&q->lock); 482 } 483 EXPORT_SYMBOL_GPL(rpc_sleep_on_priority_timeout); 484 485 void rpc_sleep_on_priority(struct rpc_wait_queue *q, struct rpc_task *task, 486 int priority) 487 { 488 if (!rpc_sleep_check_activated(task)) 489 return; 490 491 WARN_ON_ONCE(task->tk_timeout != 0); 492 priority -= RPC_PRIORITY_LOW; 493 /* 494 * Protect the queue operations. 495 */ 496 spin_lock(&q->lock); 497 __rpc_sleep_on_priority(q, task, priority); 498 spin_unlock(&q->lock); 499 } 500 EXPORT_SYMBOL_GPL(rpc_sleep_on_priority); 501 502 /** 503 * __rpc_do_wake_up_task_on_wq - wake up a single rpc_task 504 * @wq: workqueue on which to run task 505 * @queue: wait queue 506 * @task: task to be woken up 507 * 508 * Caller must hold queue->lock, and have cleared the task queued flag. 509 */ 510 static void __rpc_do_wake_up_task_on_wq(struct workqueue_struct *wq, 511 struct rpc_wait_queue *queue, 512 struct rpc_task *task) 513 { 514 /* Has the task been executed yet? If not, we cannot wake it up! */ 515 if (!RPC_IS_ACTIVATED(task)) { 516 printk(KERN_ERR "RPC: Inactive task (%p) being woken up!\n", task); 517 return; 518 } 519 520 trace_rpc_task_wakeup(task, queue); 521 522 __rpc_remove_wait_queue(queue, task); 523 524 rpc_make_runnable(wq, task); 525 } 526 527 /* 528 * Wake up a queued task while the queue lock is being held 529 */ 530 static struct rpc_task * 531 rpc_wake_up_task_on_wq_queue_action_locked(struct workqueue_struct *wq, 532 struct rpc_wait_queue *queue, struct rpc_task *task, 533 bool (*action)(struct rpc_task *, void *), void *data) 534 { 535 if (RPC_IS_QUEUED(task)) { 536 smp_rmb(); 537 if (task->tk_waitqueue == queue) { 538 if (action == NULL || action(task, data)) { 539 __rpc_do_wake_up_task_on_wq(wq, queue, task); 540 return task; 541 } 542 } 543 } 544 return NULL; 545 } 546 547 /* 548 * Wake up a queued task while the queue lock is being held 549 */ 550 static void rpc_wake_up_task_queue_locked(struct rpc_wait_queue *queue, 551 struct rpc_task *task) 552 { 553 rpc_wake_up_task_on_wq_queue_action_locked(rpciod_workqueue, queue, 554 task, NULL, NULL); 555 } 556 557 /* 558 * Wake up a task on a specific queue 559 */ 560 void rpc_wake_up_queued_task(struct rpc_wait_queue *queue, struct rpc_task *task) 561 { 562 if (!RPC_IS_QUEUED(task)) 563 return; 564 spin_lock(&queue->lock); 565 rpc_wake_up_task_queue_locked(queue, task); 566 spin_unlock(&queue->lock); 567 } 568 EXPORT_SYMBOL_GPL(rpc_wake_up_queued_task); 569 570 static bool rpc_task_action_set_status(struct rpc_task *task, void *status) 571 { 572 task->tk_status = *(int *)status; 573 return true; 574 } 575 576 static void 577 rpc_wake_up_task_queue_set_status_locked(struct rpc_wait_queue *queue, 578 struct rpc_task *task, int status) 579 { 580 rpc_wake_up_task_on_wq_queue_action_locked(rpciod_workqueue, queue, 581 task, rpc_task_action_set_status, &status); 582 } 583 584 /** 585 * rpc_wake_up_queued_task_set_status - wake up a task and set task->tk_status 586 * @queue: pointer to rpc_wait_queue 587 * @task: pointer to rpc_task 588 * @status: integer error value 589 * 590 * If @task is queued on @queue, then it is woken up, and @task->tk_status is 591 * set to the value of @status. 592 */ 593 void 594 rpc_wake_up_queued_task_set_status(struct rpc_wait_queue *queue, 595 struct rpc_task *task, int status) 596 { 597 if (!RPC_IS_QUEUED(task)) 598 return; 599 spin_lock(&queue->lock); 600 rpc_wake_up_task_queue_set_status_locked(queue, task, status); 601 spin_unlock(&queue->lock); 602 } 603 604 /* 605 * Wake up the next task on a priority queue. 606 */ 607 static struct rpc_task *__rpc_find_next_queued_priority(struct rpc_wait_queue *queue) 608 { 609 struct list_head *q; 610 struct rpc_task *task; 611 612 /* 613 * Service the privileged queue. 614 */ 615 q = &queue->tasks[RPC_NR_PRIORITY - 1]; 616 if (queue->maxpriority > RPC_PRIORITY_PRIVILEGED && !list_empty(q)) { 617 task = list_first_entry(q, struct rpc_task, u.tk_wait.list); 618 goto out; 619 } 620 621 /* 622 * Service a batch of tasks from a single owner. 623 */ 624 q = &queue->tasks[queue->priority]; 625 if (!list_empty(q) && queue->nr) { 626 queue->nr--; 627 task = list_first_entry(q, struct rpc_task, u.tk_wait.list); 628 goto out; 629 } 630 631 /* 632 * Service the next queue. 633 */ 634 do { 635 if (q == &queue->tasks[0]) 636 q = &queue->tasks[queue->maxpriority]; 637 else 638 q = q - 1; 639 if (!list_empty(q)) { 640 task = list_first_entry(q, struct rpc_task, u.tk_wait.list); 641 goto new_queue; 642 } 643 } while (q != &queue->tasks[queue->priority]); 644 645 rpc_reset_waitqueue_priority(queue); 646 return NULL; 647 648 new_queue: 649 rpc_set_waitqueue_priority(queue, (unsigned int)(q - &queue->tasks[0])); 650 out: 651 return task; 652 } 653 654 static struct rpc_task *__rpc_find_next_queued(struct rpc_wait_queue *queue) 655 { 656 if (RPC_IS_PRIORITY(queue)) 657 return __rpc_find_next_queued_priority(queue); 658 if (!list_empty(&queue->tasks[0])) 659 return list_first_entry(&queue->tasks[0], struct rpc_task, u.tk_wait.list); 660 return NULL; 661 } 662 663 /* 664 * Wake up the first task on the wait queue. 665 */ 666 struct rpc_task *rpc_wake_up_first_on_wq(struct workqueue_struct *wq, 667 struct rpc_wait_queue *queue, 668 bool (*func)(struct rpc_task *, void *), void *data) 669 { 670 struct rpc_task *task = NULL; 671 672 spin_lock(&queue->lock); 673 task = __rpc_find_next_queued(queue); 674 if (task != NULL) 675 task = rpc_wake_up_task_on_wq_queue_action_locked(wq, queue, 676 task, func, data); 677 spin_unlock(&queue->lock); 678 679 return task; 680 } 681 682 /* 683 * Wake up the first task on the wait queue. 684 */ 685 struct rpc_task *rpc_wake_up_first(struct rpc_wait_queue *queue, 686 bool (*func)(struct rpc_task *, void *), void *data) 687 { 688 return rpc_wake_up_first_on_wq(rpciod_workqueue, queue, func, data); 689 } 690 EXPORT_SYMBOL_GPL(rpc_wake_up_first); 691 692 static bool rpc_wake_up_next_func(struct rpc_task *task, void *data) 693 { 694 return true; 695 } 696 697 /* 698 * Wake up the next task on the wait queue. 699 */ 700 struct rpc_task *rpc_wake_up_next(struct rpc_wait_queue *queue) 701 { 702 return rpc_wake_up_first(queue, rpc_wake_up_next_func, NULL); 703 } 704 EXPORT_SYMBOL_GPL(rpc_wake_up_next); 705 706 /** 707 * rpc_wake_up_locked - wake up all rpc_tasks 708 * @queue: rpc_wait_queue on which the tasks are sleeping 709 * 710 */ 711 static void rpc_wake_up_locked(struct rpc_wait_queue *queue) 712 { 713 struct rpc_task *task; 714 715 for (;;) { 716 task = __rpc_find_next_queued(queue); 717 if (task == NULL) 718 break; 719 rpc_wake_up_task_queue_locked(queue, task); 720 } 721 } 722 723 /** 724 * rpc_wake_up - wake up all rpc_tasks 725 * @queue: rpc_wait_queue on which the tasks are sleeping 726 * 727 * Grabs queue->lock 728 */ 729 void rpc_wake_up(struct rpc_wait_queue *queue) 730 { 731 spin_lock(&queue->lock); 732 rpc_wake_up_locked(queue); 733 spin_unlock(&queue->lock); 734 } 735 EXPORT_SYMBOL_GPL(rpc_wake_up); 736 737 /** 738 * rpc_wake_up_status_locked - wake up all rpc_tasks and set their status value. 739 * @queue: rpc_wait_queue on which the tasks are sleeping 740 * @status: status value to set 741 */ 742 static void rpc_wake_up_status_locked(struct rpc_wait_queue *queue, int status) 743 { 744 struct rpc_task *task; 745 746 for (;;) { 747 task = __rpc_find_next_queued(queue); 748 if (task == NULL) 749 break; 750 rpc_wake_up_task_queue_set_status_locked(queue, task, status); 751 } 752 } 753 754 /** 755 * rpc_wake_up_status - wake up all rpc_tasks and set their status value. 756 * @queue: rpc_wait_queue on which the tasks are sleeping 757 * @status: status value to set 758 * 759 * Grabs queue->lock 760 */ 761 void rpc_wake_up_status(struct rpc_wait_queue *queue, int status) 762 { 763 spin_lock(&queue->lock); 764 rpc_wake_up_status_locked(queue, status); 765 spin_unlock(&queue->lock); 766 } 767 EXPORT_SYMBOL_GPL(rpc_wake_up_status); 768 769 static void __rpc_queue_timer_fn(struct work_struct *work) 770 { 771 struct rpc_wait_queue *queue = container_of(work, 772 struct rpc_wait_queue, 773 timer_list.dwork.work); 774 struct rpc_task *task, *n; 775 unsigned long expires, now, timeo; 776 777 spin_lock(&queue->lock); 778 expires = now = jiffies; 779 list_for_each_entry_safe(task, n, &queue->timer_list.list, u.tk_wait.timer_list) { 780 timeo = task->tk_timeout; 781 if (time_after_eq(now, timeo)) { 782 trace_rpc_task_timeout(task, task->tk_action); 783 task->tk_status = -ETIMEDOUT; 784 rpc_wake_up_task_queue_locked(queue, task); 785 continue; 786 } 787 if (expires == now || time_after(expires, timeo)) 788 expires = timeo; 789 } 790 if (!list_empty(&queue->timer_list.list)) 791 rpc_set_queue_timer(queue, expires); 792 spin_unlock(&queue->lock); 793 } 794 795 static void __rpc_atrun(struct rpc_task *task) 796 { 797 if (task->tk_status == -ETIMEDOUT) 798 task->tk_status = 0; 799 } 800 801 /* 802 * Run a task at a later time 803 */ 804 void rpc_delay(struct rpc_task *task, unsigned long delay) 805 { 806 rpc_sleep_on_timeout(&delay_queue, task, __rpc_atrun, jiffies + delay); 807 } 808 EXPORT_SYMBOL_GPL(rpc_delay); 809 810 /* 811 * Helper to call task->tk_ops->rpc_call_prepare 812 */ 813 void rpc_prepare_task(struct rpc_task *task) 814 { 815 task->tk_ops->rpc_call_prepare(task, task->tk_calldata); 816 } 817 818 static void 819 rpc_init_task_statistics(struct rpc_task *task) 820 { 821 /* Initialize retry counters */ 822 task->tk_garb_retry = 2; 823 task->tk_cred_retry = 2; 824 825 /* starting timestamp */ 826 task->tk_start = ktime_get(); 827 } 828 829 static void 830 rpc_reset_task_statistics(struct rpc_task *task) 831 { 832 task->tk_timeouts = 0; 833 task->tk_flags &= ~(RPC_CALL_MAJORSEEN|RPC_TASK_SENT); 834 rpc_init_task_statistics(task); 835 } 836 837 /* 838 * Helper that calls task->tk_ops->rpc_call_done if it exists 839 */ 840 void rpc_exit_task(struct rpc_task *task) 841 { 842 trace_rpc_task_end(task, task->tk_action); 843 task->tk_action = NULL; 844 if (task->tk_ops->rpc_count_stats) 845 task->tk_ops->rpc_count_stats(task, task->tk_calldata); 846 else if (task->tk_client) 847 rpc_count_iostats(task, task->tk_client->cl_metrics); 848 if (task->tk_ops->rpc_call_done != NULL) { 849 trace_rpc_task_call_done(task, task->tk_ops->rpc_call_done); 850 task->tk_ops->rpc_call_done(task, task->tk_calldata); 851 if (task->tk_action != NULL) { 852 /* Always release the RPC slot and buffer memory */ 853 xprt_release(task); 854 rpc_reset_task_statistics(task); 855 } 856 } 857 } 858 859 void rpc_signal_task(struct rpc_task *task) 860 { 861 struct rpc_wait_queue *queue; 862 863 if (!RPC_IS_ACTIVATED(task)) 864 return; 865 866 if (!rpc_task_set_rpc_status(task, -ERESTARTSYS)) 867 return; 868 trace_rpc_task_signalled(task, task->tk_action); 869 queue = READ_ONCE(task->tk_waitqueue); 870 if (queue) 871 rpc_wake_up_queued_task(queue, task); 872 } 873 874 void rpc_task_try_cancel(struct rpc_task *task, int error) 875 { 876 struct rpc_wait_queue *queue; 877 878 if (!rpc_task_set_rpc_status(task, error)) 879 return; 880 queue = READ_ONCE(task->tk_waitqueue); 881 if (queue) 882 rpc_wake_up_queued_task(queue, task); 883 } 884 885 void rpc_exit(struct rpc_task *task, int status) 886 { 887 task->tk_status = status; 888 task->tk_action = rpc_exit_task; 889 rpc_wake_up_queued_task(task->tk_waitqueue, task); 890 } 891 EXPORT_SYMBOL_GPL(rpc_exit); 892 893 void rpc_release_calldata(const struct rpc_call_ops *ops, void *calldata) 894 { 895 if (ops->rpc_release != NULL) 896 ops->rpc_release(calldata); 897 } 898 899 static bool xprt_needs_memalloc(struct rpc_xprt *xprt, struct rpc_task *tk) 900 { 901 if (!xprt) 902 return false; 903 if (!atomic_read(&xprt->swapper)) 904 return false; 905 return test_bit(XPRT_LOCKED, &xprt->state) && xprt->snd_task == tk; 906 } 907 908 /* 909 * This is the RPC `scheduler' (or rather, the finite state machine). 910 */ 911 static void __rpc_execute(struct rpc_task *task) 912 { 913 struct rpc_wait_queue *queue; 914 int task_is_async = RPC_IS_ASYNC(task); 915 int status = 0; 916 unsigned long pflags = current->flags; 917 918 WARN_ON_ONCE(RPC_IS_QUEUED(task)); 919 if (RPC_IS_QUEUED(task)) 920 return; 921 922 for (;;) { 923 void (*do_action)(struct rpc_task *); 924 925 /* 926 * Perform the next FSM step or a pending callback. 927 * 928 * tk_action may be NULL if the task has been killed. 929 */ 930 do_action = task->tk_action; 931 /* Tasks with an RPC error status should exit */ 932 if (do_action && do_action != rpc_exit_task && 933 (status = READ_ONCE(task->tk_rpc_status)) != 0) { 934 task->tk_status = status; 935 do_action = rpc_exit_task; 936 } 937 /* Callbacks override all actions */ 938 if (task->tk_callback) { 939 do_action = task->tk_callback; 940 task->tk_callback = NULL; 941 } 942 if (!do_action) 943 break; 944 if (RPC_IS_SWAPPER(task) || 945 xprt_needs_memalloc(task->tk_xprt, task)) 946 current->flags |= PF_MEMALLOC; 947 948 trace_rpc_task_run_action(task, do_action); 949 do_action(task); 950 951 /* 952 * Lockless check for whether task is sleeping or not. 953 */ 954 if (!RPC_IS_QUEUED(task)) { 955 cond_resched(); 956 continue; 957 } 958 959 /* 960 * The queue->lock protects against races with 961 * rpc_make_runnable(). 962 * 963 * Note that once we clear RPC_TASK_RUNNING on an asynchronous 964 * rpc_task, rpc_make_runnable() can assign it to a 965 * different workqueue. We therefore cannot assume that the 966 * rpc_task pointer may still be dereferenced. 967 */ 968 queue = task->tk_waitqueue; 969 spin_lock(&queue->lock); 970 if (!RPC_IS_QUEUED(task)) { 971 spin_unlock(&queue->lock); 972 continue; 973 } 974 /* Wake up any task that has an exit status */ 975 if (READ_ONCE(task->tk_rpc_status) != 0) { 976 rpc_wake_up_task_queue_locked(queue, task); 977 spin_unlock(&queue->lock); 978 continue; 979 } 980 rpc_clear_running(task); 981 spin_unlock(&queue->lock); 982 if (task_is_async) 983 goto out; 984 985 /* sync task: sleep here */ 986 trace_rpc_task_sync_sleep(task, task->tk_action); 987 status = out_of_line_wait_on_bit(&task->tk_runstate, 988 RPC_TASK_QUEUED, rpc_wait_bit_killable, 989 TASK_KILLABLE|TASK_FREEZABLE); 990 if (status < 0) { 991 /* 992 * When a sync task receives a signal, it exits with 993 * -ERESTARTSYS. In order to catch any callbacks that 994 * clean up after sleeping on some queue, we don't 995 * break the loop here, but go around once more. 996 */ 997 rpc_signal_task(task); 998 } 999 trace_rpc_task_sync_wake(task, task->tk_action); 1000 } 1001 1002 /* Release all resources associated with the task */ 1003 rpc_release_task(task); 1004 out: 1005 current_restore_flags(pflags, PF_MEMALLOC); 1006 } 1007 1008 /* 1009 * User-visible entry point to the scheduler. 1010 * 1011 * This may be called recursively if e.g. an async NFS task updates 1012 * the attributes and finds that dirty pages must be flushed. 1013 * NOTE: Upon exit of this function the task is guaranteed to be 1014 * released. In particular note that tk_release() will have 1015 * been called, so your task memory may have been freed. 1016 */ 1017 void rpc_execute(struct rpc_task *task) 1018 { 1019 bool is_async = RPC_IS_ASYNC(task); 1020 1021 rpc_set_active(task); 1022 rpc_make_runnable(rpciod_workqueue, task); 1023 if (!is_async) { 1024 unsigned int pflags = memalloc_nofs_save(); 1025 __rpc_execute(task); 1026 memalloc_nofs_restore(pflags); 1027 } 1028 } 1029 1030 static void rpc_async_schedule(struct work_struct *work) 1031 { 1032 unsigned int pflags = memalloc_nofs_save(); 1033 1034 __rpc_execute(container_of(work, struct rpc_task, u.tk_work)); 1035 memalloc_nofs_restore(pflags); 1036 } 1037 1038 /** 1039 * rpc_malloc - allocate RPC buffer resources 1040 * @task: RPC task 1041 * 1042 * A single memory region is allocated, which is split between the 1043 * RPC call and RPC reply that this task is being used for. When 1044 * this RPC is retired, the memory is released by calling rpc_free. 1045 * 1046 * To prevent rpciod from hanging, this allocator never sleeps, 1047 * returning -ENOMEM and suppressing warning if the request cannot 1048 * be serviced immediately. The caller can arrange to sleep in a 1049 * way that is safe for rpciod. 1050 * 1051 * Most requests are 'small' (under 2KiB) and can be serviced from a 1052 * mempool, ensuring that NFS reads and writes can always proceed, 1053 * and that there is good locality of reference for these buffers. 1054 */ 1055 int rpc_malloc(struct rpc_task *task) 1056 { 1057 struct rpc_rqst *rqst = task->tk_rqstp; 1058 size_t size = rqst->rq_callsize + rqst->rq_rcvsize; 1059 struct rpc_buffer *buf; 1060 gfp_t gfp = rpc_task_gfp_mask(); 1061 1062 size += sizeof(struct rpc_buffer); 1063 if (size <= RPC_BUFFER_MAXSIZE) { 1064 buf = kmem_cache_alloc(rpc_buffer_slabp, gfp); 1065 /* Reach for the mempool if dynamic allocation fails */ 1066 if (!buf && RPC_IS_ASYNC(task)) 1067 buf = mempool_alloc(rpc_buffer_mempool, GFP_NOWAIT); 1068 } else 1069 buf = kmalloc(size, gfp); 1070 1071 if (!buf) 1072 return -ENOMEM; 1073 1074 buf->len = size; 1075 rqst->rq_buffer = buf->data; 1076 rqst->rq_rbuffer = (char *)rqst->rq_buffer + rqst->rq_callsize; 1077 return 0; 1078 } 1079 EXPORT_SYMBOL_GPL(rpc_malloc); 1080 1081 /** 1082 * rpc_free - free RPC buffer resources allocated via rpc_malloc 1083 * @task: RPC task 1084 * 1085 */ 1086 void rpc_free(struct rpc_task *task) 1087 { 1088 void *buffer = task->tk_rqstp->rq_buffer; 1089 size_t size; 1090 struct rpc_buffer *buf; 1091 1092 buf = container_of(buffer, struct rpc_buffer, data); 1093 size = buf->len; 1094 1095 if (size <= RPC_BUFFER_MAXSIZE) 1096 mempool_free(buf, rpc_buffer_mempool); 1097 else 1098 kfree(buf); 1099 } 1100 EXPORT_SYMBOL_GPL(rpc_free); 1101 1102 /* 1103 * Creation and deletion of RPC task structures 1104 */ 1105 static void rpc_init_task(struct rpc_task *task, const struct rpc_task_setup *task_setup_data) 1106 { 1107 memset(task, 0, sizeof(*task)); 1108 atomic_set(&task->tk_count, 1); 1109 task->tk_flags = task_setup_data->flags; 1110 task->tk_ops = task_setup_data->callback_ops; 1111 task->tk_calldata = task_setup_data->callback_data; 1112 INIT_LIST_HEAD(&task->tk_task); 1113 1114 task->tk_priority = task_setup_data->priority - RPC_PRIORITY_LOW; 1115 task->tk_owner = current->tgid; 1116 1117 /* Initialize workqueue for async tasks */ 1118 task->tk_workqueue = task_setup_data->workqueue; 1119 1120 task->tk_xprt = rpc_task_get_xprt(task_setup_data->rpc_client, 1121 xprt_get(task_setup_data->rpc_xprt)); 1122 1123 task->tk_op_cred = get_rpccred(task_setup_data->rpc_op_cred); 1124 1125 if (task->tk_ops->rpc_call_prepare != NULL) 1126 task->tk_action = rpc_prepare_task; 1127 1128 rpc_init_task_statistics(task); 1129 } 1130 1131 static struct rpc_task *rpc_alloc_task(void) 1132 { 1133 struct rpc_task *task; 1134 1135 task = kmem_cache_alloc(rpc_task_slabp, rpc_task_gfp_mask()); 1136 if (task) 1137 return task; 1138 return mempool_alloc(rpc_task_mempool, GFP_NOWAIT); 1139 } 1140 1141 /* 1142 * Create a new task for the specified client. 1143 */ 1144 struct rpc_task *rpc_new_task(const struct rpc_task_setup *setup_data) 1145 { 1146 struct rpc_task *task = setup_data->task; 1147 unsigned short flags = 0; 1148 1149 if (task == NULL) { 1150 task = rpc_alloc_task(); 1151 if (task == NULL) { 1152 rpc_release_calldata(setup_data->callback_ops, 1153 setup_data->callback_data); 1154 return ERR_PTR(-ENOMEM); 1155 } 1156 flags = RPC_TASK_DYNAMIC; 1157 } 1158 1159 rpc_init_task(task, setup_data); 1160 task->tk_flags |= flags; 1161 return task; 1162 } 1163 1164 /* 1165 * rpc_free_task - release rpc task and perform cleanups 1166 * 1167 * Note that we free up the rpc_task _after_ rpc_release_calldata() 1168 * in order to work around a workqueue dependency issue. 1169 * 1170 * Tejun Heo states: 1171 * "Workqueue currently considers two work items to be the same if they're 1172 * on the same address and won't execute them concurrently - ie. it 1173 * makes a work item which is queued again while being executed wait 1174 * for the previous execution to complete. 1175 * 1176 * If a work function frees the work item, and then waits for an event 1177 * which should be performed by another work item and *that* work item 1178 * recycles the freed work item, it can create a false dependency loop. 1179 * There really is no reliable way to detect this short of verifying 1180 * every memory free." 1181 * 1182 */ 1183 static void rpc_free_task(struct rpc_task *task) 1184 { 1185 unsigned short tk_flags = task->tk_flags; 1186 1187 put_rpccred(task->tk_op_cred); 1188 rpc_release_calldata(task->tk_ops, task->tk_calldata); 1189 1190 if (tk_flags & RPC_TASK_DYNAMIC) 1191 mempool_free(task, rpc_task_mempool); 1192 } 1193 1194 static void rpc_async_release(struct work_struct *work) 1195 { 1196 unsigned int pflags = memalloc_nofs_save(); 1197 1198 rpc_free_task(container_of(work, struct rpc_task, u.tk_work)); 1199 memalloc_nofs_restore(pflags); 1200 } 1201 1202 static void rpc_release_resources_task(struct rpc_task *task) 1203 { 1204 xprt_release(task); 1205 if (task->tk_msg.rpc_cred) { 1206 if (!(task->tk_flags & RPC_TASK_CRED_NOREF)) 1207 put_cred(task->tk_msg.rpc_cred); 1208 task->tk_msg.rpc_cred = NULL; 1209 } 1210 rpc_task_release_client(task); 1211 } 1212 1213 static void rpc_final_put_task(struct rpc_task *task, 1214 struct workqueue_struct *q) 1215 { 1216 if (q != NULL) { 1217 INIT_WORK(&task->u.tk_work, rpc_async_release); 1218 queue_work(q, &task->u.tk_work); 1219 } else 1220 rpc_free_task(task); 1221 } 1222 1223 static void rpc_do_put_task(struct rpc_task *task, struct workqueue_struct *q) 1224 { 1225 if (atomic_dec_and_test(&task->tk_count)) { 1226 rpc_release_resources_task(task); 1227 rpc_final_put_task(task, q); 1228 } 1229 } 1230 1231 void rpc_put_task(struct rpc_task *task) 1232 { 1233 rpc_do_put_task(task, NULL); 1234 } 1235 EXPORT_SYMBOL_GPL(rpc_put_task); 1236 1237 void rpc_put_task_async(struct rpc_task *task) 1238 { 1239 rpc_do_put_task(task, task->tk_workqueue); 1240 } 1241 EXPORT_SYMBOL_GPL(rpc_put_task_async); 1242 1243 static void rpc_release_task(struct rpc_task *task) 1244 { 1245 WARN_ON_ONCE(RPC_IS_QUEUED(task)); 1246 1247 rpc_release_resources_task(task); 1248 1249 /* 1250 * Note: at this point we have been removed from rpc_clnt->cl_tasks, 1251 * so it should be safe to use task->tk_count as a test for whether 1252 * or not any other processes still hold references to our rpc_task. 1253 */ 1254 if (atomic_read(&task->tk_count) != 1 + !RPC_IS_ASYNC(task)) { 1255 /* Wake up anyone who may be waiting for task completion */ 1256 if (!rpc_complete_task(task)) 1257 return; 1258 } else { 1259 if (!atomic_dec_and_test(&task->tk_count)) 1260 return; 1261 } 1262 rpc_final_put_task(task, task->tk_workqueue); 1263 } 1264 1265 int rpciod_up(void) 1266 { 1267 return try_module_get(THIS_MODULE) ? 0 : -EINVAL; 1268 } 1269 1270 void rpciod_down(void) 1271 { 1272 module_put(THIS_MODULE); 1273 } 1274 1275 /* 1276 * Start up the rpciod workqueue. 1277 */ 1278 static int rpciod_start(void) 1279 { 1280 struct workqueue_struct *wq; 1281 1282 /* 1283 * Create the rpciod thread and wait for it to start. 1284 */ 1285 wq = alloc_workqueue("rpciod", WQ_MEM_RECLAIM | WQ_UNBOUND, 0); 1286 if (!wq) 1287 goto out_failed; 1288 rpciod_workqueue = wq; 1289 wq = alloc_workqueue("xprtiod", WQ_UNBOUND | WQ_MEM_RECLAIM, 0); 1290 if (!wq) 1291 goto free_rpciod; 1292 xprtiod_workqueue = wq; 1293 return 1; 1294 free_rpciod: 1295 wq = rpciod_workqueue; 1296 rpciod_workqueue = NULL; 1297 destroy_workqueue(wq); 1298 out_failed: 1299 return 0; 1300 } 1301 1302 static void rpciod_stop(void) 1303 { 1304 struct workqueue_struct *wq = NULL; 1305 1306 if (rpciod_workqueue == NULL) 1307 return; 1308 1309 wq = rpciod_workqueue; 1310 rpciod_workqueue = NULL; 1311 destroy_workqueue(wq); 1312 wq = xprtiod_workqueue; 1313 xprtiod_workqueue = NULL; 1314 destroy_workqueue(wq); 1315 } 1316 1317 void 1318 rpc_destroy_mempool(void) 1319 { 1320 rpciod_stop(); 1321 mempool_destroy(rpc_buffer_mempool); 1322 mempool_destroy(rpc_task_mempool); 1323 kmem_cache_destroy(rpc_task_slabp); 1324 kmem_cache_destroy(rpc_buffer_slabp); 1325 rpc_destroy_wait_queue(&delay_queue); 1326 } 1327 1328 int 1329 rpc_init_mempool(void) 1330 { 1331 /* 1332 * The following is not strictly a mempool initialisation, 1333 * but there is no harm in doing it here 1334 */ 1335 rpc_init_wait_queue(&delay_queue, "delayq"); 1336 if (!rpciod_start()) 1337 goto err_nomem; 1338 1339 rpc_task_slabp = kmem_cache_create("rpc_tasks", 1340 sizeof(struct rpc_task), 1341 0, SLAB_HWCACHE_ALIGN, 1342 NULL); 1343 if (!rpc_task_slabp) 1344 goto err_nomem; 1345 rpc_buffer_slabp = kmem_cache_create("rpc_buffers", 1346 RPC_BUFFER_MAXSIZE, 1347 0, SLAB_HWCACHE_ALIGN, 1348 NULL); 1349 if (!rpc_buffer_slabp) 1350 goto err_nomem; 1351 rpc_task_mempool = mempool_create_slab_pool(RPC_TASK_POOLSIZE, 1352 rpc_task_slabp); 1353 if (!rpc_task_mempool) 1354 goto err_nomem; 1355 rpc_buffer_mempool = mempool_create_slab_pool(RPC_BUFFER_POOLSIZE, 1356 rpc_buffer_slabp); 1357 if (!rpc_buffer_mempool) 1358 goto err_nomem; 1359 return 0; 1360 err_nomem: 1361 rpc_destroy_mempool(); 1362 return -ENOMEM; 1363 } 1364