2 * linux/kernel/softirq.c
4 * Copyright (C) 1992 Linus Torvalds
6 * Distribute under GPLv2.
8 * Rewritten. Old one was good in 2.2, but in 2.3 it was immoral. --ANK (990903)
11 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
13 #include <linux/export.h>
14 #include <linux/kernel_stat.h>
15 #include <linux/interrupt.h>
16 #include <linux/init.h>
18 #include <linux/notifier.h>
19 #include <linux/percpu.h>
20 #include <linux/cpu.h>
21 #include <linux/freezer.h>
22 #include <linux/kthread.h>
23 #include <linux/rcupdate.h>
24 #include <linux/ftrace.h>
25 #include <linux/smp.h>
26 #include <linux/smpboot.h>
27 #include <linux/tick.h>
28 #include <linux/irq.h>
30 #define CREATE_TRACE_POINTS
31 #include <trace/events/irq.h>
34 - No shared variables, all the data are CPU local.
35 - If a softirq needs serialization, let it serialize itself
37 - Even if softirq is serialized, only local cpu is marked for
38 execution. Hence, we get something sort of weak cpu binding.
39 Though it is still not clear, will it result in better locality
43 - NET RX softirq. It is multithreaded and does not require
44 any global serialization.
45 - NET TX softirq. It kicks software netdevice queues, hence
46 it is logically serialized per device, but this serialization
47 is invisible to common code.
48 - Tasklets: serialized wrt itself.
51 #ifndef __ARCH_IRQ_STAT
52 irq_cpustat_t irq_stat[NR_CPUS] ____cacheline_aligned;
53 EXPORT_SYMBOL(irq_stat);
56 static struct softirq_action softirq_vec[NR_SOFTIRQS] __cacheline_aligned_in_smp;
58 DEFINE_PER_CPU(struct task_struct *, ksoftirqd);
60 const char * const softirq_to_name[NR_SOFTIRQS] = {
61 "HI", "TIMER", "NET_TX", "NET_RX", "BLOCK", "BLOCK_IOPOLL",
62 "TASKLET", "SCHED", "HRTIMER", "RCU"
66 * we cannot loop indefinitely here to avoid userspace starvation,
67 * but we also don't want to introduce a worst case 1/HZ latency
68 * to the pending events, so lets the scheduler to balance
69 * the softirq load for us.
71 static void wakeup_softirqd(void)
73 /* Interrupts are disabled: no need to stop preemption */
74 struct task_struct *tsk = __this_cpu_read(ksoftirqd);
76 if (tsk && tsk->state != TASK_RUNNING)
81 * preempt_count and SOFTIRQ_OFFSET usage:
82 * - preempt_count is changed by SOFTIRQ_OFFSET on entering or leaving
84 * - preempt_count is changed by SOFTIRQ_DISABLE_OFFSET (= 2 * SOFTIRQ_OFFSET)
85 * on local_bh_disable or local_bh_enable.
86 * This lets us distinguish between whether we are currently processing
87 * softirq and whether we just have bh disabled.
91 * This one is for softirq.c-internal use,
92 * where hardirqs are disabled legitimately:
94 #ifdef CONFIG_TRACE_IRQFLAGS
95 void __local_bh_disable_ip(unsigned long ip, unsigned int cnt)
99 WARN_ON_ONCE(in_irq());
101 raw_local_irq_save(flags);
103 * The preempt tracer hooks into preempt_count_add and will break
104 * lockdep because it calls back into lockdep after SOFTIRQ_OFFSET
105 * is set and before current->softirq_enabled is cleared.
106 * We must manually increment preempt_count here and manually
107 * call the trace_preempt_off later.
109 __preempt_count_add(cnt);
111 * Were softirqs turned off above:
113 if (softirq_count() == (cnt & SOFTIRQ_MASK))
114 trace_softirqs_off(ip);
115 raw_local_irq_restore(flags);
117 if (preempt_count() == cnt) {
118 #ifdef CONFIG_DEBUG_PREEMPT
119 current->preempt_disable_ip = get_parent_ip(CALLER_ADDR1);
121 trace_preempt_off(CALLER_ADDR0, get_parent_ip(CALLER_ADDR1));
124 EXPORT_SYMBOL(__local_bh_disable_ip);
125 #endif /* CONFIG_TRACE_IRQFLAGS */
127 static void __local_bh_enable(unsigned int cnt)
129 WARN_ON_ONCE(!irqs_disabled());
131 if (softirq_count() == (cnt & SOFTIRQ_MASK))
132 trace_softirqs_on(_RET_IP_);
133 preempt_count_sub(cnt);
137 * Special-case - softirqs can safely be enabled in
138 * cond_resched_softirq(), or by __do_softirq(),
139 * without processing still-pending softirqs:
141 void _local_bh_enable(void)
143 WARN_ON_ONCE(in_irq());
144 __local_bh_enable(SOFTIRQ_DISABLE_OFFSET);
146 EXPORT_SYMBOL(_local_bh_enable);
148 void __local_bh_enable_ip(unsigned long ip, unsigned int cnt)
150 WARN_ON_ONCE(in_irq() || irqs_disabled());
151 #ifdef CONFIG_TRACE_IRQFLAGS
155 * Are softirqs going to be turned on now:
157 if (softirq_count() == SOFTIRQ_DISABLE_OFFSET)
158 trace_softirqs_on(ip);
160 * Keep preemption disabled until we are done with
161 * softirq processing:
163 preempt_count_sub(cnt - 1);
165 if (unlikely(!in_interrupt() && local_softirq_pending())) {
167 * Run softirq if any pending. And do it in its own stack
168 * as we may be calling this deep in a task call stack already.
174 #ifdef CONFIG_TRACE_IRQFLAGS
177 preempt_check_resched();
179 EXPORT_SYMBOL(__local_bh_enable_ip);
182 * We restart softirq processing for at most MAX_SOFTIRQ_RESTART times,
183 * but break the loop if need_resched() is set or after 2 ms.
184 * The MAX_SOFTIRQ_TIME provides a nice upper bound in most cases, but in
185 * certain cases, such as stop_machine(), jiffies may cease to
186 * increment and so we need the MAX_SOFTIRQ_RESTART limit as
187 * well to make sure we eventually return from this method.
189 * These limits have been established via experimentation.
190 * The two things to balance is latency against fairness -
191 * we want to handle softirqs as soon as possible, but they
192 * should not be able to lock up the box.
194 #define MAX_SOFTIRQ_TIME msecs_to_jiffies(2)
195 #define MAX_SOFTIRQ_RESTART 10
197 #ifdef CONFIG_TRACE_IRQFLAGS
199 * When we run softirqs from irq_exit() and thus on the hardirq stack we need
200 * to keep the lockdep irq context tracking as tight as possible in order to
201 * not miss-qualify lock contexts and miss possible deadlocks.
204 static inline bool lockdep_softirq_start(void)
206 bool in_hardirq = false;
208 if (trace_hardirq_context(current)) {
210 trace_hardirq_exit();
213 lockdep_softirq_enter();
218 static inline void lockdep_softirq_end(bool in_hardirq)
220 lockdep_softirq_exit();
223 trace_hardirq_enter();
226 static inline bool lockdep_softirq_start(void) { return false; }
227 static inline void lockdep_softirq_end(bool in_hardirq) { }
230 asmlinkage __visible void __do_softirq(void)
232 unsigned long end = jiffies + MAX_SOFTIRQ_TIME;
233 unsigned long old_flags = current->flags;
234 int max_restart = MAX_SOFTIRQ_RESTART;
235 struct softirq_action *h;
241 * Mask out PF_MEMALLOC s current task context is borrowed for the
242 * softirq. A softirq handled such as network RX might set PF_MEMALLOC
243 * again if the socket is related to swap
245 current->flags &= ~PF_MEMALLOC;
247 pending = local_softirq_pending();
248 account_irq_enter_time(current);
250 __local_bh_disable_ip(_RET_IP_, SOFTIRQ_OFFSET);
251 in_hardirq = lockdep_softirq_start();
254 /* Reset the pending bitmask before enabling irqs */
255 set_softirq_pending(0);
261 while ((softirq_bit = ffs(pending))) {
265 h += softirq_bit - 1;
267 vec_nr = h - softirq_vec;
268 prev_count = preempt_count();
270 kstat_incr_softirqs_this_cpu(vec_nr);
272 trace_softirq_entry(vec_nr);
274 trace_softirq_exit(vec_nr);
275 if (unlikely(prev_count != preempt_count())) {
276 pr_err("huh, entered softirq %u %s %p with preempt_count %08x, exited with %08x?\n",
277 vec_nr, softirq_to_name[vec_nr], h->action,
278 prev_count, preempt_count());
279 preempt_count_set(prev_count);
282 pending >>= softirq_bit;
288 pending = local_softirq_pending();
290 if (time_before(jiffies, end) && !need_resched() &&
297 lockdep_softirq_end(in_hardirq);
298 account_irq_exit_time(current);
299 __local_bh_enable(SOFTIRQ_OFFSET);
300 WARN_ON_ONCE(in_interrupt());
301 tsk_restore_flags(current, old_flags, PF_MEMALLOC);
304 asmlinkage __visible void do_softirq(void)
312 local_irq_save(flags);
314 pending = local_softirq_pending();
317 do_softirq_own_stack();
319 local_irq_restore(flags);
323 * Enter an interrupt context.
328 if (is_idle_task(current) && !in_interrupt()) {
330 * Prevent raise_softirq from needlessly waking up ksoftirqd
331 * here, as softirq will be serviced on return from interrupt.
341 static inline void invoke_softirq(void)
343 if (!force_irqthreads) {
344 #ifdef CONFIG_HAVE_IRQ_EXIT_ON_IRQ_STACK
346 * We can safely execute softirq on the current stack if
347 * it is the irq stack, because it should be near empty
353 * Otherwise, irq_exit() is called on the task stack that can
354 * be potentially deep already. So call softirq in its own stack
355 * to prevent from any overrun.
357 do_softirq_own_stack();
364 static inline void tick_irq_exit(void)
366 #ifdef CONFIG_NO_HZ_COMMON
367 int cpu = smp_processor_id();
369 /* Make sure that timer wheel updates are propagated */
370 if ((idle_cpu(cpu) && !need_resched()) || tick_nohz_full_cpu(cpu)) {
372 tick_nohz_irq_exit();
378 * Exit an interrupt context. Process softirqs if needed and possible:
382 #ifndef __ARCH_IRQ_EXIT_IRQS_DISABLED
385 WARN_ON_ONCE(!irqs_disabled());
388 account_irq_exit_time(current);
389 preempt_count_sub(HARDIRQ_OFFSET);
390 if (!in_interrupt() && local_softirq_pending())
395 trace_hardirq_exit(); /* must be last! */
399 * This function must run with irqs disabled!
401 inline void raise_softirq_irqoff(unsigned int nr)
403 __raise_softirq_irqoff(nr);
406 * If we're in an interrupt or softirq, we're done
407 * (this also catches softirq-disabled code). We will
408 * actually run the softirq once we return from
409 * the irq or softirq.
411 * Otherwise we wake up ksoftirqd to make sure we
412 * schedule the softirq soon.
418 void raise_softirq(unsigned int nr)
422 local_irq_save(flags);
423 raise_softirq_irqoff(nr);
424 local_irq_restore(flags);
427 void __raise_softirq_irqoff(unsigned int nr)
429 trace_softirq_raise(nr);
430 or_softirq_pending(1UL << nr);
433 void open_softirq(int nr, void (*action)(struct softirq_action *))
435 softirq_vec[nr].action = action;
441 struct tasklet_head {
442 struct tasklet_struct *head;
443 struct tasklet_struct **tail;
446 static DEFINE_PER_CPU(struct tasklet_head, tasklet_vec);
447 static DEFINE_PER_CPU(struct tasklet_head, tasklet_hi_vec);
449 void __tasklet_schedule(struct tasklet_struct *t)
453 local_irq_save(flags);
455 *__this_cpu_read(tasklet_vec.tail) = t;
456 __this_cpu_write(tasklet_vec.tail, &(t->next));
457 raise_softirq_irqoff(TASKLET_SOFTIRQ);
458 local_irq_restore(flags);
460 EXPORT_SYMBOL(__tasklet_schedule);
462 void __tasklet_hi_schedule(struct tasklet_struct *t)
466 local_irq_save(flags);
468 *__this_cpu_read(tasklet_hi_vec.tail) = t;
469 __this_cpu_write(tasklet_hi_vec.tail, &(t->next));
470 raise_softirq_irqoff(HI_SOFTIRQ);
471 local_irq_restore(flags);
473 EXPORT_SYMBOL(__tasklet_hi_schedule);
475 void __tasklet_hi_schedule_first(struct tasklet_struct *t)
477 BUG_ON(!irqs_disabled());
479 t->next = __this_cpu_read(tasklet_hi_vec.head);
480 __this_cpu_write(tasklet_hi_vec.head, t);
481 __raise_softirq_irqoff(HI_SOFTIRQ);
483 EXPORT_SYMBOL(__tasklet_hi_schedule_first);
485 static void tasklet_action(struct softirq_action *a)
487 struct tasklet_struct *list;
490 list = __this_cpu_read(tasklet_vec.head);
491 __this_cpu_write(tasklet_vec.head, NULL);
492 __this_cpu_write(tasklet_vec.tail, this_cpu_ptr(&tasklet_vec.head));
496 struct tasklet_struct *t = list;
500 if (tasklet_trylock(t)) {
501 if (!atomic_read(&t->count)) {
502 if (!test_and_clear_bit(TASKLET_STATE_SCHED,
514 *__this_cpu_read(tasklet_vec.tail) = t;
515 __this_cpu_write(tasklet_vec.tail, &(t->next));
516 __raise_softirq_irqoff(TASKLET_SOFTIRQ);
521 static void tasklet_hi_action(struct softirq_action *a)
523 struct tasklet_struct *list;
526 list = __this_cpu_read(tasklet_hi_vec.head);
527 __this_cpu_write(tasklet_hi_vec.head, NULL);
528 __this_cpu_write(tasklet_hi_vec.tail, this_cpu_ptr(&tasklet_hi_vec.head));
532 struct tasklet_struct *t = list;
536 if (tasklet_trylock(t)) {
537 if (!atomic_read(&t->count)) {
538 if (!test_and_clear_bit(TASKLET_STATE_SCHED,
550 *__this_cpu_read(tasklet_hi_vec.tail) = t;
551 __this_cpu_write(tasklet_hi_vec.tail, &(t->next));
552 __raise_softirq_irqoff(HI_SOFTIRQ);
557 void tasklet_init(struct tasklet_struct *t,
558 void (*func)(unsigned long), unsigned long data)
562 atomic_set(&t->count, 0);
566 EXPORT_SYMBOL(tasklet_init);
568 void tasklet_kill(struct tasklet_struct *t)
571 pr_notice("Attempt to kill tasklet from interrupt\n");
573 while (test_and_set_bit(TASKLET_STATE_SCHED, &t->state)) {
576 } while (test_bit(TASKLET_STATE_SCHED, &t->state));
578 tasklet_unlock_wait(t);
579 clear_bit(TASKLET_STATE_SCHED, &t->state);
581 EXPORT_SYMBOL(tasklet_kill);
588 * The trampoline is called when the hrtimer expires. It schedules a tasklet
589 * to run __tasklet_hrtimer_trampoline() which in turn will call the intended
590 * hrtimer callback, but from softirq context.
592 static enum hrtimer_restart __hrtimer_tasklet_trampoline(struct hrtimer *timer)
594 struct tasklet_hrtimer *ttimer =
595 container_of(timer, struct tasklet_hrtimer, timer);
597 tasklet_hi_schedule(&ttimer->tasklet);
598 return HRTIMER_NORESTART;
602 * Helper function which calls the hrtimer callback from
603 * tasklet/softirq context
605 static void __tasklet_hrtimer_trampoline(unsigned long data)
607 struct tasklet_hrtimer *ttimer = (void *)data;
608 enum hrtimer_restart restart;
610 restart = ttimer->function(&ttimer->timer);
611 if (restart != HRTIMER_NORESTART)
612 hrtimer_restart(&ttimer->timer);
616 * tasklet_hrtimer_init - Init a tasklet/hrtimer combo for softirq callbacks
617 * @ttimer: tasklet_hrtimer which is initialized
618 * @function: hrtimer callback function which gets called from softirq context
619 * @which_clock: clock id (CLOCK_MONOTONIC/CLOCK_REALTIME)
620 * @mode: hrtimer mode (HRTIMER_MODE_ABS/HRTIMER_MODE_REL)
622 void tasklet_hrtimer_init(struct tasklet_hrtimer *ttimer,
623 enum hrtimer_restart (*function)(struct hrtimer *),
624 clockid_t which_clock, enum hrtimer_mode mode)
626 hrtimer_init(&ttimer->timer, which_clock, mode);
627 ttimer->timer.function = __hrtimer_tasklet_trampoline;
628 tasklet_init(&ttimer->tasklet, __tasklet_hrtimer_trampoline,
629 (unsigned long)ttimer);
630 ttimer->function = function;
632 EXPORT_SYMBOL_GPL(tasklet_hrtimer_init);
634 void __init softirq_init(void)
638 for_each_possible_cpu(cpu) {
639 per_cpu(tasklet_vec, cpu).tail =
640 &per_cpu(tasklet_vec, cpu).head;
641 per_cpu(tasklet_hi_vec, cpu).tail =
642 &per_cpu(tasklet_hi_vec, cpu).head;
645 open_softirq(TASKLET_SOFTIRQ, tasklet_action);
646 open_softirq(HI_SOFTIRQ, tasklet_hi_action);
649 static int ksoftirqd_should_run(unsigned int cpu)
651 return local_softirq_pending();
654 static void run_ksoftirqd(unsigned int cpu)
657 if (local_softirq_pending()) {
659 * We can safely run softirq on inline stack, as we are not deep
660 * in the task stack here.
664 cond_resched_rcu_qs();
670 #ifdef CONFIG_HOTPLUG_CPU
672 * tasklet_kill_immediate is called to remove a tasklet which can already be
673 * scheduled for execution on @cpu.
675 * Unlike tasklet_kill, this function removes the tasklet
676 * _immediately_, even if the tasklet is in TASKLET_STATE_SCHED state.
678 * When this function is called, @cpu must be in the CPU_DEAD state.
680 void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu)
682 struct tasklet_struct **i;
684 BUG_ON(cpu_online(cpu));
685 BUG_ON(test_bit(TASKLET_STATE_RUN, &t->state));
687 if (!test_bit(TASKLET_STATE_SCHED, &t->state))
690 /* CPU is dead, so no lock needed. */
691 for (i = &per_cpu(tasklet_vec, cpu).head; *i; i = &(*i)->next) {
694 /* If this was the tail element, move the tail ptr */
696 per_cpu(tasklet_vec, cpu).tail = i;
703 static void takeover_tasklets(unsigned int cpu)
705 /* CPU is dead, so no lock needed. */
708 /* Find end, append list for that CPU. */
709 if (&per_cpu(tasklet_vec, cpu).head != per_cpu(tasklet_vec, cpu).tail) {
710 *__this_cpu_read(tasklet_vec.tail) = per_cpu(tasklet_vec, cpu).head;
711 this_cpu_write(tasklet_vec.tail, per_cpu(tasklet_vec, cpu).tail);
712 per_cpu(tasklet_vec, cpu).head = NULL;
713 per_cpu(tasklet_vec, cpu).tail = &per_cpu(tasklet_vec, cpu).head;
715 raise_softirq_irqoff(TASKLET_SOFTIRQ);
717 if (&per_cpu(tasklet_hi_vec, cpu).head != per_cpu(tasklet_hi_vec, cpu).tail) {
718 *__this_cpu_read(tasklet_hi_vec.tail) = per_cpu(tasklet_hi_vec, cpu).head;
719 __this_cpu_write(tasklet_hi_vec.tail, per_cpu(tasklet_hi_vec, cpu).tail);
720 per_cpu(tasklet_hi_vec, cpu).head = NULL;
721 per_cpu(tasklet_hi_vec, cpu).tail = &per_cpu(tasklet_hi_vec, cpu).head;
723 raise_softirq_irqoff(HI_SOFTIRQ);
727 #endif /* CONFIG_HOTPLUG_CPU */
729 static int cpu_callback(struct notifier_block *nfb, unsigned long action,
733 #ifdef CONFIG_HOTPLUG_CPU
735 case CPU_DEAD_FROZEN:
736 takeover_tasklets((unsigned long)hcpu);
738 #endif /* CONFIG_HOTPLUG_CPU */
743 static struct notifier_block cpu_nfb = {
744 .notifier_call = cpu_callback
747 static struct smp_hotplug_thread softirq_threads = {
749 .thread_should_run = ksoftirqd_should_run,
750 .thread_fn = run_ksoftirqd,
751 .thread_comm = "ksoftirqd/%u",
754 static __init int spawn_ksoftirqd(void)
756 register_cpu_notifier(&cpu_nfb);
758 BUG_ON(smpboot_register_percpu_thread(&softirq_threads));
762 early_initcall(spawn_ksoftirqd);
765 * [ These __weak aliases are kept in a separate compilation unit, so that
766 * GCC does not inline them incorrectly. ]
769 int __init __weak early_irq_init(void)
774 int __init __weak arch_probe_nr_irqs(void)
776 return NR_IRQS_LEGACY;
779 int __init __weak arch_early_irq_init(void)
784 unsigned int __weak arch_dynirq_lower_bound(unsigned int from)