rcu: Make TINY_RCU also use softirq for RCU_BOOST=n
[deliverable/linux.git] / kernel / rcutree.c
CommitLineData
64db4cff
PM
1/*
2 * Read-Copy Update mechanism for mutual exclusion
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
17 *
18 * Copyright IBM Corporation, 2008
19 *
20 * Authors: Dipankar Sarma <dipankar@in.ibm.com>
21 * Manfred Spraul <manfred@colorfullife.com>
22 * Paul E. McKenney <paulmck@linux.vnet.ibm.com> Hierarchical version
23 *
24 * Based on the original work by Paul McKenney <paulmck@us.ibm.com>
25 * and inputs from Rusty Russell, Andrea Arcangeli and Andi Kleen.
26 *
27 * For detailed explanation of Read-Copy Update mechanism see -
a71fca58 28 * Documentation/RCU
64db4cff
PM
29 */
30#include <linux/types.h>
31#include <linux/kernel.h>
32#include <linux/init.h>
33#include <linux/spinlock.h>
34#include <linux/smp.h>
35#include <linux/rcupdate.h>
36#include <linux/interrupt.h>
37#include <linux/sched.h>
c1dc0b9c 38#include <linux/nmi.h>
8826f3b0 39#include <linux/atomic.h>
64db4cff
PM
40#include <linux/bitops.h>
41#include <linux/module.h>
42#include <linux/completion.h>
43#include <linux/moduleparam.h>
44#include <linux/percpu.h>
45#include <linux/notifier.h>
46#include <linux/cpu.h>
47#include <linux/mutex.h>
48#include <linux/time.h>
bbad9379 49#include <linux/kernel_stat.h>
a26ac245
PM
50#include <linux/wait.h>
51#include <linux/kthread.h>
268bb0ce 52#include <linux/prefetch.h>
64db4cff 53
9f77da9f 54#include "rcutree.h"
29c00b4a
PM
55#include <trace/events/rcu.h>
56
57#include "rcu.h"
9f77da9f 58
64db4cff
PM
59/* Data structures. */
60
b668c9cf 61static struct lock_class_key rcu_node_class[NUM_RCU_LVLS];
88b91c7c 62
4300aa64 63#define RCU_STATE_INITIALIZER(structname) { \
e99033c5 64 .level = { &structname##_state.node[0] }, \
64db4cff
PM
65 .levelcnt = { \
66 NUM_RCU_LVL_0, /* root of hierarchy. */ \
67 NUM_RCU_LVL_1, \
68 NUM_RCU_LVL_2, \
cf244dc0
PM
69 NUM_RCU_LVL_3, \
70 NUM_RCU_LVL_4, /* == MAX_RCU_LVLS */ \
64db4cff 71 }, \
83f5b01f 72 .signaled = RCU_GP_IDLE, \
64db4cff
PM
73 .gpnum = -300, \
74 .completed = -300, \
e99033c5
PM
75 .onofflock = __RAW_SPIN_LOCK_UNLOCKED(&structname##_state.onofflock), \
76 .fqslock = __RAW_SPIN_LOCK_UNLOCKED(&structname##_state.fqslock), \
64db4cff
PM
77 .n_force_qs = 0, \
78 .n_force_qs_ngp = 0, \
4300aa64 79 .name = #structname, \
64db4cff
PM
80}
81
e99033c5 82struct rcu_state rcu_sched_state = RCU_STATE_INITIALIZER(rcu_sched);
d6714c22 83DEFINE_PER_CPU(struct rcu_data, rcu_sched_data);
64db4cff 84
e99033c5 85struct rcu_state rcu_bh_state = RCU_STATE_INITIALIZER(rcu_bh);
6258c4fb 86DEFINE_PER_CPU(struct rcu_data, rcu_bh_data);
b1f77b05 87
27f4d280
PM
88static struct rcu_state *rcu_state;
89
b0d30417
PM
90/*
91 * The rcu_scheduler_active variable transitions from zero to one just
92 * before the first task is spawned. So when this variable is zero, RCU
93 * can assume that there is but one task, allowing RCU to (for example)
94 * optimized synchronize_sched() to a simple barrier(). When this variable
95 * is one, RCU must actually do all the hard work required to detect real
96 * grace periods. This variable is also used to suppress boot-time false
97 * positives from lockdep-RCU error checking.
98 */
bbad9379
PM
99int rcu_scheduler_active __read_mostly;
100EXPORT_SYMBOL_GPL(rcu_scheduler_active);
101
b0d30417
PM
102/*
103 * The rcu_scheduler_fully_active variable transitions from zero to one
104 * during the early_initcall() processing, which is after the scheduler
105 * is capable of creating new tasks. So RCU processing (for example,
106 * creating tasks for RCU priority boosting) must be delayed until after
107 * rcu_scheduler_fully_active transitions from zero to one. We also
108 * currently delay invocation of any RCU callbacks until after this point.
109 *
110 * It might later prove better for people registering RCU callbacks during
111 * early boot to take responsibility for these callbacks, but one step at
112 * a time.
113 */
114static int rcu_scheduler_fully_active __read_mostly;
115
a46e0899
PM
116#ifdef CONFIG_RCU_BOOST
117
a26ac245
PM
118/*
119 * Control variables for per-CPU and per-rcu_node kthreads. These
120 * handle all flavors of RCU.
121 */
122static DEFINE_PER_CPU(struct task_struct *, rcu_cpu_kthread_task);
d71df90e 123DEFINE_PER_CPU(unsigned int, rcu_cpu_kthread_status);
15ba0ba8 124DEFINE_PER_CPU(int, rcu_cpu_kthread_cpu);
5ece5bab 125DEFINE_PER_CPU(unsigned int, rcu_cpu_kthread_loops);
d71df90e 126DEFINE_PER_CPU(char, rcu_cpu_has_work);
a26ac245 127
a46e0899
PM
128#endif /* #ifdef CONFIG_RCU_BOOST */
129
0f962a5e 130static void rcu_node_kthread_setaffinity(struct rcu_node *rnp, int outgoingcpu);
a46e0899
PM
131static void invoke_rcu_core(void);
132static void invoke_rcu_callbacks(struct rcu_state *rsp, struct rcu_data *rdp);
a26ac245
PM
133
134#define RCU_KTHREAD_PRIO 1 /* RT priority for per-CPU kthreads. */
135
4a298656
PM
136/*
137 * Track the rcutorture test sequence number and the update version
138 * number within a given test. The rcutorture_testseq is incremented
139 * on every rcutorture module load and unload, so has an odd value
140 * when a test is running. The rcutorture_vernum is set to zero
141 * when rcutorture starts and is incremented on each rcutorture update.
142 * These variables enable correlating rcutorture output with the
143 * RCU tracing information.
144 */
145unsigned long rcutorture_testseq;
146unsigned long rcutorture_vernum;
147
fc2219d4
PM
148/*
149 * Return true if an RCU grace period is in progress. The ACCESS_ONCE()s
150 * permit this function to be invoked without holding the root rcu_node
151 * structure's ->lock, but of course results can be subject to change.
152 */
153static int rcu_gp_in_progress(struct rcu_state *rsp)
154{
155 return ACCESS_ONCE(rsp->completed) != ACCESS_ONCE(rsp->gpnum);
156}
157
b1f77b05 158/*
d6714c22 159 * Note a quiescent state. Because we do not need to know
b1f77b05 160 * how many quiescent states passed, just if there was at least
d6714c22 161 * one since the start of the grace period, this just sets a flag.
b1f77b05 162 */
d6714c22 163void rcu_sched_qs(int cpu)
b1f77b05 164{
25502a6c 165 struct rcu_data *rdp = &per_cpu(rcu_sched_data, cpu);
f41d911f 166
c64ac3ce 167 rdp->passed_quiesc_completed = rdp->gpnum - 1;
c3422bea
PM
168 barrier();
169 rdp->passed_quiesc = 1;
b1f77b05
IM
170}
171
d6714c22 172void rcu_bh_qs(int cpu)
b1f77b05 173{
25502a6c 174 struct rcu_data *rdp = &per_cpu(rcu_bh_data, cpu);
f41d911f 175
c64ac3ce 176 rdp->passed_quiesc_completed = rdp->gpnum - 1;
c3422bea
PM
177 barrier();
178 rdp->passed_quiesc = 1;
b1f77b05 179}
64db4cff 180
25502a6c
PM
181/*
182 * Note a context switch. This is a quiescent state for RCU-sched,
183 * and requires special handling for preemptible RCU.
184 */
185void rcu_note_context_switch(int cpu)
186{
300df91c 187 trace_rcu_utilization("Start context switch");
25502a6c
PM
188 rcu_sched_qs(cpu);
189 rcu_preempt_note_context_switch(cpu);
300df91c 190 trace_rcu_utilization("End context switch");
25502a6c 191}
29ce8310 192EXPORT_SYMBOL_GPL(rcu_note_context_switch);
25502a6c 193
64db4cff 194#ifdef CONFIG_NO_HZ
90a4d2c0
PM
195DEFINE_PER_CPU(struct rcu_dynticks, rcu_dynticks) = {
196 .dynticks_nesting = 1,
23b5c8fa 197 .dynticks = ATOMIC_INIT(1),
90a4d2c0 198};
64db4cff
PM
199#endif /* #ifdef CONFIG_NO_HZ */
200
e0f23060 201static int blimit = 10; /* Maximum callbacks per rcu_do_batch. */
64db4cff
PM
202static int qhimark = 10000; /* If this many pending, ignore blimit. */
203static int qlowmark = 100; /* Once only this many pending, use blimit. */
204
3d76c082
PM
205module_param(blimit, int, 0);
206module_param(qhimark, int, 0);
207module_param(qlowmark, int, 0);
208
a00e0d71 209int rcu_cpu_stall_suppress __read_mostly;
f2e0dd70 210module_param(rcu_cpu_stall_suppress, int, 0644);
742734ee 211
64db4cff 212static void force_quiescent_state(struct rcu_state *rsp, int relaxed);
a157229c 213static int rcu_pending(int cpu);
64db4cff
PM
214
215/*
d6714c22 216 * Return the number of RCU-sched batches processed thus far for debug & stats.
64db4cff 217 */
d6714c22 218long rcu_batches_completed_sched(void)
64db4cff 219{
d6714c22 220 return rcu_sched_state.completed;
64db4cff 221}
d6714c22 222EXPORT_SYMBOL_GPL(rcu_batches_completed_sched);
64db4cff
PM
223
224/*
225 * Return the number of RCU BH batches processed thus far for debug & stats.
226 */
227long rcu_batches_completed_bh(void)
228{
229 return rcu_bh_state.completed;
230}
231EXPORT_SYMBOL_GPL(rcu_batches_completed_bh);
232
bf66f18e
PM
233/*
234 * Force a quiescent state for RCU BH.
235 */
236void rcu_bh_force_quiescent_state(void)
237{
238 force_quiescent_state(&rcu_bh_state, 0);
239}
240EXPORT_SYMBOL_GPL(rcu_bh_force_quiescent_state);
241
4a298656
PM
242/*
243 * Record the number of times rcutorture tests have been initiated and
244 * terminated. This information allows the debugfs tracing stats to be
245 * correlated to the rcutorture messages, even when the rcutorture module
246 * is being repeatedly loaded and unloaded. In other words, we cannot
247 * store this state in rcutorture itself.
248 */
249void rcutorture_record_test_transition(void)
250{
251 rcutorture_testseq++;
252 rcutorture_vernum = 0;
253}
254EXPORT_SYMBOL_GPL(rcutorture_record_test_transition);
255
256/*
257 * Record the number of writer passes through the current rcutorture test.
258 * This is also used to correlate debugfs tracing stats with the rcutorture
259 * messages.
260 */
261void rcutorture_record_progress(unsigned long vernum)
262{
263 rcutorture_vernum++;
264}
265EXPORT_SYMBOL_GPL(rcutorture_record_progress);
266
bf66f18e
PM
267/*
268 * Force a quiescent state for RCU-sched.
269 */
270void rcu_sched_force_quiescent_state(void)
271{
272 force_quiescent_state(&rcu_sched_state, 0);
273}
274EXPORT_SYMBOL_GPL(rcu_sched_force_quiescent_state);
275
64db4cff
PM
276/*
277 * Does the CPU have callbacks ready to be invoked?
278 */
279static int
280cpu_has_callbacks_ready_to_invoke(struct rcu_data *rdp)
281{
282 return &rdp->nxtlist != rdp->nxttail[RCU_DONE_TAIL];
283}
284
285/*
286 * Does the current CPU require a yet-as-unscheduled grace period?
287 */
288static int
289cpu_needs_another_gp(struct rcu_state *rsp, struct rcu_data *rdp)
290{
fc2219d4 291 return *rdp->nxttail[RCU_DONE_TAIL] && !rcu_gp_in_progress(rsp);
64db4cff
PM
292}
293
294/*
295 * Return the root node of the specified rcu_state structure.
296 */
297static struct rcu_node *rcu_get_root(struct rcu_state *rsp)
298{
299 return &rsp->node[0];
300}
301
302#ifdef CONFIG_SMP
303
304/*
305 * If the specified CPU is offline, tell the caller that it is in
306 * a quiescent state. Otherwise, whack it with a reschedule IPI.
307 * Grace periods can end up waiting on an offline CPU when that
308 * CPU is in the process of coming online -- it will be added to the
309 * rcu_node bitmasks before it actually makes it online. The same thing
310 * can happen while a CPU is in the process of coming online. Because this
311 * race is quite rare, we check for it after detecting that the grace
312 * period has been delayed rather than checking each and every CPU
313 * each and every time we start a new grace period.
314 */
315static int rcu_implicit_offline_qs(struct rcu_data *rdp)
316{
317 /*
318 * If the CPU is offline, it is in a quiescent state. We can
319 * trust its state not to change because interrupts are disabled.
320 */
321 if (cpu_is_offline(rdp->cpu)) {
322 rdp->offline_fqs++;
323 return 1;
324 }
325
6cc68793
PM
326 /* If preemptible RCU, no point in sending reschedule IPI. */
327 if (rdp->preemptible)
f41d911f
PM
328 return 0;
329
64db4cff
PM
330 /* The CPU is online, so send it a reschedule IPI. */
331 if (rdp->cpu != smp_processor_id())
332 smp_send_reschedule(rdp->cpu);
333 else
334 set_need_resched();
335 rdp->resched_ipi++;
336 return 0;
337}
338
339#endif /* #ifdef CONFIG_SMP */
340
341#ifdef CONFIG_NO_HZ
64db4cff
PM
342
343/**
344 * rcu_enter_nohz - inform RCU that current CPU is entering nohz
345 *
346 * Enter nohz mode, in other words, -leave- the mode in which RCU
347 * read-side critical sections can occur. (Though RCU read-side
348 * critical sections can occur in irq handlers in nohz mode, a possibility
349 * handled by rcu_irq_enter() and rcu_irq_exit()).
350 */
351void rcu_enter_nohz(void)
352{
353 unsigned long flags;
354 struct rcu_dynticks *rdtp;
355
64db4cff
PM
356 local_irq_save(flags);
357 rdtp = &__get_cpu_var(rcu_dynticks);
23b5c8fa
PM
358 if (--rdtp->dynticks_nesting) {
359 local_irq_restore(flags);
360 return;
361 }
362 /* CPUs seeing atomic_inc() must see prior RCU read-side crit sects */
363 smp_mb__before_atomic_inc(); /* See above. */
364 atomic_inc(&rdtp->dynticks);
365 smp_mb__after_atomic_inc(); /* Force ordering with next sojourn. */
366 WARN_ON_ONCE(atomic_read(&rdtp->dynticks) & 0x1);
64db4cff 367 local_irq_restore(flags);
23b5c8fa
PM
368
369 /* If the interrupt queued a callback, get out of dyntick mode. */
370 if (in_irq() &&
371 (__get_cpu_var(rcu_sched_data).nxtlist ||
372 __get_cpu_var(rcu_bh_data).nxtlist ||
373 rcu_preempt_needs_cpu(smp_processor_id())))
374 set_need_resched();
64db4cff
PM
375}
376
377/*
378 * rcu_exit_nohz - inform RCU that current CPU is leaving nohz
379 *
380 * Exit nohz mode, in other words, -enter- the mode in which RCU
381 * read-side critical sections normally occur.
382 */
383void rcu_exit_nohz(void)
384{
385 unsigned long flags;
386 struct rcu_dynticks *rdtp;
387
388 local_irq_save(flags);
389 rdtp = &__get_cpu_var(rcu_dynticks);
23b5c8fa
PM
390 if (rdtp->dynticks_nesting++) {
391 local_irq_restore(flags);
392 return;
393 }
394 smp_mb__before_atomic_inc(); /* Force ordering w/previous sojourn. */
395 atomic_inc(&rdtp->dynticks);
396 /* CPUs seeing atomic_inc() must see later RCU read-side crit sects */
397 smp_mb__after_atomic_inc(); /* See above. */
398 WARN_ON_ONCE(!(atomic_read(&rdtp->dynticks) & 0x1));
64db4cff 399 local_irq_restore(flags);
64db4cff
PM
400}
401
402/**
403 * rcu_nmi_enter - inform RCU of entry to NMI context
404 *
405 * If the CPU was idle with dynamic ticks active, and there is no
406 * irq handler running, this updates rdtp->dynticks_nmi to let the
407 * RCU grace-period handling know that the CPU is active.
408 */
409void rcu_nmi_enter(void)
410{
411 struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
412
23b5c8fa
PM
413 if (rdtp->dynticks_nmi_nesting == 0 &&
414 (atomic_read(&rdtp->dynticks) & 0x1))
64db4cff 415 return;
23b5c8fa
PM
416 rdtp->dynticks_nmi_nesting++;
417 smp_mb__before_atomic_inc(); /* Force delay from prior write. */
418 atomic_inc(&rdtp->dynticks);
419 /* CPUs seeing atomic_inc() must see later RCU read-side crit sects */
420 smp_mb__after_atomic_inc(); /* See above. */
421 WARN_ON_ONCE(!(atomic_read(&rdtp->dynticks) & 0x1));
64db4cff
PM
422}
423
424/**
425 * rcu_nmi_exit - inform RCU of exit from NMI context
426 *
427 * If the CPU was idle with dynamic ticks active, and there is no
428 * irq handler running, this updates rdtp->dynticks_nmi to let the
429 * RCU grace-period handling know that the CPU is no longer active.
430 */
431void rcu_nmi_exit(void)
432{
433 struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
434
23b5c8fa
PM
435 if (rdtp->dynticks_nmi_nesting == 0 ||
436 --rdtp->dynticks_nmi_nesting != 0)
64db4cff 437 return;
23b5c8fa
PM
438 /* CPUs seeing atomic_inc() must see prior RCU read-side crit sects */
439 smp_mb__before_atomic_inc(); /* See above. */
440 atomic_inc(&rdtp->dynticks);
441 smp_mb__after_atomic_inc(); /* Force delay to next write. */
442 WARN_ON_ONCE(atomic_read(&rdtp->dynticks) & 0x1);
64db4cff
PM
443}
444
445/**
446 * rcu_irq_enter - inform RCU of entry to hard irq context
447 *
448 * If the CPU was idle with dynamic ticks active, this updates the
449 * rdtp->dynticks to let the RCU handling know that the CPU is active.
450 */
451void rcu_irq_enter(void)
452{
23b5c8fa 453 rcu_exit_nohz();
64db4cff
PM
454}
455
456/**
457 * rcu_irq_exit - inform RCU of exit from hard irq context
458 *
459 * If the CPU was idle with dynamic ticks active, update the rdp->dynticks
460 * to put let the RCU handling be aware that the CPU is going back to idle
461 * with no ticks.
462 */
463void rcu_irq_exit(void)
464{
23b5c8fa 465 rcu_enter_nohz();
64db4cff
PM
466}
467
64db4cff
PM
468#ifdef CONFIG_SMP
469
64db4cff
PM
470/*
471 * Snapshot the specified CPU's dynticks counter so that we can later
472 * credit them with an implicit quiescent state. Return 1 if this CPU
1eba8f84 473 * is in dynticks idle mode, which is an extended quiescent state.
64db4cff
PM
474 */
475static int dyntick_save_progress_counter(struct rcu_data *rdp)
476{
23b5c8fa
PM
477 rdp->dynticks_snap = atomic_add_return(0, &rdp->dynticks->dynticks);
478 return 0;
64db4cff
PM
479}
480
481/*
482 * Return true if the specified CPU has passed through a quiescent
483 * state by virtue of being in or having passed through an dynticks
484 * idle state since the last call to dyntick_save_progress_counter()
485 * for this same CPU.
486 */
487static int rcu_implicit_dynticks_qs(struct rcu_data *rdp)
488{
23b5c8fa
PM
489 unsigned long curr;
490 unsigned long snap;
64db4cff 491
23b5c8fa
PM
492 curr = (unsigned long)atomic_add_return(0, &rdp->dynticks->dynticks);
493 snap = (unsigned long)rdp->dynticks_snap;
64db4cff
PM
494
495 /*
496 * If the CPU passed through or entered a dynticks idle phase with
497 * no active irq/NMI handlers, then we can safely pretend that the CPU
498 * already acknowledged the request to pass through a quiescent
499 * state. Either way, that CPU cannot possibly be in an RCU
500 * read-side critical section that started before the beginning
501 * of the current RCU grace period.
502 */
23b5c8fa 503 if ((curr & 0x1) == 0 || ULONG_CMP_GE(curr, snap + 2)) {
64db4cff
PM
504 rdp->dynticks_fqs++;
505 return 1;
506 }
507
508 /* Go check for the CPU being offline. */
509 return rcu_implicit_offline_qs(rdp);
510}
511
512#endif /* #ifdef CONFIG_SMP */
513
514#else /* #ifdef CONFIG_NO_HZ */
515
64db4cff
PM
516#ifdef CONFIG_SMP
517
64db4cff
PM
518static int dyntick_save_progress_counter(struct rcu_data *rdp)
519{
520 return 0;
521}
522
523static int rcu_implicit_dynticks_qs(struct rcu_data *rdp)
524{
525 return rcu_implicit_offline_qs(rdp);
526}
527
528#endif /* #ifdef CONFIG_SMP */
529
530#endif /* #else #ifdef CONFIG_NO_HZ */
531
742734ee 532int rcu_cpu_stall_suppress __read_mostly;
c68de209 533
64db4cff
PM
534static void record_gp_stall_check_time(struct rcu_state *rsp)
535{
536 rsp->gp_start = jiffies;
537 rsp->jiffies_stall = jiffies + RCU_SECONDS_TILL_STALL_CHECK;
538}
539
540static void print_other_cpu_stall(struct rcu_state *rsp)
541{
542 int cpu;
543 long delta;
544 unsigned long flags;
545 struct rcu_node *rnp = rcu_get_root(rsp);
64db4cff
PM
546
547 /* Only let one CPU complain about others per time interval. */
548
1304afb2 549 raw_spin_lock_irqsave(&rnp->lock, flags);
64db4cff 550 delta = jiffies - rsp->jiffies_stall;
fc2219d4 551 if (delta < RCU_STALL_RAT_DELAY || !rcu_gp_in_progress(rsp)) {
1304afb2 552 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
553 return;
554 }
555 rsp->jiffies_stall = jiffies + RCU_SECONDS_TILL_STALL_RECHECK;
a0b6c9a7
PM
556
557 /*
558 * Now rat on any tasks that got kicked up to the root rcu_node
559 * due to CPU offlining.
560 */
561 rcu_print_task_stall(rnp);
1304afb2 562 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff 563
8cdd32a9
PM
564 /*
565 * OK, time to rat on our buddy...
566 * See Documentation/RCU/stallwarn.txt for info on how to debug
567 * RCU CPU stall warnings.
568 */
4300aa64
PM
569 printk(KERN_ERR "INFO: %s detected stalls on CPUs/tasks: {",
570 rsp->name);
a0b6c9a7 571 rcu_for_each_leaf_node(rsp, rnp) {
3acd9eb3 572 raw_spin_lock_irqsave(&rnp->lock, flags);
f41d911f 573 rcu_print_task_stall(rnp);
3acd9eb3 574 raw_spin_unlock_irqrestore(&rnp->lock, flags);
a0b6c9a7 575 if (rnp->qsmask == 0)
64db4cff 576 continue;
a0b6c9a7
PM
577 for (cpu = 0; cpu <= rnp->grphi - rnp->grplo; cpu++)
578 if (rnp->qsmask & (1UL << cpu))
579 printk(" %d", rnp->grplo + cpu);
64db4cff 580 }
4300aa64 581 printk("} (detected by %d, t=%ld jiffies)\n",
64db4cff 582 smp_processor_id(), (long)(jiffies - rsp->gp_start));
c1dc0b9c
IM
583 trigger_all_cpu_backtrace();
584
1ed509a2
PM
585 /* If so configured, complain about tasks blocking the grace period. */
586
587 rcu_print_detail_task_stall(rsp);
588
64db4cff
PM
589 force_quiescent_state(rsp, 0); /* Kick them all. */
590}
591
592static void print_cpu_stall(struct rcu_state *rsp)
593{
594 unsigned long flags;
595 struct rcu_node *rnp = rcu_get_root(rsp);
596
8cdd32a9
PM
597 /*
598 * OK, time to rat on ourselves...
599 * See Documentation/RCU/stallwarn.txt for info on how to debug
600 * RCU CPU stall warnings.
601 */
4300aa64
PM
602 printk(KERN_ERR "INFO: %s detected stall on CPU %d (t=%lu jiffies)\n",
603 rsp->name, smp_processor_id(), jiffies - rsp->gp_start);
c1dc0b9c
IM
604 trigger_all_cpu_backtrace();
605
1304afb2 606 raw_spin_lock_irqsave(&rnp->lock, flags);
20133cfc 607 if (ULONG_CMP_GE(jiffies, rsp->jiffies_stall))
64db4cff
PM
608 rsp->jiffies_stall =
609 jiffies + RCU_SECONDS_TILL_STALL_RECHECK;
1304afb2 610 raw_spin_unlock_irqrestore(&rnp->lock, flags);
c1dc0b9c 611
64db4cff
PM
612 set_need_resched(); /* kick ourselves to get things going. */
613}
614
615static void check_cpu_stall(struct rcu_state *rsp, struct rcu_data *rdp)
616{
bad6e139
PM
617 unsigned long j;
618 unsigned long js;
64db4cff
PM
619 struct rcu_node *rnp;
620
742734ee 621 if (rcu_cpu_stall_suppress)
c68de209 622 return;
bad6e139
PM
623 j = ACCESS_ONCE(jiffies);
624 js = ACCESS_ONCE(rsp->jiffies_stall);
64db4cff 625 rnp = rdp->mynode;
bad6e139 626 if ((ACCESS_ONCE(rnp->qsmask) & rdp->grpmask) && ULONG_CMP_GE(j, js)) {
64db4cff
PM
627
628 /* We haven't checked in, so go dump stack. */
629 print_cpu_stall(rsp);
630
bad6e139
PM
631 } else if (rcu_gp_in_progress(rsp) &&
632 ULONG_CMP_GE(j, js + RCU_STALL_RAT_DELAY)) {
64db4cff 633
bad6e139 634 /* They had a few time units to dump stack, so complain. */
64db4cff
PM
635 print_other_cpu_stall(rsp);
636 }
637}
638
c68de209
PM
639static int rcu_panic(struct notifier_block *this, unsigned long ev, void *ptr)
640{
742734ee 641 rcu_cpu_stall_suppress = 1;
c68de209
PM
642 return NOTIFY_DONE;
643}
644
53d84e00
PM
645/**
646 * rcu_cpu_stall_reset - prevent further stall warnings in current grace period
647 *
648 * Set the stall-warning timeout way off into the future, thus preventing
649 * any RCU CPU stall-warning messages from appearing in the current set of
650 * RCU grace periods.
651 *
652 * The caller must disable hard irqs.
653 */
654void rcu_cpu_stall_reset(void)
655{
656 rcu_sched_state.jiffies_stall = jiffies + ULONG_MAX / 2;
657 rcu_bh_state.jiffies_stall = jiffies + ULONG_MAX / 2;
658 rcu_preempt_stall_reset();
659}
660
c68de209
PM
661static struct notifier_block rcu_panic_block = {
662 .notifier_call = rcu_panic,
663};
664
665static void __init check_cpu_stall_init(void)
666{
667 atomic_notifier_chain_register(&panic_notifier_list, &rcu_panic_block);
668}
669
64db4cff
PM
670/*
671 * Update CPU-local rcu_data state to record the newly noticed grace period.
672 * This is used both when we started the grace period and when we notice
9160306e
PM
673 * that someone else started the grace period. The caller must hold the
674 * ->lock of the leaf rcu_node structure corresponding to the current CPU,
675 * and must have irqs disabled.
64db4cff 676 */
9160306e
PM
677static void __note_new_gpnum(struct rcu_state *rsp, struct rcu_node *rnp, struct rcu_data *rdp)
678{
679 if (rdp->gpnum != rnp->gpnum) {
121dfc4b
PM
680 /*
681 * If the current grace period is waiting for this CPU,
682 * set up to detect a quiescent state, otherwise don't
683 * go looking for one.
684 */
9160306e 685 rdp->gpnum = rnp->gpnum;
121dfc4b
PM
686 if (rnp->qsmask & rdp->grpmask) {
687 rdp->qs_pending = 1;
688 rdp->passed_quiesc = 0;
689 } else
690 rdp->qs_pending = 0;
9160306e
PM
691 }
692}
693
64db4cff
PM
694static void note_new_gpnum(struct rcu_state *rsp, struct rcu_data *rdp)
695{
9160306e
PM
696 unsigned long flags;
697 struct rcu_node *rnp;
698
699 local_irq_save(flags);
700 rnp = rdp->mynode;
701 if (rdp->gpnum == ACCESS_ONCE(rnp->gpnum) || /* outside lock. */
1304afb2 702 !raw_spin_trylock(&rnp->lock)) { /* irqs already off, so later. */
9160306e
PM
703 local_irq_restore(flags);
704 return;
705 }
706 __note_new_gpnum(rsp, rnp, rdp);
1304afb2 707 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
708}
709
710/*
711 * Did someone else start a new RCU grace period start since we last
712 * checked? Update local state appropriately if so. Must be called
713 * on the CPU corresponding to rdp.
714 */
715static int
716check_for_new_grace_period(struct rcu_state *rsp, struct rcu_data *rdp)
717{
718 unsigned long flags;
719 int ret = 0;
720
721 local_irq_save(flags);
722 if (rdp->gpnum != rsp->gpnum) {
723 note_new_gpnum(rsp, rdp);
724 ret = 1;
725 }
726 local_irq_restore(flags);
727 return ret;
728}
729
d09b62df
PM
730/*
731 * Advance this CPU's callbacks, but only if the current grace period
732 * has ended. This may be called only from the CPU to whom the rdp
733 * belongs. In addition, the corresponding leaf rcu_node structure's
734 * ->lock must be held by the caller, with irqs disabled.
735 */
736static void
737__rcu_process_gp_end(struct rcu_state *rsp, struct rcu_node *rnp, struct rcu_data *rdp)
738{
739 /* Did another grace period end? */
740 if (rdp->completed != rnp->completed) {
741
742 /* Advance callbacks. No harm if list empty. */
743 rdp->nxttail[RCU_DONE_TAIL] = rdp->nxttail[RCU_WAIT_TAIL];
744 rdp->nxttail[RCU_WAIT_TAIL] = rdp->nxttail[RCU_NEXT_READY_TAIL];
745 rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
746
747 /* Remember that we saw this grace-period completion. */
748 rdp->completed = rnp->completed;
20377f32 749
5ff8e6f0
FW
750 /*
751 * If we were in an extended quiescent state, we may have
121dfc4b 752 * missed some grace periods that others CPUs handled on
5ff8e6f0 753 * our behalf. Catch up with this state to avoid noting
121dfc4b
PM
754 * spurious new grace periods. If another grace period
755 * has started, then rnp->gpnum will have advanced, so
756 * we will detect this later on.
5ff8e6f0 757 */
121dfc4b 758 if (ULONG_CMP_LT(rdp->gpnum, rdp->completed))
5ff8e6f0
FW
759 rdp->gpnum = rdp->completed;
760
20377f32 761 /*
121dfc4b
PM
762 * If RCU does not need a quiescent state from this CPU,
763 * then make sure that this CPU doesn't go looking for one.
20377f32 764 */
121dfc4b 765 if ((rnp->qsmask & rdp->grpmask) == 0)
20377f32 766 rdp->qs_pending = 0;
d09b62df
PM
767 }
768}
769
770/*
771 * Advance this CPU's callbacks, but only if the current grace period
772 * has ended. This may be called only from the CPU to whom the rdp
773 * belongs.
774 */
775static void
776rcu_process_gp_end(struct rcu_state *rsp, struct rcu_data *rdp)
777{
778 unsigned long flags;
779 struct rcu_node *rnp;
780
781 local_irq_save(flags);
782 rnp = rdp->mynode;
783 if (rdp->completed == ACCESS_ONCE(rnp->completed) || /* outside lock. */
1304afb2 784 !raw_spin_trylock(&rnp->lock)) { /* irqs already off, so later. */
d09b62df
PM
785 local_irq_restore(flags);
786 return;
787 }
788 __rcu_process_gp_end(rsp, rnp, rdp);
1304afb2 789 raw_spin_unlock_irqrestore(&rnp->lock, flags);
d09b62df
PM
790}
791
792/*
793 * Do per-CPU grace-period initialization for running CPU. The caller
794 * must hold the lock of the leaf rcu_node structure corresponding to
795 * this CPU.
796 */
797static void
798rcu_start_gp_per_cpu(struct rcu_state *rsp, struct rcu_node *rnp, struct rcu_data *rdp)
799{
800 /* Prior grace period ended, so advance callbacks for current CPU. */
801 __rcu_process_gp_end(rsp, rnp, rdp);
802
803 /*
804 * Because this CPU just now started the new grace period, we know
805 * that all of its callbacks will be covered by this upcoming grace
806 * period, even the ones that were registered arbitrarily recently.
807 * Therefore, advance all outstanding callbacks to RCU_WAIT_TAIL.
808 *
809 * Other CPUs cannot be sure exactly when the grace period started.
810 * Therefore, their recently registered callbacks must pass through
811 * an additional RCU_NEXT_READY stage, so that they will be handled
812 * by the next RCU grace period.
813 */
814 rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
815 rdp->nxttail[RCU_WAIT_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
9160306e
PM
816
817 /* Set state so that this CPU will detect the next quiescent state. */
818 __note_new_gpnum(rsp, rnp, rdp);
d09b62df
PM
819}
820
64db4cff
PM
821/*
822 * Start a new RCU grace period if warranted, re-initializing the hierarchy
823 * in preparation for detecting the next grace period. The caller must hold
824 * the root node's ->lock, which is released before return. Hard irqs must
825 * be disabled.
826 */
827static void
828rcu_start_gp(struct rcu_state *rsp, unsigned long flags)
829 __releases(rcu_get_root(rsp)->lock)
830{
394f99a9 831 struct rcu_data *rdp = this_cpu_ptr(rsp->rda);
64db4cff 832 struct rcu_node *rnp = rcu_get_root(rsp);
64db4cff 833
07079d53 834 if (!cpu_needs_another_gp(rsp, rdp) || rsp->fqs_active) {
46a1e34e
PM
835 if (cpu_needs_another_gp(rsp, rdp))
836 rsp->fqs_need_gp = 1;
b32e9eb6 837 if (rnp->completed == rsp->completed) {
1304afb2 838 raw_spin_unlock_irqrestore(&rnp->lock, flags);
b32e9eb6
PM
839 return;
840 }
1304afb2 841 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
b32e9eb6
PM
842
843 /*
844 * Propagate new ->completed value to rcu_node structures
845 * so that other CPUs don't have to wait until the start
846 * of the next grace period to process their callbacks.
847 */
848 rcu_for_each_node_breadth_first(rsp, rnp) {
1304afb2 849 raw_spin_lock(&rnp->lock); /* irqs already disabled. */
b32e9eb6 850 rnp->completed = rsp->completed;
1304afb2 851 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
b32e9eb6
PM
852 }
853 local_irq_restore(flags);
64db4cff
PM
854 return;
855 }
856
857 /* Advance to a new grace period and initialize state. */
858 rsp->gpnum++;
c3422bea 859 WARN_ON_ONCE(rsp->signaled == RCU_GP_INIT);
64db4cff
PM
860 rsp->signaled = RCU_GP_INIT; /* Hold off force_quiescent_state. */
861 rsp->jiffies_force_qs = jiffies + RCU_JIFFIES_TILL_FORCE_QS;
64db4cff 862 record_gp_stall_check_time(rsp);
64db4cff 863
64db4cff
PM
864 /* Special-case the common single-level case. */
865 if (NUM_RCU_NODES == 1) {
b0e165c0 866 rcu_preempt_check_blocked_tasks(rnp);
28ecd580 867 rnp->qsmask = rnp->qsmaskinit;
de078d87 868 rnp->gpnum = rsp->gpnum;
d09b62df 869 rnp->completed = rsp->completed;
c12172c0 870 rsp->signaled = RCU_SIGNAL_INIT; /* force_quiescent_state OK. */
d09b62df 871 rcu_start_gp_per_cpu(rsp, rnp, rdp);
27f4d280 872 rcu_preempt_boost_start_gp(rnp);
1304afb2 873 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
874 return;
875 }
876
1304afb2 877 raw_spin_unlock(&rnp->lock); /* leave irqs disabled. */
64db4cff
PM
878
879
880 /* Exclude any concurrent CPU-hotplug operations. */
1304afb2 881 raw_spin_lock(&rsp->onofflock); /* irqs already disabled. */
64db4cff
PM
882
883 /*
b835db1f
PM
884 * Set the quiescent-state-needed bits in all the rcu_node
885 * structures for all currently online CPUs in breadth-first
886 * order, starting from the root rcu_node structure. This
887 * operation relies on the layout of the hierarchy within the
888 * rsp->node[] array. Note that other CPUs will access only
889 * the leaves of the hierarchy, which still indicate that no
890 * grace period is in progress, at least until the corresponding
891 * leaf node has been initialized. In addition, we have excluded
892 * CPU-hotplug operations.
64db4cff
PM
893 *
894 * Note that the grace period cannot complete until we finish
895 * the initialization process, as there will be at least one
896 * qsmask bit set in the root node until that time, namely the
b835db1f
PM
897 * one corresponding to this CPU, due to the fact that we have
898 * irqs disabled.
64db4cff 899 */
a0b6c9a7 900 rcu_for_each_node_breadth_first(rsp, rnp) {
1304afb2 901 raw_spin_lock(&rnp->lock); /* irqs already disabled. */
b0e165c0 902 rcu_preempt_check_blocked_tasks(rnp);
49e29126 903 rnp->qsmask = rnp->qsmaskinit;
de078d87 904 rnp->gpnum = rsp->gpnum;
d09b62df
PM
905 rnp->completed = rsp->completed;
906 if (rnp == rdp->mynode)
907 rcu_start_gp_per_cpu(rsp, rnp, rdp);
27f4d280 908 rcu_preempt_boost_start_gp(rnp);
1304afb2 909 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
64db4cff
PM
910 }
911
83f5b01f 912 rnp = rcu_get_root(rsp);
1304afb2 913 raw_spin_lock(&rnp->lock); /* irqs already disabled. */
64db4cff 914 rsp->signaled = RCU_SIGNAL_INIT; /* force_quiescent_state now OK. */
1304afb2
PM
915 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
916 raw_spin_unlock_irqrestore(&rsp->onofflock, flags);
64db4cff
PM
917}
918
f41d911f 919/*
d3f6bad3
PM
920 * Report a full set of quiescent states to the specified rcu_state
921 * data structure. This involves cleaning up after the prior grace
922 * period and letting rcu_start_gp() start up the next grace period
923 * if one is needed. Note that the caller must hold rnp->lock, as
924 * required by rcu_start_gp(), which will release it.
f41d911f 925 */
d3f6bad3 926static void rcu_report_qs_rsp(struct rcu_state *rsp, unsigned long flags)
fc2219d4 927 __releases(rcu_get_root(rsp)->lock)
f41d911f 928{
15ba0ba8
PM
929 unsigned long gp_duration;
930
fc2219d4 931 WARN_ON_ONCE(!rcu_gp_in_progress(rsp));
0bbcc529
PM
932
933 /*
934 * Ensure that all grace-period and pre-grace-period activity
935 * is seen before the assignment to rsp->completed.
936 */
937 smp_mb(); /* See above block comment. */
15ba0ba8
PM
938 gp_duration = jiffies - rsp->gp_start;
939 if (gp_duration > rsp->gp_max)
940 rsp->gp_max = gp_duration;
f41d911f 941 rsp->completed = rsp->gpnum;
83f5b01f 942 rsp->signaled = RCU_GP_IDLE;
f41d911f
PM
943 rcu_start_gp(rsp, flags); /* releases root node's rnp->lock. */
944}
945
64db4cff 946/*
d3f6bad3
PM
947 * Similar to rcu_report_qs_rdp(), for which it is a helper function.
948 * Allows quiescent states for a group of CPUs to be reported at one go
949 * to the specified rcu_node structure, though all the CPUs in the group
950 * must be represented by the same rcu_node structure (which need not be
951 * a leaf rcu_node structure, though it often will be). That structure's
952 * lock must be held upon entry, and it is released before return.
64db4cff
PM
953 */
954static void
d3f6bad3
PM
955rcu_report_qs_rnp(unsigned long mask, struct rcu_state *rsp,
956 struct rcu_node *rnp, unsigned long flags)
64db4cff
PM
957 __releases(rnp->lock)
958{
28ecd580
PM
959 struct rcu_node *rnp_c;
960
64db4cff
PM
961 /* Walk up the rcu_node hierarchy. */
962 for (;;) {
963 if (!(rnp->qsmask & mask)) {
964
965 /* Our bit has already been cleared, so done. */
1304afb2 966 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
967 return;
968 }
969 rnp->qsmask &= ~mask;
27f4d280 970 if (rnp->qsmask != 0 || rcu_preempt_blocked_readers_cgp(rnp)) {
64db4cff
PM
971
972 /* Other bits still set at this level, so done. */
1304afb2 973 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
974 return;
975 }
976 mask = rnp->grpmask;
977 if (rnp->parent == NULL) {
978
979 /* No more levels. Exit loop holding root lock. */
980
981 break;
982 }
1304afb2 983 raw_spin_unlock_irqrestore(&rnp->lock, flags);
28ecd580 984 rnp_c = rnp;
64db4cff 985 rnp = rnp->parent;
1304afb2 986 raw_spin_lock_irqsave(&rnp->lock, flags);
28ecd580 987 WARN_ON_ONCE(rnp_c->qsmask);
64db4cff
PM
988 }
989
990 /*
991 * Get here if we are the last CPU to pass through a quiescent
d3f6bad3 992 * state for this grace period. Invoke rcu_report_qs_rsp()
f41d911f 993 * to clean up and start the next grace period if one is needed.
64db4cff 994 */
d3f6bad3 995 rcu_report_qs_rsp(rsp, flags); /* releases rnp->lock. */
64db4cff
PM
996}
997
998/*
d3f6bad3
PM
999 * Record a quiescent state for the specified CPU to that CPU's rcu_data
1000 * structure. This must be either called from the specified CPU, or
1001 * called when the specified CPU is known to be offline (and when it is
1002 * also known that no other CPU is concurrently trying to help the offline
1003 * CPU). The lastcomp argument is used to make sure we are still in the
1004 * grace period of interest. We don't want to end the current grace period
1005 * based on quiescent states detected in an earlier grace period!
64db4cff
PM
1006 */
1007static void
d3f6bad3 1008rcu_report_qs_rdp(int cpu, struct rcu_state *rsp, struct rcu_data *rdp, long lastcomp)
64db4cff
PM
1009{
1010 unsigned long flags;
1011 unsigned long mask;
1012 struct rcu_node *rnp;
1013
1014 rnp = rdp->mynode;
1304afb2 1015 raw_spin_lock_irqsave(&rnp->lock, flags);
560d4bc0 1016 if (lastcomp != rnp->completed) {
64db4cff
PM
1017
1018 /*
1019 * Someone beat us to it for this grace period, so leave.
1020 * The race with GP start is resolved by the fact that we
1021 * hold the leaf rcu_node lock, so that the per-CPU bits
1022 * cannot yet be initialized -- so we would simply find our
d3f6bad3
PM
1023 * CPU's bit already cleared in rcu_report_qs_rnp() if this
1024 * race occurred.
64db4cff
PM
1025 */
1026 rdp->passed_quiesc = 0; /* try again later! */
1304afb2 1027 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
1028 return;
1029 }
1030 mask = rdp->grpmask;
1031 if ((rnp->qsmask & mask) == 0) {
1304afb2 1032 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff
PM
1033 } else {
1034 rdp->qs_pending = 0;
1035
1036 /*
1037 * This GP can't end until cpu checks in, so all of our
1038 * callbacks can be processed during the next GP.
1039 */
64db4cff
PM
1040 rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
1041
d3f6bad3 1042 rcu_report_qs_rnp(mask, rsp, rnp, flags); /* rlses rnp->lock */
64db4cff
PM
1043 }
1044}
1045
1046/*
1047 * Check to see if there is a new grace period of which this CPU
1048 * is not yet aware, and if so, set up local rcu_data state for it.
1049 * Otherwise, see if this CPU has just passed through its first
1050 * quiescent state for this grace period, and record that fact if so.
1051 */
1052static void
1053rcu_check_quiescent_state(struct rcu_state *rsp, struct rcu_data *rdp)
1054{
1055 /* If there is now a new grace period, record and return. */
1056 if (check_for_new_grace_period(rsp, rdp))
1057 return;
1058
1059 /*
1060 * Does this CPU still need to do its part for current grace period?
1061 * If no, return and let the other CPUs do their part as well.
1062 */
1063 if (!rdp->qs_pending)
1064 return;
1065
1066 /*
1067 * Was there a quiescent state since the beginning of the grace
1068 * period? If no, then exit and wait for the next call.
1069 */
1070 if (!rdp->passed_quiesc)
1071 return;
1072
d3f6bad3
PM
1073 /*
1074 * Tell RCU we are done (but rcu_report_qs_rdp() will be the
1075 * judge of that).
1076 */
1077 rcu_report_qs_rdp(rdp->cpu, rsp, rdp, rdp->passed_quiesc_completed);
64db4cff
PM
1078}
1079
1080#ifdef CONFIG_HOTPLUG_CPU
1081
e74f4c45 1082/*
29494be7
LJ
1083 * Move a dying CPU's RCU callbacks to online CPU's callback list.
1084 * Synchronization is not required because this function executes
1085 * in stop_machine() context.
e74f4c45 1086 */
29494be7 1087static void rcu_send_cbs_to_online(struct rcu_state *rsp)
e74f4c45
PM
1088{
1089 int i;
29494be7
LJ
1090 /* current DYING CPU is cleared in the cpu_online_mask */
1091 int receive_cpu = cpumask_any(cpu_online_mask);
394f99a9 1092 struct rcu_data *rdp = this_cpu_ptr(rsp->rda);
29494be7 1093 struct rcu_data *receive_rdp = per_cpu_ptr(rsp->rda, receive_cpu);
e74f4c45
PM
1094
1095 if (rdp->nxtlist == NULL)
1096 return; /* irqs disabled, so comparison is stable. */
29494be7
LJ
1097
1098 *receive_rdp->nxttail[RCU_NEXT_TAIL] = rdp->nxtlist;
1099 receive_rdp->nxttail[RCU_NEXT_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
1100 receive_rdp->qlen += rdp->qlen;
1101 receive_rdp->n_cbs_adopted += rdp->qlen;
1102 rdp->n_cbs_orphaned += rdp->qlen;
1103
e74f4c45
PM
1104 rdp->nxtlist = NULL;
1105 for (i = 0; i < RCU_NEXT_SIZE; i++)
1106 rdp->nxttail[i] = &rdp->nxtlist;
e74f4c45 1107 rdp->qlen = 0;
e74f4c45
PM
1108}
1109
64db4cff
PM
1110/*
1111 * Remove the outgoing CPU from the bitmasks in the rcu_node hierarchy
1112 * and move all callbacks from the outgoing CPU to the current one.
a26ac245
PM
1113 * There can only be one CPU hotplug operation at a time, so no other
1114 * CPU can be attempting to update rcu_cpu_kthread_task.
64db4cff
PM
1115 */
1116static void __rcu_offline_cpu(int cpu, struct rcu_state *rsp)
1117{
64db4cff 1118 unsigned long flags;
64db4cff 1119 unsigned long mask;
d9a3da06 1120 int need_report = 0;
394f99a9 1121 struct rcu_data *rdp = per_cpu_ptr(rsp->rda, cpu);
64db4cff 1122 struct rcu_node *rnp;
a26ac245 1123
f8b7fc6b 1124 rcu_stop_cpu_kthread(cpu);
64db4cff
PM
1125
1126 /* Exclude any attempts to start a new grace period. */
1304afb2 1127 raw_spin_lock_irqsave(&rsp->onofflock, flags);
64db4cff
PM
1128
1129 /* Remove the outgoing CPU from the masks in the rcu_node hierarchy. */
28ecd580 1130 rnp = rdp->mynode; /* this is the outgoing CPU's rnp. */
64db4cff
PM
1131 mask = rdp->grpmask; /* rnp->grplo is constant. */
1132 do {
1304afb2 1133 raw_spin_lock(&rnp->lock); /* irqs already disabled. */
64db4cff
PM
1134 rnp->qsmaskinit &= ~mask;
1135 if (rnp->qsmaskinit != 0) {
b668c9cf 1136 if (rnp != rdp->mynode)
1304afb2 1137 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
64db4cff
PM
1138 break;
1139 }
b668c9cf 1140 if (rnp == rdp->mynode)
d9a3da06 1141 need_report = rcu_preempt_offline_tasks(rsp, rnp, rdp);
b668c9cf 1142 else
1304afb2 1143 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
64db4cff 1144 mask = rnp->grpmask;
64db4cff
PM
1145 rnp = rnp->parent;
1146 } while (rnp != NULL);
64db4cff 1147
b668c9cf
PM
1148 /*
1149 * We still hold the leaf rcu_node structure lock here, and
1150 * irqs are still disabled. The reason for this subterfuge is
d3f6bad3
PM
1151 * because invoking rcu_report_unblock_qs_rnp() with ->onofflock
1152 * held leads to deadlock.
b668c9cf 1153 */
1304afb2 1154 raw_spin_unlock(&rsp->onofflock); /* irqs remain disabled. */
b668c9cf 1155 rnp = rdp->mynode;
d9a3da06 1156 if (need_report & RCU_OFL_TASKS_NORM_GP)
d3f6bad3 1157 rcu_report_unblock_qs_rnp(rnp, flags);
b668c9cf 1158 else
1304afb2 1159 raw_spin_unlock_irqrestore(&rnp->lock, flags);
d9a3da06
PM
1160 if (need_report & RCU_OFL_TASKS_EXP_GP)
1161 rcu_report_exp_rnp(rsp, rnp);
1217ed1b 1162 rcu_node_kthread_setaffinity(rnp, -1);
64db4cff
PM
1163}
1164
1165/*
1166 * Remove the specified CPU from the RCU hierarchy and move any pending
1167 * callbacks that it might have to the current CPU. This code assumes
1168 * that at least one CPU in the system will remain running at all times.
1169 * Any attempt to offline -all- CPUs is likely to strand RCU callbacks.
1170 */
1171static void rcu_offline_cpu(int cpu)
1172{
d6714c22 1173 __rcu_offline_cpu(cpu, &rcu_sched_state);
64db4cff 1174 __rcu_offline_cpu(cpu, &rcu_bh_state);
33f76148 1175 rcu_preempt_offline_cpu(cpu);
64db4cff
PM
1176}
1177
1178#else /* #ifdef CONFIG_HOTPLUG_CPU */
1179
29494be7 1180static void rcu_send_cbs_to_online(struct rcu_state *rsp)
e74f4c45
PM
1181{
1182}
1183
64db4cff
PM
1184static void rcu_offline_cpu(int cpu)
1185{
1186}
1187
1188#endif /* #else #ifdef CONFIG_HOTPLUG_CPU */
1189
1190/*
1191 * Invoke any RCU callbacks that have made it to the end of their grace
1192 * period. Thottle as specified by rdp->blimit.
1193 */
37c72e56 1194static void rcu_do_batch(struct rcu_state *rsp, struct rcu_data *rdp)
64db4cff
PM
1195{
1196 unsigned long flags;
1197 struct rcu_head *next, *list, **tail;
29c00b4a 1198 int bl, count;
64db4cff
PM
1199
1200 /* If no callbacks are ready, just return.*/
29c00b4a 1201 if (!cpu_has_callbacks_ready_to_invoke(rdp)) {
72fe701b
PM
1202 trace_rcu_batch_start(rsp->name, 0, 0);
1203 trace_rcu_batch_end(rsp->name, 0);
64db4cff 1204 return;
29c00b4a 1205 }
64db4cff
PM
1206
1207 /*
1208 * Extract the list of ready callbacks, disabling to prevent
1209 * races with call_rcu() from interrupt handlers.
1210 */
1211 local_irq_save(flags);
29c00b4a 1212 bl = rdp->blimit;
72fe701b 1213 trace_rcu_batch_start(rsp->name, rdp->qlen, bl);
64db4cff
PM
1214 list = rdp->nxtlist;
1215 rdp->nxtlist = *rdp->nxttail[RCU_DONE_TAIL];
1216 *rdp->nxttail[RCU_DONE_TAIL] = NULL;
1217 tail = rdp->nxttail[RCU_DONE_TAIL];
1218 for (count = RCU_NEXT_SIZE - 1; count >= 0; count--)
1219 if (rdp->nxttail[count] == rdp->nxttail[RCU_DONE_TAIL])
1220 rdp->nxttail[count] = &rdp->nxtlist;
1221 local_irq_restore(flags);
1222
1223 /* Invoke callbacks. */
1224 count = 0;
1225 while (list) {
1226 next = list->next;
1227 prefetch(next);
551d55a9 1228 debug_rcu_head_unqueue(list);
9ab1544e 1229 __rcu_reclaim(list);
64db4cff 1230 list = next;
29c00b4a 1231 if (++count >= bl)
64db4cff
PM
1232 break;
1233 }
1234
1235 local_irq_save(flags);
72fe701b 1236 trace_rcu_batch_end(rsp->name, count);
64db4cff
PM
1237
1238 /* Update count, and requeue any remaining callbacks. */
1239 rdp->qlen -= count;
269dcc1c 1240 rdp->n_cbs_invoked += count;
64db4cff
PM
1241 if (list != NULL) {
1242 *tail = rdp->nxtlist;
1243 rdp->nxtlist = list;
1244 for (count = 0; count < RCU_NEXT_SIZE; count++)
1245 if (&rdp->nxtlist == rdp->nxttail[count])
1246 rdp->nxttail[count] = tail;
1247 else
1248 break;
1249 }
1250
1251 /* Reinstate batch limit if we have worked down the excess. */
1252 if (rdp->blimit == LONG_MAX && rdp->qlen <= qlowmark)
1253 rdp->blimit = blimit;
1254
37c72e56
PM
1255 /* Reset ->qlen_last_fqs_check trigger if enough CBs have drained. */
1256 if (rdp->qlen == 0 && rdp->qlen_last_fqs_check != 0) {
1257 rdp->qlen_last_fqs_check = 0;
1258 rdp->n_force_qs_snap = rsp->n_force_qs;
1259 } else if (rdp->qlen < rdp->qlen_last_fqs_check - qhimark)
1260 rdp->qlen_last_fqs_check = rdp->qlen;
1261
64db4cff
PM
1262 local_irq_restore(flags);
1263
e0f23060 1264 /* Re-invoke RCU core processing if there are callbacks remaining. */
64db4cff 1265 if (cpu_has_callbacks_ready_to_invoke(rdp))
a46e0899 1266 invoke_rcu_core();
64db4cff
PM
1267}
1268
1269/*
1270 * Check to see if this CPU is in a non-context-switch quiescent state
1271 * (user mode or idle loop for rcu, non-softirq execution for rcu_bh).
e0f23060 1272 * Also schedule RCU core processing.
64db4cff
PM
1273 *
1274 * This function must be called with hardirqs disabled. It is normally
1275 * invoked from the scheduling-clock interrupt. If rcu_pending returns
1276 * false, there is no point in invoking rcu_check_callbacks().
1277 */
1278void rcu_check_callbacks(int cpu, int user)
1279{
300df91c 1280 trace_rcu_utilization("Start scheduler-tick");
64db4cff 1281 if (user ||
a6826048
PM
1282 (idle_cpu(cpu) && rcu_scheduler_active &&
1283 !in_softirq() && hardirq_count() <= (1 << HARDIRQ_SHIFT))) {
64db4cff
PM
1284
1285 /*
1286 * Get here if this CPU took its interrupt from user
1287 * mode or from the idle loop, and if this is not a
1288 * nested interrupt. In this case, the CPU is in
d6714c22 1289 * a quiescent state, so note it.
64db4cff
PM
1290 *
1291 * No memory barrier is required here because both
d6714c22
PM
1292 * rcu_sched_qs() and rcu_bh_qs() reference only CPU-local
1293 * variables that other CPUs neither access nor modify,
1294 * at least not while the corresponding CPU is online.
64db4cff
PM
1295 */
1296
d6714c22
PM
1297 rcu_sched_qs(cpu);
1298 rcu_bh_qs(cpu);
64db4cff
PM
1299
1300 } else if (!in_softirq()) {
1301
1302 /*
1303 * Get here if this CPU did not take its interrupt from
1304 * softirq, in other words, if it is not interrupting
1305 * a rcu_bh read-side critical section. This is an _bh
d6714c22 1306 * critical section, so note it.
64db4cff
PM
1307 */
1308
d6714c22 1309 rcu_bh_qs(cpu);
64db4cff 1310 }
f41d911f 1311 rcu_preempt_check_callbacks(cpu);
d21670ac 1312 if (rcu_pending(cpu))
a46e0899 1313 invoke_rcu_core();
300df91c 1314 trace_rcu_utilization("End scheduler-tick");
64db4cff
PM
1315}
1316
1317#ifdef CONFIG_SMP
1318
1319/*
1320 * Scan the leaf rcu_node structures, processing dyntick state for any that
1321 * have not yet encountered a quiescent state, using the function specified.
27f4d280
PM
1322 * Also initiate boosting for any threads blocked on the root rcu_node.
1323 *
ee47eb9f 1324 * The caller must have suppressed start of new grace periods.
64db4cff 1325 */
45f014c5 1326static void force_qs_rnp(struct rcu_state *rsp, int (*f)(struct rcu_data *))
64db4cff
PM
1327{
1328 unsigned long bit;
1329 int cpu;
1330 unsigned long flags;
1331 unsigned long mask;
a0b6c9a7 1332 struct rcu_node *rnp;
64db4cff 1333
a0b6c9a7 1334 rcu_for_each_leaf_node(rsp, rnp) {
64db4cff 1335 mask = 0;
1304afb2 1336 raw_spin_lock_irqsave(&rnp->lock, flags);
ee47eb9f 1337 if (!rcu_gp_in_progress(rsp)) {
1304afb2 1338 raw_spin_unlock_irqrestore(&rnp->lock, flags);
0f10dc82 1339 return;
64db4cff 1340 }
a0b6c9a7 1341 if (rnp->qsmask == 0) {
1217ed1b 1342 rcu_initiate_boost(rnp, flags); /* releases rnp->lock */
64db4cff
PM
1343 continue;
1344 }
a0b6c9a7 1345 cpu = rnp->grplo;
64db4cff 1346 bit = 1;
a0b6c9a7 1347 for (; cpu <= rnp->grphi; cpu++, bit <<= 1) {
394f99a9
LJ
1348 if ((rnp->qsmask & bit) != 0 &&
1349 f(per_cpu_ptr(rsp->rda, cpu)))
64db4cff
PM
1350 mask |= bit;
1351 }
45f014c5 1352 if (mask != 0) {
64db4cff 1353
d3f6bad3
PM
1354 /* rcu_report_qs_rnp() releases rnp->lock. */
1355 rcu_report_qs_rnp(mask, rsp, rnp, flags);
64db4cff
PM
1356 continue;
1357 }
1304afb2 1358 raw_spin_unlock_irqrestore(&rnp->lock, flags);
64db4cff 1359 }
27f4d280 1360 rnp = rcu_get_root(rsp);
1217ed1b
PM
1361 if (rnp->qsmask == 0) {
1362 raw_spin_lock_irqsave(&rnp->lock, flags);
1363 rcu_initiate_boost(rnp, flags); /* releases rnp->lock. */
1364 }
64db4cff
PM
1365}
1366
1367/*
1368 * Force quiescent states on reluctant CPUs, and also detect which
1369 * CPUs are in dyntick-idle mode.
1370 */
1371static void force_quiescent_state(struct rcu_state *rsp, int relaxed)
1372{
1373 unsigned long flags;
64db4cff 1374 struct rcu_node *rnp = rcu_get_root(rsp);
64db4cff 1375
300df91c
PM
1376 trace_rcu_utilization("Start fqs");
1377 if (!rcu_gp_in_progress(rsp)) {
1378 trace_rcu_utilization("End fqs");
64db4cff 1379 return; /* No grace period in progress, nothing to force. */
300df91c 1380 }
1304afb2 1381 if (!raw_spin_trylock_irqsave(&rsp->fqslock, flags)) {
64db4cff 1382 rsp->n_force_qs_lh++; /* Inexact, can lose counts. Tough! */
300df91c 1383 trace_rcu_utilization("End fqs");
64db4cff
PM
1384 return; /* Someone else is already on the job. */
1385 }
20133cfc 1386 if (relaxed && ULONG_CMP_GE(rsp->jiffies_force_qs, jiffies))
f96e9232 1387 goto unlock_fqs_ret; /* no emergency and done recently. */
64db4cff 1388 rsp->n_force_qs++;
1304afb2 1389 raw_spin_lock(&rnp->lock); /* irqs already disabled */
64db4cff 1390 rsp->jiffies_force_qs = jiffies + RCU_JIFFIES_TILL_FORCE_QS;
560d4bc0 1391 if(!rcu_gp_in_progress(rsp)) {
64db4cff 1392 rsp->n_force_qs_ngp++;
1304afb2 1393 raw_spin_unlock(&rnp->lock); /* irqs remain disabled */
f96e9232 1394 goto unlock_fqs_ret; /* no GP in progress, time updated. */
64db4cff 1395 }
07079d53 1396 rsp->fqs_active = 1;
f3a8b5c6 1397 switch (rsp->signaled) {
83f5b01f 1398 case RCU_GP_IDLE:
64db4cff
PM
1399 case RCU_GP_INIT:
1400
83f5b01f 1401 break; /* grace period idle or initializing, ignore. */
64db4cff
PM
1402
1403 case RCU_SAVE_DYNTICK:
64db4cff
PM
1404 if (RCU_SIGNAL_INIT != RCU_SAVE_DYNTICK)
1405 break; /* So gcc recognizes the dead code. */
1406
f261414f
LJ
1407 raw_spin_unlock(&rnp->lock); /* irqs remain disabled */
1408
64db4cff 1409 /* Record dyntick-idle state. */
45f014c5 1410 force_qs_rnp(rsp, dyntick_save_progress_counter);
1304afb2 1411 raw_spin_lock(&rnp->lock); /* irqs already disabled */
ee47eb9f 1412 if (rcu_gp_in_progress(rsp))
64db4cff 1413 rsp->signaled = RCU_FORCE_QS;
ee47eb9f 1414 break;
64db4cff
PM
1415
1416 case RCU_FORCE_QS:
1417
1418 /* Check dyntick-idle state, send IPI to laggarts. */
1304afb2 1419 raw_spin_unlock(&rnp->lock); /* irqs remain disabled */
45f014c5 1420 force_qs_rnp(rsp, rcu_implicit_dynticks_qs);
64db4cff
PM
1421
1422 /* Leave state in case more forcing is required. */
1423
1304afb2 1424 raw_spin_lock(&rnp->lock); /* irqs already disabled */
f96e9232 1425 break;
64db4cff 1426 }
07079d53 1427 rsp->fqs_active = 0;
46a1e34e 1428 if (rsp->fqs_need_gp) {
1304afb2 1429 raw_spin_unlock(&rsp->fqslock); /* irqs remain disabled */
46a1e34e
PM
1430 rsp->fqs_need_gp = 0;
1431 rcu_start_gp(rsp, flags); /* releases rnp->lock */
300df91c 1432 trace_rcu_utilization("End fqs");
46a1e34e
PM
1433 return;
1434 }
1304afb2 1435 raw_spin_unlock(&rnp->lock); /* irqs remain disabled */
f96e9232 1436unlock_fqs_ret:
1304afb2 1437 raw_spin_unlock_irqrestore(&rsp->fqslock, flags);
300df91c 1438 trace_rcu_utilization("End fqs");
64db4cff
PM
1439}
1440
1441#else /* #ifdef CONFIG_SMP */
1442
1443static void force_quiescent_state(struct rcu_state *rsp, int relaxed)
1444{
1445 set_need_resched();
1446}
1447
1448#endif /* #else #ifdef CONFIG_SMP */
1449
1450/*
e0f23060
PM
1451 * This does the RCU core processing work for the specified rcu_state
1452 * and rcu_data structures. This may be called only from the CPU to
1453 * whom the rdp belongs.
64db4cff
PM
1454 */
1455static void
1456__rcu_process_callbacks(struct rcu_state *rsp, struct rcu_data *rdp)
1457{
1458 unsigned long flags;
1459
2e597558
PM
1460 WARN_ON_ONCE(rdp->beenonline == 0);
1461
64db4cff
PM
1462 /*
1463 * If an RCU GP has gone long enough, go check for dyntick
1464 * idle CPUs and, if needed, send resched IPIs.
1465 */
20133cfc 1466 if (ULONG_CMP_LT(ACCESS_ONCE(rsp->jiffies_force_qs), jiffies))
64db4cff
PM
1467 force_quiescent_state(rsp, 1);
1468
1469 /*
1470 * Advance callbacks in response to end of earlier grace
1471 * period that some other CPU ended.
1472 */
1473 rcu_process_gp_end(rsp, rdp);
1474
1475 /* Update RCU state based on any recent quiescent states. */
1476 rcu_check_quiescent_state(rsp, rdp);
1477
1478 /* Does this CPU require a not-yet-started grace period? */
1479 if (cpu_needs_another_gp(rsp, rdp)) {
1304afb2 1480 raw_spin_lock_irqsave(&rcu_get_root(rsp)->lock, flags);
64db4cff
PM
1481 rcu_start_gp(rsp, flags); /* releases above lock */
1482 }
1483
1484 /* If there are callbacks ready, invoke them. */
09223371 1485 if (cpu_has_callbacks_ready_to_invoke(rdp))
a46e0899 1486 invoke_rcu_callbacks(rsp, rdp);
09223371
SL
1487}
1488
64db4cff 1489/*
e0f23060 1490 * Do RCU core processing for the current CPU.
64db4cff 1491 */
09223371 1492static void rcu_process_callbacks(struct softirq_action *unused)
64db4cff 1493{
300df91c 1494 trace_rcu_utilization("Start RCU core");
d6714c22
PM
1495 __rcu_process_callbacks(&rcu_sched_state,
1496 &__get_cpu_var(rcu_sched_data));
64db4cff 1497 __rcu_process_callbacks(&rcu_bh_state, &__get_cpu_var(rcu_bh_data));
f41d911f 1498 rcu_preempt_process_callbacks();
a47cd880
PM
1499
1500 /* If we are last CPU on way to dyntick-idle mode, accelerate it. */
1501 rcu_needs_cpu_flush();
300df91c 1502 trace_rcu_utilization("End RCU core");
64db4cff
PM
1503}
1504
a26ac245 1505/*
e0f23060
PM
1506 * Schedule RCU callback invocation. If the specified type of RCU
1507 * does not support RCU priority boosting, just do a direct call,
1508 * otherwise wake up the per-CPU kernel kthread. Note that because we
1509 * are running on the current CPU with interrupts disabled, the
1510 * rcu_cpu_kthread_task cannot disappear out from under us.
a26ac245 1511 */
a46e0899 1512static void invoke_rcu_callbacks(struct rcu_state *rsp, struct rcu_data *rdp)
a26ac245 1513{
b0d30417
PM
1514 if (unlikely(!ACCESS_ONCE(rcu_scheduler_fully_active)))
1515 return;
a46e0899
PM
1516 if (likely(!rsp->boost)) {
1517 rcu_do_batch(rsp, rdp);
a26ac245
PM
1518 return;
1519 }
a46e0899 1520 invoke_rcu_callbacks_kthread();
a26ac245
PM
1521}
1522
a46e0899 1523static void invoke_rcu_core(void)
09223371
SL
1524{
1525 raise_softirq(RCU_SOFTIRQ);
1526}
1527
64db4cff
PM
1528static void
1529__call_rcu(struct rcu_head *head, void (*func)(struct rcu_head *rcu),
1530 struct rcu_state *rsp)
1531{
1532 unsigned long flags;
1533 struct rcu_data *rdp;
1534
551d55a9 1535 debug_rcu_head_queue(head);
64db4cff
PM
1536 head->func = func;
1537 head->next = NULL;
1538
1539 smp_mb(); /* Ensure RCU update seen before callback registry. */
1540
1541 /*
1542 * Opportunistically note grace-period endings and beginnings.
1543 * Note that we might see a beginning right after we see an
1544 * end, but never vice versa, since this CPU has to pass through
1545 * a quiescent state betweentimes.
1546 */
1547 local_irq_save(flags);
394f99a9 1548 rdp = this_cpu_ptr(rsp->rda);
64db4cff
PM
1549
1550 /* Add the callback to our list. */
1551 *rdp->nxttail[RCU_NEXT_TAIL] = head;
1552 rdp->nxttail[RCU_NEXT_TAIL] = &head->next;
2655d57e
PM
1553 rdp->qlen++;
1554
1555 /* If interrupts were disabled, don't dive into RCU core. */
1556 if (irqs_disabled_flags(flags)) {
1557 local_irq_restore(flags);
1558 return;
1559 }
64db4cff 1560
37c72e56
PM
1561 /*
1562 * Force the grace period if too many callbacks or too long waiting.
1563 * Enforce hysteresis, and don't invoke force_quiescent_state()
1564 * if some other CPU has recently done so. Also, don't bother
1565 * invoking force_quiescent_state() if the newly enqueued callback
1566 * is the only one waiting for a grace period to complete.
1567 */
2655d57e 1568 if (unlikely(rdp->qlen > rdp->qlen_last_fqs_check + qhimark)) {
b52573d2
PM
1569
1570 /* Are we ignoring a completed grace period? */
1571 rcu_process_gp_end(rsp, rdp);
1572 check_for_new_grace_period(rsp, rdp);
1573
1574 /* Start a new grace period if one not already started. */
1575 if (!rcu_gp_in_progress(rsp)) {
1576 unsigned long nestflag;
1577 struct rcu_node *rnp_root = rcu_get_root(rsp);
1578
1579 raw_spin_lock_irqsave(&rnp_root->lock, nestflag);
1580 rcu_start_gp(rsp, nestflag); /* rlses rnp_root->lock */
1581 } else {
1582 /* Give the grace period a kick. */
1583 rdp->blimit = LONG_MAX;
1584 if (rsp->n_force_qs == rdp->n_force_qs_snap &&
1585 *rdp->nxttail[RCU_DONE_TAIL] != head)
1586 force_quiescent_state(rsp, 0);
1587 rdp->n_force_qs_snap = rsp->n_force_qs;
1588 rdp->qlen_last_fqs_check = rdp->qlen;
1589 }
20133cfc 1590 } else if (ULONG_CMP_LT(ACCESS_ONCE(rsp->jiffies_force_qs), jiffies))
64db4cff
PM
1591 force_quiescent_state(rsp, 1);
1592 local_irq_restore(flags);
1593}
1594
1595/*
d6714c22 1596 * Queue an RCU-sched callback for invocation after a grace period.
64db4cff 1597 */
d6714c22 1598void call_rcu_sched(struct rcu_head *head, void (*func)(struct rcu_head *rcu))
64db4cff 1599{
d6714c22 1600 __call_rcu(head, func, &rcu_sched_state);
64db4cff 1601}
d6714c22 1602EXPORT_SYMBOL_GPL(call_rcu_sched);
64db4cff
PM
1603
1604/*
1605 * Queue an RCU for invocation after a quicker grace period.
1606 */
1607void call_rcu_bh(struct rcu_head *head, void (*func)(struct rcu_head *rcu))
1608{
1609 __call_rcu(head, func, &rcu_bh_state);
1610}
1611EXPORT_SYMBOL_GPL(call_rcu_bh);
1612
6ebb237b
PM
1613/**
1614 * synchronize_sched - wait until an rcu-sched grace period has elapsed.
1615 *
1616 * Control will return to the caller some time after a full rcu-sched
1617 * grace period has elapsed, in other words after all currently executing
1618 * rcu-sched read-side critical sections have completed. These read-side
1619 * critical sections are delimited by rcu_read_lock_sched() and
1620 * rcu_read_unlock_sched(), and may be nested. Note that preempt_disable(),
1621 * local_irq_disable(), and so on may be used in place of
1622 * rcu_read_lock_sched().
1623 *
1624 * This means that all preempt_disable code sequences, including NMI and
1625 * hardware-interrupt handlers, in progress on entry will have completed
1626 * before this primitive returns. However, this does not guarantee that
1627 * softirq handlers will have completed, since in some kernels, these
1628 * handlers can run in process context, and can block.
1629 *
1630 * This primitive provides the guarantees made by the (now removed)
1631 * synchronize_kernel() API. In contrast, synchronize_rcu() only
1632 * guarantees that rcu_read_lock() sections will have completed.
1633 * In "classic RCU", these two guarantees happen to be one and
1634 * the same, but can differ in realtime RCU implementations.
1635 */
1636void synchronize_sched(void)
1637{
6ebb237b
PM
1638 if (rcu_blocking_is_gp())
1639 return;
2c42818e 1640 wait_rcu_gp(call_rcu_sched);
6ebb237b
PM
1641}
1642EXPORT_SYMBOL_GPL(synchronize_sched);
1643
1644/**
1645 * synchronize_rcu_bh - wait until an rcu_bh grace period has elapsed.
1646 *
1647 * Control will return to the caller some time after a full rcu_bh grace
1648 * period has elapsed, in other words after all currently executing rcu_bh
1649 * read-side critical sections have completed. RCU read-side critical
1650 * sections are delimited by rcu_read_lock_bh() and rcu_read_unlock_bh(),
1651 * and may be nested.
1652 */
1653void synchronize_rcu_bh(void)
1654{
6ebb237b
PM
1655 if (rcu_blocking_is_gp())
1656 return;
2c42818e 1657 wait_rcu_gp(call_rcu_bh);
6ebb237b
PM
1658}
1659EXPORT_SYMBOL_GPL(synchronize_rcu_bh);
1660
64db4cff
PM
1661/*
1662 * Check to see if there is any immediate RCU-related work to be done
1663 * by the current CPU, for the specified type of RCU, returning 1 if so.
1664 * The checks are in order of increasing expense: checks that can be
1665 * carried out against CPU-local state are performed first. However,
1666 * we must check for CPU stalls first, else we might not get a chance.
1667 */
1668static int __rcu_pending(struct rcu_state *rsp, struct rcu_data *rdp)
1669{
2f51f988
PM
1670 struct rcu_node *rnp = rdp->mynode;
1671
64db4cff
PM
1672 rdp->n_rcu_pending++;
1673
1674 /* Check for CPU stalls, if enabled. */
1675 check_cpu_stall(rsp, rdp);
1676
1677 /* Is the RCU core waiting for a quiescent state from this CPU? */
d21670ac 1678 if (rdp->qs_pending && !rdp->passed_quiesc) {
d25eb944
PM
1679
1680 /*
1681 * If force_quiescent_state() coming soon and this CPU
1682 * needs a quiescent state, and this is either RCU-sched
1683 * or RCU-bh, force a local reschedule.
1684 */
d21670ac 1685 rdp->n_rp_qs_pending++;
6cc68793 1686 if (!rdp->preemptible &&
d25eb944
PM
1687 ULONG_CMP_LT(ACCESS_ONCE(rsp->jiffies_force_qs) - 1,
1688 jiffies))
1689 set_need_resched();
d21670ac
PM
1690 } else if (rdp->qs_pending && rdp->passed_quiesc) {
1691 rdp->n_rp_report_qs++;
64db4cff 1692 return 1;
7ba5c840 1693 }
64db4cff
PM
1694
1695 /* Does this CPU have callbacks ready to invoke? */
7ba5c840
PM
1696 if (cpu_has_callbacks_ready_to_invoke(rdp)) {
1697 rdp->n_rp_cb_ready++;
64db4cff 1698 return 1;
7ba5c840 1699 }
64db4cff
PM
1700
1701 /* Has RCU gone idle with this CPU needing another grace period? */
7ba5c840
PM
1702 if (cpu_needs_another_gp(rsp, rdp)) {
1703 rdp->n_rp_cpu_needs_gp++;
64db4cff 1704 return 1;
7ba5c840 1705 }
64db4cff
PM
1706
1707 /* Has another RCU grace period completed? */
2f51f988 1708 if (ACCESS_ONCE(rnp->completed) != rdp->completed) { /* outside lock */
7ba5c840 1709 rdp->n_rp_gp_completed++;
64db4cff 1710 return 1;
7ba5c840 1711 }
64db4cff
PM
1712
1713 /* Has a new RCU grace period started? */
2f51f988 1714 if (ACCESS_ONCE(rnp->gpnum) != rdp->gpnum) { /* outside lock */
7ba5c840 1715 rdp->n_rp_gp_started++;
64db4cff 1716 return 1;
7ba5c840 1717 }
64db4cff
PM
1718
1719 /* Has an RCU GP gone long enough to send resched IPIs &c? */
fc2219d4 1720 if (rcu_gp_in_progress(rsp) &&
20133cfc 1721 ULONG_CMP_LT(ACCESS_ONCE(rsp->jiffies_force_qs), jiffies)) {
7ba5c840 1722 rdp->n_rp_need_fqs++;
64db4cff 1723 return 1;
7ba5c840 1724 }
64db4cff
PM
1725
1726 /* nothing to do */
7ba5c840 1727 rdp->n_rp_need_nothing++;
64db4cff
PM
1728 return 0;
1729}
1730
1731/*
1732 * Check to see if there is any immediate RCU-related work to be done
1733 * by the current CPU, returning 1 if so. This function is part of the
1734 * RCU implementation; it is -not- an exported member of the RCU API.
1735 */
a157229c 1736static int rcu_pending(int cpu)
64db4cff 1737{
d6714c22 1738 return __rcu_pending(&rcu_sched_state, &per_cpu(rcu_sched_data, cpu)) ||
f41d911f
PM
1739 __rcu_pending(&rcu_bh_state, &per_cpu(rcu_bh_data, cpu)) ||
1740 rcu_preempt_pending(cpu);
64db4cff
PM
1741}
1742
1743/*
1744 * Check to see if any future RCU-related work will need to be done
1745 * by the current CPU, even if none need be done immediately, returning
8bd93a2c 1746 * 1 if so.
64db4cff 1747 */
8bd93a2c 1748static int rcu_needs_cpu_quick_check(int cpu)
64db4cff
PM
1749{
1750 /* RCU callbacks either ready or pending? */
d6714c22 1751 return per_cpu(rcu_sched_data, cpu).nxtlist ||
f41d911f
PM
1752 per_cpu(rcu_bh_data, cpu).nxtlist ||
1753 rcu_preempt_needs_cpu(cpu);
64db4cff
PM
1754}
1755
d0ec774c
PM
1756static DEFINE_PER_CPU(struct rcu_head, rcu_barrier_head) = {NULL};
1757static atomic_t rcu_barrier_cpu_count;
1758static DEFINE_MUTEX(rcu_barrier_mutex);
1759static struct completion rcu_barrier_completion;
d0ec774c
PM
1760
1761static void rcu_barrier_callback(struct rcu_head *notused)
1762{
1763 if (atomic_dec_and_test(&rcu_barrier_cpu_count))
1764 complete(&rcu_barrier_completion);
1765}
1766
1767/*
1768 * Called with preemption disabled, and from cross-cpu IRQ context.
1769 */
1770static void rcu_barrier_func(void *type)
1771{
1772 int cpu = smp_processor_id();
1773 struct rcu_head *head = &per_cpu(rcu_barrier_head, cpu);
1774 void (*call_rcu_func)(struct rcu_head *head,
1775 void (*func)(struct rcu_head *head));
1776
1777 atomic_inc(&rcu_barrier_cpu_count);
1778 call_rcu_func = type;
1779 call_rcu_func(head, rcu_barrier_callback);
1780}
1781
d0ec774c
PM
1782/*
1783 * Orchestrate the specified type of RCU barrier, waiting for all
1784 * RCU callbacks of the specified type to complete.
1785 */
e74f4c45
PM
1786static void _rcu_barrier(struct rcu_state *rsp,
1787 void (*call_rcu_func)(struct rcu_head *head,
d0ec774c
PM
1788 void (*func)(struct rcu_head *head)))
1789{
1790 BUG_ON(in_interrupt());
e74f4c45 1791 /* Take mutex to serialize concurrent rcu_barrier() requests. */
d0ec774c
PM
1792 mutex_lock(&rcu_barrier_mutex);
1793 init_completion(&rcu_barrier_completion);
1794 /*
1795 * Initialize rcu_barrier_cpu_count to 1, then invoke
1796 * rcu_barrier_func() on each CPU, so that each CPU also has
1797 * incremented rcu_barrier_cpu_count. Only then is it safe to
1798 * decrement rcu_barrier_cpu_count -- otherwise the first CPU
1799 * might complete its grace period before all of the other CPUs
1800 * did their increment, causing this function to return too
2d999e03
PM
1801 * early. Note that on_each_cpu() disables irqs, which prevents
1802 * any CPUs from coming online or going offline until each online
1803 * CPU has queued its RCU-barrier callback.
d0ec774c
PM
1804 */
1805 atomic_set(&rcu_barrier_cpu_count, 1);
1806 on_each_cpu(rcu_barrier_func, (void *)call_rcu_func, 1);
1807 if (atomic_dec_and_test(&rcu_barrier_cpu_count))
1808 complete(&rcu_barrier_completion);
1809 wait_for_completion(&rcu_barrier_completion);
1810 mutex_unlock(&rcu_barrier_mutex);
d0ec774c 1811}
d0ec774c
PM
1812
1813/**
1814 * rcu_barrier_bh - Wait until all in-flight call_rcu_bh() callbacks complete.
1815 */
1816void rcu_barrier_bh(void)
1817{
e74f4c45 1818 _rcu_barrier(&rcu_bh_state, call_rcu_bh);
d0ec774c
PM
1819}
1820EXPORT_SYMBOL_GPL(rcu_barrier_bh);
1821
1822/**
1823 * rcu_barrier_sched - Wait for in-flight call_rcu_sched() callbacks.
1824 */
1825void rcu_barrier_sched(void)
1826{
e74f4c45 1827 _rcu_barrier(&rcu_sched_state, call_rcu_sched);
d0ec774c
PM
1828}
1829EXPORT_SYMBOL_GPL(rcu_barrier_sched);
1830
64db4cff 1831/*
27569620 1832 * Do boot-time initialization of a CPU's per-CPU RCU data.
64db4cff 1833 */
27569620
PM
1834static void __init
1835rcu_boot_init_percpu_data(int cpu, struct rcu_state *rsp)
64db4cff
PM
1836{
1837 unsigned long flags;
1838 int i;
394f99a9 1839 struct rcu_data *rdp = per_cpu_ptr(rsp->rda, cpu);
27569620
PM
1840 struct rcu_node *rnp = rcu_get_root(rsp);
1841
1842 /* Set up local state, ensuring consistent view of global state. */
1304afb2 1843 raw_spin_lock_irqsave(&rnp->lock, flags);
27569620
PM
1844 rdp->grpmask = 1UL << (cpu - rdp->mynode->grplo);
1845 rdp->nxtlist = NULL;
1846 for (i = 0; i < RCU_NEXT_SIZE; i++)
1847 rdp->nxttail[i] = &rdp->nxtlist;
1848 rdp->qlen = 0;
1849#ifdef CONFIG_NO_HZ
1850 rdp->dynticks = &per_cpu(rcu_dynticks, cpu);
1851#endif /* #ifdef CONFIG_NO_HZ */
1852 rdp->cpu = cpu;
1304afb2 1853 raw_spin_unlock_irqrestore(&rnp->lock, flags);
27569620
PM
1854}
1855
1856/*
1857 * Initialize a CPU's per-CPU RCU data. Note that only one online or
1858 * offline event can be happening at a given time. Note also that we
1859 * can accept some slop in the rsp->completed access due to the fact
1860 * that this CPU cannot possibly have any RCU callbacks in flight yet.
64db4cff 1861 */
e4fa4c97 1862static void __cpuinit
6cc68793 1863rcu_init_percpu_data(int cpu, struct rcu_state *rsp, int preemptible)
64db4cff
PM
1864{
1865 unsigned long flags;
64db4cff 1866 unsigned long mask;
394f99a9 1867 struct rcu_data *rdp = per_cpu_ptr(rsp->rda, cpu);
64db4cff
PM
1868 struct rcu_node *rnp = rcu_get_root(rsp);
1869
1870 /* Set up local state, ensuring consistent view of global state. */
1304afb2 1871 raw_spin_lock_irqsave(&rnp->lock, flags);
64db4cff
PM
1872 rdp->passed_quiesc = 0; /* We could be racing with new GP, */
1873 rdp->qs_pending = 1; /* so set up to respond to current GP. */
1874 rdp->beenonline = 1; /* We have now been online. */
6cc68793 1875 rdp->preemptible = preemptible;
37c72e56
PM
1876 rdp->qlen_last_fqs_check = 0;
1877 rdp->n_force_qs_snap = rsp->n_force_qs;
64db4cff 1878 rdp->blimit = blimit;
1304afb2 1879 raw_spin_unlock(&rnp->lock); /* irqs remain disabled. */
64db4cff
PM
1880
1881 /*
1882 * A new grace period might start here. If so, we won't be part
1883 * of it, but that is OK, as we are currently in a quiescent state.
1884 */
1885
1886 /* Exclude any attempts to start a new GP on large systems. */
1304afb2 1887 raw_spin_lock(&rsp->onofflock); /* irqs already disabled. */
64db4cff
PM
1888
1889 /* Add CPU to rcu_node bitmasks. */
1890 rnp = rdp->mynode;
1891 mask = rdp->grpmask;
1892 do {
1893 /* Exclude any attempts to start a new GP on small systems. */
1304afb2 1894 raw_spin_lock(&rnp->lock); /* irqs already disabled. */
64db4cff
PM
1895 rnp->qsmaskinit |= mask;
1896 mask = rnp->grpmask;
d09b62df
PM
1897 if (rnp == rdp->mynode) {
1898 rdp->gpnum = rnp->completed; /* if GP in progress... */
1899 rdp->completed = rnp->completed;
1900 rdp->passed_quiesc_completed = rnp->completed - 1;
1901 }
1304afb2 1902 raw_spin_unlock(&rnp->lock); /* irqs already disabled. */
64db4cff
PM
1903 rnp = rnp->parent;
1904 } while (rnp != NULL && !(rnp->qsmaskinit & mask));
1905
1304afb2 1906 raw_spin_unlock_irqrestore(&rsp->onofflock, flags);
64db4cff
PM
1907}
1908
d72bce0e 1909static void __cpuinit rcu_prepare_cpu(int cpu)
64db4cff 1910{
f41d911f
PM
1911 rcu_init_percpu_data(cpu, &rcu_sched_state, 0);
1912 rcu_init_percpu_data(cpu, &rcu_bh_state, 0);
1913 rcu_preempt_init_percpu_data(cpu);
64db4cff
PM
1914}
1915
1916/*
f41d911f 1917 * Handle CPU online/offline notification events.
64db4cff 1918 */
9f680ab4
PM
1919static int __cpuinit rcu_cpu_notify(struct notifier_block *self,
1920 unsigned long action, void *hcpu)
64db4cff
PM
1921{
1922 long cpu = (long)hcpu;
27f4d280 1923 struct rcu_data *rdp = per_cpu_ptr(rcu_state->rda, cpu);
a26ac245 1924 struct rcu_node *rnp = rdp->mynode;
64db4cff 1925
300df91c 1926 trace_rcu_utilization("Start CPU hotplug");
64db4cff
PM
1927 switch (action) {
1928 case CPU_UP_PREPARE:
1929 case CPU_UP_PREPARE_FROZEN:
d72bce0e
PZ
1930 rcu_prepare_cpu(cpu);
1931 rcu_prepare_kthreads(cpu);
a26ac245
PM
1932 break;
1933 case CPU_ONLINE:
0f962a5e
PM
1934 case CPU_DOWN_FAILED:
1935 rcu_node_kthread_setaffinity(rnp, -1);
e3995a25 1936 rcu_cpu_kthread_setrt(cpu, 1);
0f962a5e
PM
1937 break;
1938 case CPU_DOWN_PREPARE:
1939 rcu_node_kthread_setaffinity(rnp, cpu);
e3995a25 1940 rcu_cpu_kthread_setrt(cpu, 0);
64db4cff 1941 break;
d0ec774c
PM
1942 case CPU_DYING:
1943 case CPU_DYING_FROZEN:
1944 /*
2d999e03
PM
1945 * The whole machine is "stopped" except this CPU, so we can
1946 * touch any data without introducing corruption. We send the
1947 * dying CPU's callbacks to an arbitrarily chosen online CPU.
d0ec774c 1948 */
29494be7
LJ
1949 rcu_send_cbs_to_online(&rcu_bh_state);
1950 rcu_send_cbs_to_online(&rcu_sched_state);
1951 rcu_preempt_send_cbs_to_online();
d0ec774c 1952 break;
64db4cff
PM
1953 case CPU_DEAD:
1954 case CPU_DEAD_FROZEN:
1955 case CPU_UP_CANCELED:
1956 case CPU_UP_CANCELED_FROZEN:
1957 rcu_offline_cpu(cpu);
1958 break;
1959 default:
1960 break;
1961 }
300df91c 1962 trace_rcu_utilization("End CPU hotplug");
64db4cff
PM
1963 return NOTIFY_OK;
1964}
1965
bbad9379
PM
1966/*
1967 * This function is invoked towards the end of the scheduler's initialization
1968 * process. Before this is called, the idle task might contain
1969 * RCU read-side critical sections (during which time, this idle
1970 * task is booting the system). After this function is called, the
1971 * idle tasks are prohibited from containing RCU read-side critical
1972 * sections. This function also enables RCU lockdep checking.
1973 */
1974void rcu_scheduler_starting(void)
1975{
1976 WARN_ON(num_online_cpus() != 1);
1977 WARN_ON(nr_context_switches() > 0);
1978 rcu_scheduler_active = 1;
1979}
1980
64db4cff
PM
1981/*
1982 * Compute the per-level fanout, either using the exact fanout specified
1983 * or balancing the tree, depending on CONFIG_RCU_FANOUT_EXACT.
1984 */
1985#ifdef CONFIG_RCU_FANOUT_EXACT
1986static void __init rcu_init_levelspread(struct rcu_state *rsp)
1987{
1988 int i;
1989
0209f649 1990 for (i = NUM_RCU_LVLS - 1; i > 0; i--)
64db4cff 1991 rsp->levelspread[i] = CONFIG_RCU_FANOUT;
0209f649 1992 rsp->levelspread[0] = RCU_FANOUT_LEAF;
64db4cff
PM
1993}
1994#else /* #ifdef CONFIG_RCU_FANOUT_EXACT */
1995static void __init rcu_init_levelspread(struct rcu_state *rsp)
1996{
1997 int ccur;
1998 int cprv;
1999 int i;
2000
2001 cprv = NR_CPUS;
2002 for (i = NUM_RCU_LVLS - 1; i >= 0; i--) {
2003 ccur = rsp->levelcnt[i];
2004 rsp->levelspread[i] = (cprv + ccur - 1) / ccur;
2005 cprv = ccur;
2006 }
2007}
2008#endif /* #else #ifdef CONFIG_RCU_FANOUT_EXACT */
2009
2010/*
2011 * Helper function for rcu_init() that initializes one rcu_state structure.
2012 */
394f99a9
LJ
2013static void __init rcu_init_one(struct rcu_state *rsp,
2014 struct rcu_data __percpu *rda)
64db4cff 2015{
b6407e86
PM
2016 static char *buf[] = { "rcu_node_level_0",
2017 "rcu_node_level_1",
2018 "rcu_node_level_2",
2019 "rcu_node_level_3" }; /* Match MAX_RCU_LVLS */
64db4cff
PM
2020 int cpustride = 1;
2021 int i;
2022 int j;
2023 struct rcu_node *rnp;
2024
b6407e86
PM
2025 BUILD_BUG_ON(MAX_RCU_LVLS > ARRAY_SIZE(buf)); /* Fix buf[] init! */
2026
64db4cff
PM
2027 /* Initialize the level-tracking arrays. */
2028
2029 for (i = 1; i < NUM_RCU_LVLS; i++)
2030 rsp->level[i] = rsp->level[i - 1] + rsp->levelcnt[i - 1];
2031 rcu_init_levelspread(rsp);
2032
2033 /* Initialize the elements themselves, starting from the leaves. */
2034
2035 for (i = NUM_RCU_LVLS - 1; i >= 0; i--) {
2036 cpustride *= rsp->levelspread[i];
2037 rnp = rsp->level[i];
2038 for (j = 0; j < rsp->levelcnt[i]; j++, rnp++) {
1304afb2 2039 raw_spin_lock_init(&rnp->lock);
b6407e86
PM
2040 lockdep_set_class_and_name(&rnp->lock,
2041 &rcu_node_class[i], buf[i]);
f41d911f 2042 rnp->gpnum = 0;
64db4cff
PM
2043 rnp->qsmask = 0;
2044 rnp->qsmaskinit = 0;
2045 rnp->grplo = j * cpustride;
2046 rnp->grphi = (j + 1) * cpustride - 1;
2047 if (rnp->grphi >= NR_CPUS)
2048 rnp->grphi = NR_CPUS - 1;
2049 if (i == 0) {
2050 rnp->grpnum = 0;
2051 rnp->grpmask = 0;
2052 rnp->parent = NULL;
2053 } else {
2054 rnp->grpnum = j % rsp->levelspread[i - 1];
2055 rnp->grpmask = 1UL << rnp->grpnum;
2056 rnp->parent = rsp->level[i - 1] +
2057 j / rsp->levelspread[i - 1];
2058 }
2059 rnp->level = i;
12f5f524 2060 INIT_LIST_HEAD(&rnp->blkd_tasks);
64db4cff
PM
2061 }
2062 }
0c34029a 2063
394f99a9 2064 rsp->rda = rda;
0c34029a
LJ
2065 rnp = rsp->level[NUM_RCU_LVLS - 1];
2066 for_each_possible_cpu(i) {
4a90a068 2067 while (i > rnp->grphi)
0c34029a 2068 rnp++;
394f99a9 2069 per_cpu_ptr(rsp->rda, i)->mynode = rnp;
0c34029a
LJ
2070 rcu_boot_init_percpu_data(i, rsp);
2071 }
64db4cff
PM
2072}
2073
9f680ab4 2074void __init rcu_init(void)
64db4cff 2075{
017c4261 2076 int cpu;
9f680ab4 2077
f41d911f 2078 rcu_bootup_announce();
394f99a9
LJ
2079 rcu_init_one(&rcu_sched_state, &rcu_sched_data);
2080 rcu_init_one(&rcu_bh_state, &rcu_bh_data);
f41d911f 2081 __rcu_init_preempt();
09223371 2082 open_softirq(RCU_SOFTIRQ, rcu_process_callbacks);
9f680ab4
PM
2083
2084 /*
2085 * We don't need protection against CPU-hotplug here because
2086 * this is called early in boot, before either interrupts
2087 * or the scheduler are operational.
2088 */
2089 cpu_notifier(rcu_cpu_notify, 0);
017c4261
PM
2090 for_each_online_cpu(cpu)
2091 rcu_cpu_notify(NULL, CPU_UP_PREPARE, (void *)(long)cpu);
c68de209 2092 check_cpu_stall_init();
64db4cff
PM
2093}
2094
1eba8f84 2095#include "rcutree_plugin.h"
This page took 0.284218 seconds and 5 git commands to generate.