1 // SPDX-License-Identifier: GPL-2.0+ 2 /* 3 * RCU CPU stall warnings for normal RCU grace periods 4 * 5 * Copyright IBM Corporation, 2019 6 * 7 * Author: Paul E. McKenney <paulmck@linux.ibm.com> 8 */ 9 10 #include <linux/console.h> 11 #include <linux/kvm_para.h> 12 #include <linux/rcu_notifier.h> 13 #include <linux/smp.h> 14 15 ////////////////////////////////////////////////////////////////////////////// 16 // 17 // Controlling CPU stall warnings, including delay calculation. 18 19 /* panic() on RCU Stall sysctl. */ 20 int sysctl_panic_on_rcu_stall __read_mostly; 21 int sysctl_max_rcu_stall_to_panic __read_mostly; 22 23 #ifdef CONFIG_PROVE_RCU 24 #define RCU_STALL_DELAY_DELTA (5 * HZ) 25 #else 26 #define RCU_STALL_DELAY_DELTA 0 27 #endif 28 #define RCU_STALL_MIGHT_DIV 8 29 #define RCU_STALL_MIGHT_MIN (2 * HZ) 30 31 int rcu_exp_jiffies_till_stall_check(void) 32 { 33 int cpu_stall_timeout = READ_ONCE(rcu_exp_cpu_stall_timeout); 34 int exp_stall_delay_delta = 0; 35 int till_stall_check; 36 37 // Zero says to use rcu_cpu_stall_timeout, but in milliseconds. 38 if (!cpu_stall_timeout) 39 cpu_stall_timeout = jiffies_to_msecs(rcu_jiffies_till_stall_check()); 40 41 // Limit check must be consistent with the Kconfig limits for 42 // CONFIG_RCU_EXP_CPU_STALL_TIMEOUT, so check the allowed range. 43 // The minimum clamped value is "2UL", because at least one full 44 // tick has to be guaranteed. 45 till_stall_check = clamp(msecs_to_jiffies(cpu_stall_timeout), 2UL, 300UL * HZ); 46 47 if (cpu_stall_timeout && jiffies_to_msecs(till_stall_check) != cpu_stall_timeout) 48 WRITE_ONCE(rcu_exp_cpu_stall_timeout, jiffies_to_msecs(till_stall_check)); 49 50 #ifdef CONFIG_PROVE_RCU 51 /* Add extra ~25% out of till_stall_check. */ 52 exp_stall_delay_delta = ((till_stall_check * 25) / 100) + 1; 53 #endif 54 55 return till_stall_check + exp_stall_delay_delta; 56 } 57 EXPORT_SYMBOL_GPL(rcu_exp_jiffies_till_stall_check); 58 59 /* Limit-check stall timeouts specified at boottime and runtime. */ 60 int rcu_jiffies_till_stall_check(void) 61 { 62 int till_stall_check = READ_ONCE(rcu_cpu_stall_timeout); 63 64 /* 65 * Limit check must be consistent with the Kconfig limits 66 * for CONFIG_RCU_CPU_STALL_TIMEOUT. 67 */ 68 if (till_stall_check < 3) { 69 WRITE_ONCE(rcu_cpu_stall_timeout, 3); 70 till_stall_check = 3; 71 } else if (till_stall_check > 300) { 72 WRITE_ONCE(rcu_cpu_stall_timeout, 300); 73 till_stall_check = 300; 74 } 75 return till_stall_check * HZ + RCU_STALL_DELAY_DELTA; 76 } 77 EXPORT_SYMBOL_GPL(rcu_jiffies_till_stall_check); 78 79 /** 80 * rcu_gp_might_be_stalled - Is it likely that the grace period is stalled? 81 * 82 * Returns @true if the current grace period is sufficiently old that 83 * it is reasonable to assume that it might be stalled. This can be 84 * useful when deciding whether to allocate memory to enable RCU-mediated 85 * freeing on the one hand or just invoking synchronize_rcu() on the other. 86 * The latter is preferable when the grace period is stalled. 87 * 88 * Note that sampling of the .gp_start and .gp_seq fields must be done 89 * carefully to avoid false positives at the beginnings and ends of 90 * grace periods. 91 */ 92 bool rcu_gp_might_be_stalled(void) 93 { 94 unsigned long d = rcu_jiffies_till_stall_check() / RCU_STALL_MIGHT_DIV; 95 unsigned long j = jiffies; 96 97 if (d < RCU_STALL_MIGHT_MIN) 98 d = RCU_STALL_MIGHT_MIN; 99 smp_mb(); // jiffies before .gp_seq to avoid false positives. 100 if (!rcu_gp_in_progress()) 101 return false; 102 // Long delays at this point avoids false positive, but a delay 103 // of ULONG_MAX/4 jiffies voids your no-false-positive warranty. 104 smp_mb(); // .gp_seq before second .gp_start 105 // And ditto here. 106 return !time_before(j, READ_ONCE(rcu_state.gp_start) + d); 107 } 108 109 /* Don't do RCU CPU stall warnings during long sysrq printouts. */ 110 void rcu_sysrq_start(void) 111 { 112 if (!rcu_cpu_stall_suppress) 113 rcu_cpu_stall_suppress = 2; 114 } 115 116 void rcu_sysrq_end(void) 117 { 118 if (rcu_cpu_stall_suppress == 2) 119 rcu_cpu_stall_suppress = 0; 120 } 121 122 /* Don't print RCU CPU stall warnings during a kernel panic. */ 123 static int rcu_panic(struct notifier_block *this, unsigned long ev, void *ptr) 124 { 125 rcu_cpu_stall_suppress = 1; 126 return NOTIFY_DONE; 127 } 128 129 static struct notifier_block rcu_panic_block = { 130 .notifier_call = rcu_panic, 131 }; 132 133 static int __init check_cpu_stall_init(void) 134 { 135 atomic_notifier_chain_register(&panic_notifier_list, &rcu_panic_block); 136 return 0; 137 } 138 early_initcall(check_cpu_stall_init); 139 140 /* If so specified via sysctl, panic, yielding cleaner stall-warning output. */ 141 static void panic_on_rcu_stall(void) 142 { 143 static int cpu_stall; 144 145 if (++cpu_stall < sysctl_max_rcu_stall_to_panic) 146 return; 147 148 if (sysctl_panic_on_rcu_stall) 149 panic("RCU Stall\n"); 150 } 151 152 /** 153 * rcu_cpu_stall_reset - restart stall-warning timeout for current grace period 154 * 155 * To perform the reset request from the caller, disable stall detection until 156 * 3 fqs loops have passed. This is required to ensure a fresh jiffies is 157 * loaded. It should be safe to do from the fqs loop as enough timer 158 * interrupts and context switches should have passed. 159 * 160 * The caller must disable hard irqs. 161 */ 162 void rcu_cpu_stall_reset(void) 163 { 164 WRITE_ONCE(rcu_state.nr_fqs_jiffies_stall, 3); 165 WRITE_ONCE(rcu_state.jiffies_stall, ULONG_MAX); 166 } 167 168 ////////////////////////////////////////////////////////////////////////////// 169 // 170 // Interaction with RCU grace periods 171 172 /* Start of new grace period, so record stall time (and forcing times). */ 173 static void record_gp_stall_check_time(void) 174 { 175 unsigned long j = jiffies; 176 unsigned long j1; 177 178 WRITE_ONCE(rcu_state.gp_start, j); 179 j1 = rcu_jiffies_till_stall_check(); 180 smp_mb(); // ->gp_start before ->jiffies_stall and caller's ->gp_seq. 181 WRITE_ONCE(rcu_state.nr_fqs_jiffies_stall, 0); 182 WRITE_ONCE(rcu_state.jiffies_stall, j + j1); 183 rcu_state.jiffies_resched = j + j1 / 2; 184 rcu_state.n_force_qs_gpstart = READ_ONCE(rcu_state.n_force_qs); 185 } 186 187 /* Zero ->ticks_this_gp and snapshot the number of RCU softirq handlers. */ 188 static void zero_cpu_stall_ticks(struct rcu_data *rdp) 189 { 190 rdp->ticks_this_gp = 0; 191 rdp->softirq_snap = kstat_softirqs_cpu(RCU_SOFTIRQ, smp_processor_id()); 192 WRITE_ONCE(rdp->last_fqs_resched, jiffies); 193 } 194 195 /* 196 * If too much time has passed in the current grace period, and if 197 * so configured, go kick the relevant kthreads. 198 */ 199 static void rcu_stall_kick_kthreads(void) 200 { 201 unsigned long j; 202 203 if (!READ_ONCE(rcu_kick_kthreads)) 204 return; 205 j = READ_ONCE(rcu_state.jiffies_kick_kthreads); 206 if (time_after(jiffies, j) && rcu_state.gp_kthread && 207 (rcu_gp_in_progress() || READ_ONCE(rcu_state.gp_flags))) { 208 WARN_ONCE(1, "Kicking %s grace-period kthread\n", 209 rcu_state.name); 210 rcu_ftrace_dump(DUMP_ALL); 211 wake_up_process(rcu_state.gp_kthread); 212 WRITE_ONCE(rcu_state.jiffies_kick_kthreads, j + HZ); 213 } 214 } 215 216 /* 217 * Handler for the irq_work request posted about halfway into the RCU CPU 218 * stall timeout, and used to detect excessive irq disabling. Set state 219 * appropriately, but just complain if there is unexpected state on entry. 220 */ 221 static void rcu_iw_handler(struct irq_work *iwp) 222 { 223 struct rcu_data *rdp; 224 struct rcu_node *rnp; 225 226 rdp = container_of(iwp, struct rcu_data, rcu_iw); 227 rnp = rdp->mynode; 228 raw_spin_lock_rcu_node(rnp); 229 if (!WARN_ON_ONCE(!rdp->rcu_iw_pending)) { 230 rdp->rcu_iw_gp_seq = rnp->gp_seq; 231 rdp->rcu_iw_pending = false; 232 } 233 raw_spin_unlock_rcu_node(rnp); 234 } 235 236 ////////////////////////////////////////////////////////////////////////////// 237 // 238 // Printing RCU CPU stall warnings 239 240 #ifdef CONFIG_PREEMPT_RCU 241 242 /* 243 * Dump detailed information for all tasks blocking the current RCU 244 * grace period on the specified rcu_node structure. 245 */ 246 static void rcu_print_detail_task_stall_rnp(struct rcu_node *rnp) 247 { 248 unsigned long flags; 249 struct task_struct *t; 250 251 raw_spin_lock_irqsave_rcu_node(rnp, flags); 252 if (!rcu_preempt_blocked_readers_cgp(rnp)) { 253 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 254 return; 255 } 256 t = list_entry(rnp->gp_tasks->prev, 257 struct task_struct, rcu_node_entry); 258 list_for_each_entry_continue(t, &rnp->blkd_tasks, rcu_node_entry) { 259 /* 260 * We could be printing a lot while holding a spinlock. 261 * Avoid triggering hard lockup. 262 */ 263 touch_nmi_watchdog(); 264 sched_show_task(t); 265 } 266 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 267 } 268 269 // Communicate task state back to the RCU CPU stall warning request. 270 struct rcu_stall_chk_rdr { 271 int nesting; 272 union rcu_special rs; 273 bool on_blkd_list; 274 }; 275 276 /* 277 * Report out the state of a not-running task that is stalling the 278 * current RCU grace period. 279 */ 280 static int check_slow_task(struct task_struct *t, void *arg) 281 { 282 struct rcu_stall_chk_rdr *rscrp = arg; 283 284 if (task_curr(t)) 285 return -EBUSY; // It is running, so decline to inspect it. 286 rscrp->nesting = t->rcu_read_lock_nesting; 287 rscrp->rs = t->rcu_read_unlock_special; 288 rscrp->on_blkd_list = !list_empty(&t->rcu_node_entry); 289 return 0; 290 } 291 292 /* 293 * Scan the current list of tasks blocked within RCU read-side critical 294 * sections, printing out the tid of each of the first few of them. 295 */ 296 static int rcu_print_task_stall(struct rcu_node *rnp, unsigned long flags) 297 __releases(rnp->lock) 298 { 299 int i = 0; 300 int ndetected = 0; 301 struct rcu_stall_chk_rdr rscr; 302 struct task_struct *t; 303 struct task_struct *ts[8]; 304 305 lockdep_assert_irqs_disabled(); 306 if (!rcu_preempt_blocked_readers_cgp(rnp)) { 307 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 308 return 0; 309 } 310 pr_err("\tTasks blocked on level-%d rcu_node (CPUs %d-%d):", 311 rnp->level, rnp->grplo, rnp->grphi); 312 t = list_entry(rnp->gp_tasks->prev, 313 struct task_struct, rcu_node_entry); 314 list_for_each_entry_continue(t, &rnp->blkd_tasks, rcu_node_entry) { 315 get_task_struct(t); 316 ts[i++] = t; 317 if (i >= ARRAY_SIZE(ts)) 318 break; 319 } 320 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 321 while (i) { 322 t = ts[--i]; 323 if (task_call_func(t, check_slow_task, &rscr)) 324 pr_cont(" P%d", t->pid); 325 else 326 pr_cont(" P%d/%d:%c%c%c%c", 327 t->pid, rscr.nesting, 328 ".b"[rscr.rs.b.blocked], 329 ".q"[rscr.rs.b.need_qs], 330 ".e"[rscr.rs.b.exp_hint], 331 ".l"[rscr.on_blkd_list]); 332 lockdep_assert_irqs_disabled(); 333 put_task_struct(t); 334 ndetected++; 335 } 336 pr_cont("\n"); 337 return ndetected; 338 } 339 340 #else /* #ifdef CONFIG_PREEMPT_RCU */ 341 342 /* 343 * Because preemptible RCU does not exist, we never have to check for 344 * tasks blocked within RCU read-side critical sections. 345 */ 346 static void rcu_print_detail_task_stall_rnp(struct rcu_node *rnp) 347 { 348 } 349 350 /* 351 * Because preemptible RCU does not exist, we never have to check for 352 * tasks blocked within RCU read-side critical sections. 353 */ 354 static int rcu_print_task_stall(struct rcu_node *rnp, unsigned long flags) 355 __releases(rnp->lock) 356 { 357 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 358 return 0; 359 } 360 #endif /* #else #ifdef CONFIG_PREEMPT_RCU */ 361 362 /* 363 * Dump stacks of all tasks running on stalled CPUs. First try using 364 * NMIs, but fall back to manual remote stack tracing on architectures 365 * that don't support NMI-based stack dumps. The NMI-triggered stack 366 * traces are more accurate because they are printed by the target CPU. 367 */ 368 static void rcu_dump_cpu_stacks(void) 369 { 370 int cpu; 371 unsigned long flags; 372 struct rcu_node *rnp; 373 374 rcu_for_each_leaf_node(rnp) { 375 printk_deferred_enter(); 376 raw_spin_lock_irqsave_rcu_node(rnp, flags); 377 for_each_leaf_node_possible_cpu(rnp, cpu) 378 if (rnp->qsmask & leaf_node_cpu_bit(rnp, cpu)) { 379 if (cpu_is_offline(cpu)) 380 pr_err("Offline CPU %d blocking current GP.\n", cpu); 381 else 382 dump_cpu_task(cpu); 383 } 384 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 385 printk_deferred_exit(); 386 } 387 } 388 389 static const char * const gp_state_names[] = { 390 [RCU_GP_IDLE] = "RCU_GP_IDLE", 391 [RCU_GP_WAIT_GPS] = "RCU_GP_WAIT_GPS", 392 [RCU_GP_DONE_GPS] = "RCU_GP_DONE_GPS", 393 [RCU_GP_ONOFF] = "RCU_GP_ONOFF", 394 [RCU_GP_INIT] = "RCU_GP_INIT", 395 [RCU_GP_WAIT_FQS] = "RCU_GP_WAIT_FQS", 396 [RCU_GP_DOING_FQS] = "RCU_GP_DOING_FQS", 397 [RCU_GP_CLEANUP] = "RCU_GP_CLEANUP", 398 [RCU_GP_CLEANED] = "RCU_GP_CLEANED", 399 }; 400 401 /* 402 * Convert a ->gp_state value to a character string. 403 */ 404 static const char *gp_state_getname(short gs) 405 { 406 if (gs < 0 || gs >= ARRAY_SIZE(gp_state_names)) 407 return "???"; 408 return gp_state_names[gs]; 409 } 410 411 /* Is the RCU grace-period kthread being starved of CPU time? */ 412 static bool rcu_is_gp_kthread_starving(unsigned long *jp) 413 { 414 unsigned long j = jiffies - READ_ONCE(rcu_state.gp_activity); 415 416 if (jp) 417 *jp = j; 418 return j > 2 * HZ; 419 } 420 421 static bool rcu_is_rcuc_kthread_starving(struct rcu_data *rdp, unsigned long *jp) 422 { 423 int cpu; 424 struct task_struct *rcuc; 425 unsigned long j; 426 427 rcuc = rdp->rcu_cpu_kthread_task; 428 if (!rcuc) 429 return false; 430 431 cpu = task_cpu(rcuc); 432 if (cpu_is_offline(cpu) || idle_cpu(cpu)) 433 return false; 434 435 j = jiffies - READ_ONCE(rdp->rcuc_activity); 436 437 if (jp) 438 *jp = j; 439 return j > 2 * HZ; 440 } 441 442 static void print_cpu_stat_info(int cpu) 443 { 444 struct rcu_snap_record rsr, *rsrp; 445 struct rcu_data *rdp = per_cpu_ptr(&rcu_data, cpu); 446 struct kernel_cpustat *kcsp = &kcpustat_cpu(cpu); 447 448 if (!rcu_cpu_stall_cputime) 449 return; 450 451 rsrp = &rdp->snap_record; 452 if (rsrp->gp_seq != rdp->gp_seq) 453 return; 454 455 rsr.cputime_irq = kcpustat_field(kcsp, CPUTIME_IRQ, cpu); 456 rsr.cputime_softirq = kcpustat_field(kcsp, CPUTIME_SOFTIRQ, cpu); 457 rsr.cputime_system = kcpustat_field(kcsp, CPUTIME_SYSTEM, cpu); 458 459 pr_err("\t hardirqs softirqs csw/system\n"); 460 pr_err("\t number: %8ld %10d %12lld\n", 461 kstat_cpu_irqs_sum(cpu) - rsrp->nr_hardirqs, 462 kstat_cpu_softirqs_sum(cpu) - rsrp->nr_softirqs, 463 nr_context_switches_cpu(cpu) - rsrp->nr_csw); 464 pr_err("\tcputime: %8lld %10lld %12lld ==> %d(ms)\n", 465 div_u64(rsr.cputime_irq - rsrp->cputime_irq, NSEC_PER_MSEC), 466 div_u64(rsr.cputime_softirq - rsrp->cputime_softirq, NSEC_PER_MSEC), 467 div_u64(rsr.cputime_system - rsrp->cputime_system, NSEC_PER_MSEC), 468 jiffies_to_msecs(jiffies - rsrp->jiffies)); 469 } 470 471 /* 472 * Print out diagnostic information for the specified stalled CPU. 473 * 474 * If the specified CPU is aware of the current RCU grace period, then 475 * print the number of scheduling clock interrupts the CPU has taken 476 * during the time that it has been aware. Otherwise, print the number 477 * of RCU grace periods that this CPU is ignorant of, for example, "1" 478 * if the CPU was aware of the previous grace period. 479 * 480 * Also print out idle info. 481 */ 482 static void print_cpu_stall_info(int cpu) 483 { 484 unsigned long delta; 485 bool falsepositive; 486 struct rcu_data *rdp = per_cpu_ptr(&rcu_data, cpu); 487 char *ticks_title; 488 unsigned long ticks_value; 489 bool rcuc_starved; 490 unsigned long j; 491 char buf[32]; 492 493 /* 494 * We could be printing a lot while holding a spinlock. Avoid 495 * triggering hard lockup. 496 */ 497 touch_nmi_watchdog(); 498 499 ticks_value = rcu_seq_ctr(rcu_state.gp_seq - rdp->gp_seq); 500 if (ticks_value) { 501 ticks_title = "GPs behind"; 502 } else { 503 ticks_title = "ticks this GP"; 504 ticks_value = rdp->ticks_this_gp; 505 } 506 delta = rcu_seq_ctr(rdp->mynode->gp_seq - rdp->rcu_iw_gp_seq); 507 falsepositive = rcu_is_gp_kthread_starving(NULL) && 508 rcu_watching_snap_in_eqs(ct_rcu_watching_cpu(cpu)); 509 rcuc_starved = rcu_is_rcuc_kthread_starving(rdp, &j); 510 if (rcuc_starved) 511 // Print signed value, as negative values indicate a probable bug. 512 snprintf(buf, sizeof(buf), " rcuc=%ld jiffies(starved)", j); 513 pr_err("\t%d-%c%c%c%c: (%lu %s) idle=%04x/%ld/%#lx softirq=%u/%u fqs=%ld%s%s\n", 514 cpu, 515 "O."[!!cpu_online(cpu)], 516 "o."[!!(rdp->grpmask & rdp->mynode->qsmaskinit)], 517 "N."[!!(rdp->grpmask & rdp->mynode->qsmaskinitnext)], 518 !IS_ENABLED(CONFIG_IRQ_WORK) ? '?' : 519 rdp->rcu_iw_pending ? (int)min(delta, 9UL) + '0' : 520 "!."[!delta], 521 ticks_value, ticks_title, 522 ct_rcu_watching_cpu(cpu) & 0xffff, 523 ct_nesting_cpu(cpu), ct_nmi_nesting_cpu(cpu), 524 rdp->softirq_snap, kstat_softirqs_cpu(RCU_SOFTIRQ, cpu), 525 data_race(rcu_state.n_force_qs) - rcu_state.n_force_qs_gpstart, 526 rcuc_starved ? buf : "", 527 falsepositive ? " (false positive?)" : ""); 528 529 print_cpu_stat_info(cpu); 530 } 531 532 /* Complain about starvation of grace-period kthread. */ 533 static void rcu_check_gp_kthread_starvation(void) 534 { 535 int cpu; 536 struct task_struct *gpk = rcu_state.gp_kthread; 537 unsigned long j; 538 539 if (rcu_is_gp_kthread_starving(&j)) { 540 cpu = gpk ? task_cpu(gpk) : -1; 541 pr_err("%s kthread starved for %ld jiffies! g%ld f%#x %s(%d) ->state=%#x ->cpu=%d\n", 542 rcu_state.name, j, 543 (long)rcu_seq_current(&rcu_state.gp_seq), 544 data_race(READ_ONCE(rcu_state.gp_flags)), 545 gp_state_getname(rcu_state.gp_state), 546 data_race(READ_ONCE(rcu_state.gp_state)), 547 gpk ? data_race(READ_ONCE(gpk->__state)) : ~0, cpu); 548 if (gpk) { 549 struct rcu_data *rdp = per_cpu_ptr(&rcu_data, cpu); 550 551 pr_err("\tUnless %s kthread gets sufficient CPU time, OOM is now expected behavior.\n", rcu_state.name); 552 pr_err("RCU grace-period kthread stack dump:\n"); 553 sched_show_task(gpk); 554 if (cpu_is_offline(cpu)) { 555 pr_err("RCU GP kthread last ran on offline CPU %d.\n", cpu); 556 } else if (!(data_race(READ_ONCE(rdp->mynode->qsmask)) & rdp->grpmask)) { 557 pr_err("Stack dump where RCU GP kthread last ran:\n"); 558 dump_cpu_task(cpu); 559 } 560 wake_up_process(gpk); 561 } 562 } 563 } 564 565 /* Complain about missing wakeups from expired fqs wait timer */ 566 static void rcu_check_gp_kthread_expired_fqs_timer(void) 567 { 568 struct task_struct *gpk = rcu_state.gp_kthread; 569 short gp_state; 570 unsigned long jiffies_fqs; 571 int cpu; 572 573 /* 574 * Order reads of .gp_state and .jiffies_force_qs. 575 * Matching smp_wmb() is present in rcu_gp_fqs_loop(). 576 */ 577 gp_state = smp_load_acquire(&rcu_state.gp_state); 578 jiffies_fqs = READ_ONCE(rcu_state.jiffies_force_qs); 579 580 if (gp_state == RCU_GP_WAIT_FQS && 581 time_after(jiffies, jiffies_fqs + RCU_STALL_MIGHT_MIN) && 582 gpk && !READ_ONCE(gpk->on_rq)) { 583 cpu = task_cpu(gpk); 584 pr_err("%s kthread timer wakeup didn't happen for %ld jiffies! g%ld f%#x %s(%d) ->state=%#x\n", 585 rcu_state.name, (jiffies - jiffies_fqs), 586 (long)rcu_seq_current(&rcu_state.gp_seq), 587 data_race(READ_ONCE(rcu_state.gp_flags)), // Diagnostic read 588 gp_state_getname(RCU_GP_WAIT_FQS), RCU_GP_WAIT_FQS, 589 data_race(READ_ONCE(gpk->__state))); 590 pr_err("\tPossible timer handling issue on cpu=%d timer-softirq=%u\n", 591 cpu, kstat_softirqs_cpu(TIMER_SOFTIRQ, cpu)); 592 } 593 } 594 595 static void print_other_cpu_stall(unsigned long gp_seq, unsigned long gps) 596 { 597 int cpu; 598 unsigned long flags; 599 unsigned long gpa; 600 unsigned long j; 601 int ndetected = 0; 602 struct rcu_node *rnp; 603 long totqlen = 0; 604 605 lockdep_assert_irqs_disabled(); 606 607 /* Kick and suppress, if so configured. */ 608 rcu_stall_kick_kthreads(); 609 if (rcu_stall_is_suppressed()) 610 return; 611 612 nbcon_cpu_emergency_enter(); 613 614 /* 615 * OK, time to rat on our buddy... 616 * See Documentation/RCU/stallwarn.rst for info on how to debug 617 * RCU CPU stall warnings. 618 */ 619 trace_rcu_stall_warning(rcu_state.name, TPS("StallDetected")); 620 pr_err("INFO: %s detected stalls on CPUs/tasks:\n", rcu_state.name); 621 rcu_for_each_leaf_node(rnp) { 622 raw_spin_lock_irqsave_rcu_node(rnp, flags); 623 if (rnp->qsmask != 0) { 624 for_each_leaf_node_possible_cpu(rnp, cpu) 625 if (rnp->qsmask & leaf_node_cpu_bit(rnp, cpu)) { 626 print_cpu_stall_info(cpu); 627 ndetected++; 628 } 629 } 630 ndetected += rcu_print_task_stall(rnp, flags); // Releases rnp->lock. 631 lockdep_assert_irqs_disabled(); 632 } 633 634 for_each_possible_cpu(cpu) 635 totqlen += rcu_get_n_cbs_cpu(cpu); 636 pr_err("\t(detected by %d, t=%ld jiffies, g=%ld, q=%lu ncpus=%d)\n", 637 smp_processor_id(), (long)(jiffies - gps), 638 (long)rcu_seq_current(&rcu_state.gp_seq), totqlen, 639 data_race(rcu_state.n_online_cpus)); // Diagnostic read 640 if (ndetected) { 641 rcu_dump_cpu_stacks(); 642 643 /* Complain about tasks blocking the grace period. */ 644 rcu_for_each_leaf_node(rnp) 645 rcu_print_detail_task_stall_rnp(rnp); 646 } else { 647 if (rcu_seq_current(&rcu_state.gp_seq) != gp_seq) { 648 pr_err("INFO: Stall ended before state dump start\n"); 649 } else { 650 j = jiffies; 651 gpa = data_race(READ_ONCE(rcu_state.gp_activity)); 652 pr_err("All QSes seen, last %s kthread activity %ld (%ld-%ld), jiffies_till_next_fqs=%ld, root ->qsmask %#lx\n", 653 rcu_state.name, j - gpa, j, gpa, 654 data_race(READ_ONCE(jiffies_till_next_fqs)), 655 data_race(READ_ONCE(rcu_get_root()->qsmask))); 656 } 657 } 658 /* Rewrite if needed in case of slow consoles. */ 659 if (ULONG_CMP_GE(jiffies, READ_ONCE(rcu_state.jiffies_stall))) 660 WRITE_ONCE(rcu_state.jiffies_stall, 661 jiffies + 3 * rcu_jiffies_till_stall_check() + 3); 662 663 rcu_check_gp_kthread_expired_fqs_timer(); 664 rcu_check_gp_kthread_starvation(); 665 666 nbcon_cpu_emergency_exit(); 667 668 panic_on_rcu_stall(); 669 670 rcu_force_quiescent_state(); /* Kick them all. */ 671 } 672 673 static void print_cpu_stall(unsigned long gps) 674 { 675 int cpu; 676 unsigned long flags; 677 struct rcu_data *rdp = this_cpu_ptr(&rcu_data); 678 struct rcu_node *rnp = rcu_get_root(); 679 long totqlen = 0; 680 681 lockdep_assert_irqs_disabled(); 682 683 /* Kick and suppress, if so configured. */ 684 rcu_stall_kick_kthreads(); 685 if (rcu_stall_is_suppressed()) 686 return; 687 688 nbcon_cpu_emergency_enter(); 689 690 /* 691 * OK, time to rat on ourselves... 692 * See Documentation/RCU/stallwarn.rst for info on how to debug 693 * RCU CPU stall warnings. 694 */ 695 trace_rcu_stall_warning(rcu_state.name, TPS("SelfDetected")); 696 pr_err("INFO: %s self-detected stall on CPU\n", rcu_state.name); 697 raw_spin_lock_irqsave_rcu_node(rdp->mynode, flags); 698 print_cpu_stall_info(smp_processor_id()); 699 raw_spin_unlock_irqrestore_rcu_node(rdp->mynode, flags); 700 for_each_possible_cpu(cpu) 701 totqlen += rcu_get_n_cbs_cpu(cpu); 702 pr_err("\t(t=%lu jiffies g=%ld q=%lu ncpus=%d)\n", 703 jiffies - gps, 704 (long)rcu_seq_current(&rcu_state.gp_seq), totqlen, 705 data_race(rcu_state.n_online_cpus)); // Diagnostic read 706 707 rcu_check_gp_kthread_expired_fqs_timer(); 708 rcu_check_gp_kthread_starvation(); 709 710 rcu_dump_cpu_stacks(); 711 712 raw_spin_lock_irqsave_rcu_node(rnp, flags); 713 /* Rewrite if needed in case of slow consoles. */ 714 if (ULONG_CMP_GE(jiffies, READ_ONCE(rcu_state.jiffies_stall))) 715 WRITE_ONCE(rcu_state.jiffies_stall, 716 jiffies + 3 * rcu_jiffies_till_stall_check() + 3); 717 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 718 719 nbcon_cpu_emergency_exit(); 720 721 panic_on_rcu_stall(); 722 723 /* 724 * Attempt to revive the RCU machinery by forcing a context switch. 725 * 726 * A context switch would normally allow the RCU state machine to make 727 * progress and it could be we're stuck in kernel space without context 728 * switches for an entirely unreasonable amount of time. 729 */ 730 set_tsk_need_resched(current); 731 set_preempt_need_resched(); 732 } 733 734 static bool csd_lock_suppress_rcu_stall; 735 module_param(csd_lock_suppress_rcu_stall, bool, 0644); 736 737 static void check_cpu_stall(struct rcu_data *rdp) 738 { 739 bool self_detected; 740 unsigned long gs1; 741 unsigned long gs2; 742 unsigned long gps; 743 unsigned long j; 744 unsigned long jn; 745 unsigned long js; 746 struct rcu_node *rnp; 747 748 lockdep_assert_irqs_disabled(); 749 if ((rcu_stall_is_suppressed() && !READ_ONCE(rcu_kick_kthreads)) || 750 !rcu_gp_in_progress()) 751 return; 752 rcu_stall_kick_kthreads(); 753 754 /* 755 * Check if it was requested (via rcu_cpu_stall_reset()) that the FQS 756 * loop has to set jiffies to ensure a non-stale jiffies value. This 757 * is required to have good jiffies value after coming out of long 758 * breaks of jiffies updates. Not doing so can cause false positives. 759 */ 760 if (READ_ONCE(rcu_state.nr_fqs_jiffies_stall) > 0) 761 return; 762 763 j = jiffies; 764 765 /* 766 * Lots of memory barriers to reject false positives. 767 * 768 * The idea is to pick up rcu_state.gp_seq, then 769 * rcu_state.jiffies_stall, then rcu_state.gp_start, and finally 770 * another copy of rcu_state.gp_seq. These values are updated in 771 * the opposite order with memory barriers (or equivalent) during 772 * grace-period initialization and cleanup. Now, a false positive 773 * can occur if we get an new value of rcu_state.gp_start and a old 774 * value of rcu_state.jiffies_stall. But given the memory barriers, 775 * the only way that this can happen is if one grace period ends 776 * and another starts between these two fetches. This is detected 777 * by comparing the second fetch of rcu_state.gp_seq with the 778 * previous fetch from rcu_state.gp_seq. 779 * 780 * Given this check, comparisons of jiffies, rcu_state.jiffies_stall, 781 * and rcu_state.gp_start suffice to forestall false positives. 782 */ 783 gs1 = READ_ONCE(rcu_state.gp_seq); 784 smp_rmb(); /* Pick up ->gp_seq first... */ 785 js = READ_ONCE(rcu_state.jiffies_stall); 786 smp_rmb(); /* ...then ->jiffies_stall before the rest... */ 787 gps = READ_ONCE(rcu_state.gp_start); 788 smp_rmb(); /* ...and finally ->gp_start before ->gp_seq again. */ 789 gs2 = READ_ONCE(rcu_state.gp_seq); 790 if (gs1 != gs2 || 791 ULONG_CMP_LT(j, js) || 792 ULONG_CMP_GE(gps, js)) 793 return; /* No stall or GP completed since entering function. */ 794 rnp = rdp->mynode; 795 jn = jiffies + ULONG_MAX / 2; 796 self_detected = READ_ONCE(rnp->qsmask) & rdp->grpmask; 797 if (rcu_gp_in_progress() && 798 (self_detected || ULONG_CMP_GE(j, js + RCU_STALL_RAT_DELAY)) && 799 cmpxchg(&rcu_state.jiffies_stall, js, jn) == js) { 800 /* 801 * If a virtual machine is stopped by the host it can look to 802 * the watchdog like an RCU stall. Check to see if the host 803 * stopped the vm. 804 */ 805 if (kvm_check_and_clear_guest_paused()) 806 return; 807 808 rcu_stall_notifier_call_chain(RCU_STALL_NOTIFY_NORM, (void *)j - gps); 809 if (READ_ONCE(csd_lock_suppress_rcu_stall) && csd_lock_is_stuck()) { 810 pr_err("INFO: %s detected stall, but suppressed full report due to a stuck CSD-lock.\n", rcu_state.name); 811 } else if (self_detected) { 812 /* We haven't checked in, so go dump stack. */ 813 print_cpu_stall(gps); 814 } else { 815 /* They had a few time units to dump stack, so complain. */ 816 print_other_cpu_stall(gs2, gps); 817 } 818 819 if (READ_ONCE(rcu_cpu_stall_ftrace_dump)) 820 rcu_ftrace_dump(DUMP_ALL); 821 822 if (READ_ONCE(rcu_state.jiffies_stall) == jn) { 823 jn = jiffies + 3 * rcu_jiffies_till_stall_check() + 3; 824 WRITE_ONCE(rcu_state.jiffies_stall, jn); 825 } 826 } 827 } 828 829 ////////////////////////////////////////////////////////////////////////////// 830 // 831 // RCU forward-progress mechanisms, including for callback invocation. 832 833 834 /* 835 * Check to see if a failure to end RCU priority inversion was due to 836 * a CPU not passing through a quiescent state. When this happens, there 837 * is nothing that RCU priority boosting can do to help, so we shouldn't 838 * count this as an RCU priority boosting failure. A return of true says 839 * RCU priority boosting is to blame, and false says otherwise. If false 840 * is returned, the first of the CPUs to blame is stored through cpup. 841 * If there was no CPU blocking the current grace period, but also nothing 842 * in need of being boosted, *cpup is set to -1. This can happen in case 843 * of vCPU preemption while the last CPU is reporting its quiscent state, 844 * for example. 845 * 846 * If cpup is NULL, then a lockless quick check is carried out, suitable 847 * for high-rate usage. On the other hand, if cpup is non-NULL, each 848 * rcu_node structure's ->lock is acquired, ruling out high-rate usage. 849 */ 850 bool rcu_check_boost_fail(unsigned long gp_state, int *cpup) 851 { 852 bool atb = false; 853 int cpu; 854 unsigned long flags; 855 struct rcu_node *rnp; 856 857 rcu_for_each_leaf_node(rnp) { 858 if (!cpup) { 859 if (data_race(READ_ONCE(rnp->qsmask))) { 860 return false; 861 } else { 862 if (READ_ONCE(rnp->gp_tasks)) 863 atb = true; 864 continue; 865 } 866 } 867 *cpup = -1; 868 raw_spin_lock_irqsave_rcu_node(rnp, flags); 869 if (rnp->gp_tasks) 870 atb = true; 871 if (!rnp->qsmask) { 872 // No CPUs without quiescent states for this rnp. 873 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 874 continue; 875 } 876 // Find the first holdout CPU. 877 for_each_leaf_node_possible_cpu(rnp, cpu) { 878 if (rnp->qsmask & (1UL << (cpu - rnp->grplo))) { 879 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 880 *cpup = cpu; 881 return false; 882 } 883 } 884 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 885 } 886 // Can't blame CPUs, so must blame RCU priority boosting. 887 return atb; 888 } 889 EXPORT_SYMBOL_GPL(rcu_check_boost_fail); 890 891 /* 892 * Show the state of the grace-period kthreads. 893 */ 894 void show_rcu_gp_kthreads(void) 895 { 896 unsigned long cbs = 0; 897 int cpu; 898 unsigned long j; 899 unsigned long ja; 900 unsigned long jr; 901 unsigned long js; 902 unsigned long jw; 903 struct rcu_data *rdp; 904 struct rcu_node *rnp; 905 struct task_struct *t = READ_ONCE(rcu_state.gp_kthread); 906 907 j = jiffies; 908 ja = j - data_race(READ_ONCE(rcu_state.gp_activity)); 909 jr = j - data_race(READ_ONCE(rcu_state.gp_req_activity)); 910 js = j - data_race(READ_ONCE(rcu_state.gp_start)); 911 jw = j - data_race(READ_ONCE(rcu_state.gp_wake_time)); 912 pr_info("%s: wait state: %s(%d) ->state: %#x ->rt_priority %u delta ->gp_start %lu ->gp_activity %lu ->gp_req_activity %lu ->gp_wake_time %lu ->gp_wake_seq %ld ->gp_seq %ld ->gp_seq_needed %ld ->gp_max %lu ->gp_flags %#x\n", 913 rcu_state.name, gp_state_getname(rcu_state.gp_state), 914 data_race(READ_ONCE(rcu_state.gp_state)), 915 t ? data_race(READ_ONCE(t->__state)) : 0x1ffff, t ? t->rt_priority : 0xffU, 916 js, ja, jr, jw, (long)data_race(READ_ONCE(rcu_state.gp_wake_seq)), 917 (long)data_race(READ_ONCE(rcu_state.gp_seq)), 918 (long)data_race(READ_ONCE(rcu_get_root()->gp_seq_needed)), 919 data_race(READ_ONCE(rcu_state.gp_max)), 920 data_race(READ_ONCE(rcu_state.gp_flags))); 921 rcu_for_each_node_breadth_first(rnp) { 922 if (ULONG_CMP_GE(READ_ONCE(rcu_state.gp_seq), READ_ONCE(rnp->gp_seq_needed)) && 923 !data_race(READ_ONCE(rnp->qsmask)) && !data_race(READ_ONCE(rnp->boost_tasks)) && 924 !data_race(READ_ONCE(rnp->exp_tasks)) && !data_race(READ_ONCE(rnp->gp_tasks))) 925 continue; 926 pr_info("\trcu_node %d:%d ->gp_seq %ld ->gp_seq_needed %ld ->qsmask %#lx %c%c%c%c ->n_boosts %ld\n", 927 rnp->grplo, rnp->grphi, 928 (long)data_race(READ_ONCE(rnp->gp_seq)), 929 (long)data_race(READ_ONCE(rnp->gp_seq_needed)), 930 data_race(READ_ONCE(rnp->qsmask)), 931 ".b"[!!data_race(READ_ONCE(rnp->boost_kthread_task))], 932 ".B"[!!data_race(READ_ONCE(rnp->boost_tasks))], 933 ".E"[!!data_race(READ_ONCE(rnp->exp_tasks))], 934 ".G"[!!data_race(READ_ONCE(rnp->gp_tasks))], 935 data_race(READ_ONCE(rnp->n_boosts))); 936 if (!rcu_is_leaf_node(rnp)) 937 continue; 938 for_each_leaf_node_possible_cpu(rnp, cpu) { 939 rdp = per_cpu_ptr(&rcu_data, cpu); 940 if (READ_ONCE(rdp->gpwrap) || 941 ULONG_CMP_GE(READ_ONCE(rcu_state.gp_seq), 942 READ_ONCE(rdp->gp_seq_needed))) 943 continue; 944 pr_info("\tcpu %d ->gp_seq_needed %ld\n", 945 cpu, (long)data_race(READ_ONCE(rdp->gp_seq_needed))); 946 } 947 } 948 for_each_possible_cpu(cpu) { 949 rdp = per_cpu_ptr(&rcu_data, cpu); 950 cbs += data_race(READ_ONCE(rdp->n_cbs_invoked)); 951 if (rcu_segcblist_is_offloaded(&rdp->cblist)) 952 show_rcu_nocb_state(rdp); 953 } 954 pr_info("RCU callbacks invoked since boot: %lu\n", cbs); 955 show_rcu_tasks_gp_kthreads(); 956 } 957 EXPORT_SYMBOL_GPL(show_rcu_gp_kthreads); 958 959 /* 960 * This function checks for grace-period requests that fail to motivate 961 * RCU to come out of its idle mode. 962 */ 963 static void rcu_check_gp_start_stall(struct rcu_node *rnp, struct rcu_data *rdp, 964 const unsigned long gpssdelay) 965 { 966 unsigned long flags; 967 unsigned long j; 968 struct rcu_node *rnp_root = rcu_get_root(); 969 static atomic_t warned = ATOMIC_INIT(0); 970 971 if (!IS_ENABLED(CONFIG_PROVE_RCU) || rcu_gp_in_progress() || 972 ULONG_CMP_GE(READ_ONCE(rnp_root->gp_seq), 973 READ_ONCE(rnp_root->gp_seq_needed)) || 974 !smp_load_acquire(&rcu_state.gp_kthread)) // Get stable kthread. 975 return; 976 j = jiffies; /* Expensive access, and in common case don't get here. */ 977 if (time_before(j, READ_ONCE(rcu_state.gp_req_activity) + gpssdelay) || 978 time_before(j, READ_ONCE(rcu_state.gp_activity) + gpssdelay) || 979 atomic_read(&warned)) 980 return; 981 982 raw_spin_lock_irqsave_rcu_node(rnp, flags); 983 j = jiffies; 984 if (rcu_gp_in_progress() || 985 ULONG_CMP_GE(READ_ONCE(rnp_root->gp_seq), 986 READ_ONCE(rnp_root->gp_seq_needed)) || 987 time_before(j, READ_ONCE(rcu_state.gp_req_activity) + gpssdelay) || 988 time_before(j, READ_ONCE(rcu_state.gp_activity) + gpssdelay) || 989 atomic_read(&warned)) { 990 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 991 return; 992 } 993 /* Hold onto the leaf lock to make others see warned==1. */ 994 995 if (rnp_root != rnp) 996 raw_spin_lock_rcu_node(rnp_root); /* irqs already disabled. */ 997 j = jiffies; 998 if (rcu_gp_in_progress() || 999 ULONG_CMP_GE(READ_ONCE(rnp_root->gp_seq), 1000 READ_ONCE(rnp_root->gp_seq_needed)) || 1001 time_before(j, READ_ONCE(rcu_state.gp_req_activity) + gpssdelay) || 1002 time_before(j, READ_ONCE(rcu_state.gp_activity) + gpssdelay) || 1003 atomic_xchg(&warned, 1)) { 1004 if (rnp_root != rnp) 1005 /* irqs remain disabled. */ 1006 raw_spin_unlock_rcu_node(rnp_root); 1007 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 1008 return; 1009 } 1010 WARN_ON(1); 1011 if (rnp_root != rnp) 1012 raw_spin_unlock_rcu_node(rnp_root); 1013 raw_spin_unlock_irqrestore_rcu_node(rnp, flags); 1014 show_rcu_gp_kthreads(); 1015 } 1016 1017 /* 1018 * Do a forward-progress check for rcutorture. This is normally invoked 1019 * due to an OOM event. The argument "j" gives the time period during 1020 * which rcutorture would like progress to have been made. 1021 */ 1022 void rcu_fwd_progress_check(unsigned long j) 1023 { 1024 unsigned long cbs; 1025 int cpu; 1026 unsigned long max_cbs = 0; 1027 int max_cpu = -1; 1028 struct rcu_data *rdp; 1029 1030 if (rcu_gp_in_progress()) { 1031 pr_info("%s: GP age %lu jiffies\n", 1032 __func__, jiffies - data_race(READ_ONCE(rcu_state.gp_start))); 1033 show_rcu_gp_kthreads(); 1034 } else { 1035 pr_info("%s: Last GP end %lu jiffies ago\n", 1036 __func__, jiffies - data_race(READ_ONCE(rcu_state.gp_end))); 1037 preempt_disable(); 1038 rdp = this_cpu_ptr(&rcu_data); 1039 rcu_check_gp_start_stall(rdp->mynode, rdp, j); 1040 preempt_enable(); 1041 } 1042 for_each_possible_cpu(cpu) { 1043 cbs = rcu_get_n_cbs_cpu(cpu); 1044 if (!cbs) 1045 continue; 1046 if (max_cpu < 0) 1047 pr_info("%s: callbacks", __func__); 1048 pr_cont(" %d: %lu", cpu, cbs); 1049 if (cbs <= max_cbs) 1050 continue; 1051 max_cbs = cbs; 1052 max_cpu = cpu; 1053 } 1054 if (max_cpu >= 0) 1055 pr_cont("\n"); 1056 } 1057 EXPORT_SYMBOL_GPL(rcu_fwd_progress_check); 1058 1059 /* Commandeer a sysrq key to dump RCU's tree. */ 1060 static bool sysrq_rcu; 1061 module_param(sysrq_rcu, bool, 0444); 1062 1063 /* Dump grace-period-request information due to commandeered sysrq. */ 1064 static void sysrq_show_rcu(u8 key) 1065 { 1066 show_rcu_gp_kthreads(); 1067 } 1068 1069 static const struct sysrq_key_op sysrq_rcudump_op = { 1070 .handler = sysrq_show_rcu, 1071 .help_msg = "show-rcu(y)", 1072 .action_msg = "Show RCU tree", 1073 .enable_mask = SYSRQ_ENABLE_DUMP, 1074 }; 1075 1076 static int __init rcu_sysrq_init(void) 1077 { 1078 if (sysrq_rcu) 1079 return register_sysrq_key('y', &sysrq_rcudump_op); 1080 return 0; 1081 } 1082 early_initcall(rcu_sysrq_init); 1083 1084 #ifdef CONFIG_RCU_CPU_STALL_NOTIFIER 1085 1086 ////////////////////////////////////////////////////////////////////////////// 1087 // 1088 // RCU CPU stall-warning notifiers 1089 1090 static ATOMIC_NOTIFIER_HEAD(rcu_cpu_stall_notifier_list); 1091 1092 /** 1093 * rcu_stall_chain_notifier_register - Add an RCU CPU stall notifier 1094 * @n: Entry to add. 1095 * 1096 * Adds an RCU CPU stall notifier to an atomic notifier chain. 1097 * The @action passed to a notifier will be @RCU_STALL_NOTIFY_NORM or 1098 * friends. The @data will be the duration of the stalled grace period, 1099 * in jiffies, coerced to a void* pointer. 1100 * 1101 * Returns 0 on success, %-EEXIST on error. 1102 */ 1103 int rcu_stall_chain_notifier_register(struct notifier_block *n) 1104 { 1105 int rcsn = rcu_cpu_stall_notifiers; 1106 1107 WARN(1, "Adding %pS() to RCU stall notifier list (%s).\n", n->notifier_call, 1108 rcsn ? "possibly suppressing RCU CPU stall warnings" : "failed, so all is well"); 1109 if (rcsn) 1110 return atomic_notifier_chain_register(&rcu_cpu_stall_notifier_list, n); 1111 return -EEXIST; 1112 } 1113 EXPORT_SYMBOL_GPL(rcu_stall_chain_notifier_register); 1114 1115 /** 1116 * rcu_stall_chain_notifier_unregister - Remove an RCU CPU stall notifier 1117 * @n: Entry to add. 1118 * 1119 * Removes an RCU CPU stall notifier from an atomic notifier chain. 1120 * 1121 * Returns zero on success, %-ENOENT on failure. 1122 */ 1123 int rcu_stall_chain_notifier_unregister(struct notifier_block *n) 1124 { 1125 return atomic_notifier_chain_unregister(&rcu_cpu_stall_notifier_list, n); 1126 } 1127 EXPORT_SYMBOL_GPL(rcu_stall_chain_notifier_unregister); 1128 1129 /* 1130 * rcu_stall_notifier_call_chain - Call functions in an RCU CPU stall notifier chain 1131 * @val: Value passed unmodified to notifier function 1132 * @v: Pointer passed unmodified to notifier function 1133 * 1134 * Calls each function in the RCU CPU stall notifier chain in turn, which 1135 * is an atomic call chain. See atomic_notifier_call_chain() for more 1136 * information. 1137 * 1138 * This is for use within RCU, hence the omission of the extra asterisk 1139 * to indicate a non-kerneldoc format header comment. 1140 */ 1141 int rcu_stall_notifier_call_chain(unsigned long val, void *v) 1142 { 1143 return atomic_notifier_call_chain(&rcu_cpu_stall_notifier_list, val, v); 1144 } 1145 1146 #endif // #ifdef CONFIG_RCU_CPU_STALL_NOTIFIER 1147