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)
10 * Remote softirq infrastructure is by Jens Axboe.
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>
29 #define CREATE_TRACE_POINTS
30 #include <trace/events/irq.h>
33 - No shared variables, all the data are CPU local.
34 - If a softirq needs serialization, let it serialize itself
36 - Even if softirq is serialized, only local cpu is marked for
37 execution. Hence, we get something sort of weak cpu binding.
38 Though it is still not clear, will it result in better locality
42 - NET RX softirq. It is multithreaded and does not require
43 any global serialization.
44 - NET TX softirq. It kicks software netdevice queues, hence
45 it is logically serialized per device, but this serialization
46 is invisible to common code.
47 - Tasklets: serialized wrt itself.
50 #ifndef __ARCH_IRQ_STAT
51 irq_cpustat_t irq_stat[NR_CPUS] ____cacheline_aligned;
52 EXPORT_SYMBOL(irq_stat);
55 static struct softirq_action softirq_vec[NR_SOFTIRQS] __cacheline_aligned_in_smp;
57 DEFINE_PER_CPU(struct task_struct *, ksoftirqd);
59 char *softirq_to_name[NR_SOFTIRQS] = {
60 "HI", "TIMER", "NET_TX", "NET_RX", "BLOCK", "BLOCK_IOPOLL",
61 "TASKLET", "SCHED", "HRTIMER", "RCU"
65 * we cannot loop indefinitely here to avoid userspace starvation,
66 * but we also don't want to introduce a worst case 1/HZ latency
67 * to the pending events, so lets the scheduler to balance
68 * the softirq load for us.
70 static void wakeup_softirqd(void)
72 /* Interrupts are disabled: no need to stop preemption */
73 struct task_struct *tsk = __this_cpu_read(ksoftirqd);
75 if (tsk && tsk->state != TASK_RUNNING)
80 * preempt_count and SOFTIRQ_OFFSET usage:
81 * - preempt_count is changed by SOFTIRQ_OFFSET on entering or leaving
83 * - preempt_count is changed by SOFTIRQ_DISABLE_OFFSET (= 2 * SOFTIRQ_OFFSET)
84 * on local_bh_disable or local_bh_enable.
85 * This lets us distinguish between whether we are currently processing
86 * softirq and whether we just have bh disabled.
90 * This one is for softirq.c-internal use,
91 * where hardirqs are disabled legitimately:
93 #ifdef CONFIG_TRACE_IRQFLAGS
94 static void __local_bh_disable(unsigned long ip, unsigned int cnt)
98 WARN_ON_ONCE(in_irq());
100 raw_local_irq_save(flags);
102 * The preempt tracer hooks into preempt_count_add and will break
103 * lockdep because it calls back into lockdep after SOFTIRQ_OFFSET
104 * is set and before current->softirq_enabled is cleared.
105 * We must manually increment preempt_count here and manually
106 * call the trace_preempt_off later.
108 __preempt_count_add(cnt);
110 * Were softirqs turned off above:
112 if (softirq_count() == cnt)
113 trace_softirqs_off(ip);
114 raw_local_irq_restore(flags);
116 if (preempt_count() == cnt)
117 trace_preempt_off(CALLER_ADDR0, get_parent_ip(CALLER_ADDR1));
119 #else /* !CONFIG_TRACE_IRQFLAGS */
120 static inline void __local_bh_disable(unsigned long ip, unsigned int cnt)
122 preempt_count_add(cnt);
125 #endif /* CONFIG_TRACE_IRQFLAGS */
127 void local_bh_disable(void)
129 __local_bh_disable(_RET_IP_, SOFTIRQ_DISABLE_OFFSET);
132 EXPORT_SYMBOL(local_bh_disable);
134 static void __local_bh_enable(unsigned int cnt)
136 WARN_ON_ONCE(!irqs_disabled());
138 if (softirq_count() == cnt)
139 trace_softirqs_on(_RET_IP_);
140 preempt_count_sub(cnt);
144 * Special-case - softirqs can safely be enabled in
145 * cond_resched_softirq(), or by __do_softirq(),
146 * without processing still-pending softirqs:
148 void _local_bh_enable(void)
150 WARN_ON_ONCE(in_irq());
151 __local_bh_enable(SOFTIRQ_DISABLE_OFFSET);
154 EXPORT_SYMBOL(_local_bh_enable);
156 static inline void _local_bh_enable_ip(unsigned long ip)
158 WARN_ON_ONCE(in_irq() || irqs_disabled());
159 #ifdef CONFIG_TRACE_IRQFLAGS
163 * Are softirqs going to be turned on now:
165 if (softirq_count() == SOFTIRQ_DISABLE_OFFSET)
166 trace_softirqs_on(ip);
168 * Keep preemption disabled until we are done with
169 * softirq processing:
171 preempt_count_sub(SOFTIRQ_DISABLE_OFFSET - 1);
173 if (unlikely(!in_interrupt() && local_softirq_pending())) {
175 * Run softirq if any pending. And do it in its own stack
176 * as we may be calling this deep in a task call stack already.
182 #ifdef CONFIG_TRACE_IRQFLAGS
185 preempt_check_resched();
188 void local_bh_enable(void)
190 _local_bh_enable_ip(_RET_IP_);
192 EXPORT_SYMBOL(local_bh_enable);
194 void local_bh_enable_ip(unsigned long ip)
196 _local_bh_enable_ip(ip);
198 EXPORT_SYMBOL(local_bh_enable_ip);
201 * We restart softirq processing for at most MAX_SOFTIRQ_RESTART times,
202 * but break the loop if need_resched() is set or after 2 ms.
203 * The MAX_SOFTIRQ_TIME provides a nice upper bound in most cases, but in
204 * certain cases, such as stop_machine(), jiffies may cease to
205 * increment and so we need the MAX_SOFTIRQ_RESTART limit as
206 * well to make sure we eventually return from this method.
208 * These limits have been established via experimentation.
209 * The two things to balance is latency against fairness -
210 * we want to handle softirqs as soon as possible, but they
211 * should not be able to lock up the box.
213 #define MAX_SOFTIRQ_TIME msecs_to_jiffies(2)
214 #define MAX_SOFTIRQ_RESTART 10
216 asmlinkage void __do_softirq(void)
218 struct softirq_action *h;
220 unsigned long end = jiffies + MAX_SOFTIRQ_TIME;
222 unsigned long old_flags = current->flags;
223 int max_restart = MAX_SOFTIRQ_RESTART;
226 * Mask out PF_MEMALLOC s current task context is borrowed for the
227 * softirq. A softirq handled such as network RX might set PF_MEMALLOC
228 * again if the socket is related to swap
230 current->flags &= ~PF_MEMALLOC;
232 pending = local_softirq_pending();
233 account_irq_enter_time(current);
235 __local_bh_disable(_RET_IP_, SOFTIRQ_OFFSET);
236 lockdep_softirq_enter();
238 cpu = smp_processor_id();
240 /* Reset the pending bitmask before enabling irqs */
241 set_softirq_pending(0);
249 unsigned int vec_nr = h - softirq_vec;
250 int prev_count = preempt_count();
252 kstat_incr_softirqs_this_cpu(vec_nr);
254 trace_softirq_entry(vec_nr);
256 trace_softirq_exit(vec_nr);
257 if (unlikely(prev_count != preempt_count())) {
258 printk(KERN_ERR "huh, entered softirq %u %s %p"
259 "with preempt_count %08x,"
260 " exited with %08x?\n", vec_nr,
261 softirq_to_name[vec_nr], h->action,
262 prev_count, preempt_count());
263 preempt_count_set(prev_count);
274 pending = local_softirq_pending();
276 if (time_before(jiffies, end) && !need_resched() &&
283 lockdep_softirq_exit();
285 account_irq_exit_time(current);
286 __local_bh_enable(SOFTIRQ_OFFSET);
287 WARN_ON_ONCE(in_interrupt());
288 tsk_restore_flags(current, old_flags, PF_MEMALLOC);
293 asmlinkage void do_softirq(void)
301 local_irq_save(flags);
303 pending = local_softirq_pending();
306 do_softirq_own_stack();
308 local_irq_restore(flags);
312 * Enter an interrupt context.
316 int cpu = smp_processor_id();
319 if (is_idle_task(current) && !in_interrupt()) {
321 * Prevent raise_softirq from needlessly waking up ksoftirqd
322 * here, as softirq will be serviced on return from interrupt.
325 tick_check_idle(cpu);
332 static inline void invoke_softirq(void)
334 if (!force_irqthreads) {
335 #ifdef CONFIG_HAVE_IRQ_EXIT_ON_IRQ_STACK
337 * We can safely execute softirq on the current stack if
338 * it is the irq stack, because it should be near empty
344 * Otherwise, irq_exit() is called on the task stack that can
345 * be potentially deep already. So call softirq in its own stack
346 * to prevent from any overrun.
348 do_softirq_own_stack();
355 static inline void tick_irq_exit(void)
357 #ifdef CONFIG_NO_HZ_COMMON
358 int cpu = smp_processor_id();
360 /* Make sure that timer wheel updates are propagated */
361 if ((idle_cpu(cpu) && !need_resched()) || tick_nohz_full_cpu(cpu)) {
363 tick_nohz_irq_exit();
369 * Exit an interrupt context. Process softirqs if needed and possible:
373 #ifndef __ARCH_IRQ_EXIT_IRQS_DISABLED
376 WARN_ON_ONCE(!irqs_disabled());
379 account_irq_exit_time(current);
380 trace_hardirq_exit();
381 preempt_count_sub(HARDIRQ_OFFSET);
382 if (!in_interrupt() && local_softirq_pending())
390 * This function must run with irqs disabled!
392 inline void raise_softirq_irqoff(unsigned int nr)
394 __raise_softirq_irqoff(nr);
397 * If we're in an interrupt or softirq, we're done
398 * (this also catches softirq-disabled code). We will
399 * actually run the softirq once we return from
400 * the irq or softirq.
402 * Otherwise we wake up ksoftirqd to make sure we
403 * schedule the softirq soon.
409 void raise_softirq(unsigned int nr)
413 local_irq_save(flags);
414 raise_softirq_irqoff(nr);
415 local_irq_restore(flags);
418 void __raise_softirq_irqoff(unsigned int nr)
420 trace_softirq_raise(nr);
421 or_softirq_pending(1UL << nr);
424 void open_softirq(int nr, void (*action)(struct softirq_action *))
426 softirq_vec[nr].action = action;
434 struct tasklet_struct *head;
435 struct tasklet_struct **tail;
438 static DEFINE_PER_CPU(struct tasklet_head, tasklet_vec);
439 static DEFINE_PER_CPU(struct tasklet_head, tasklet_hi_vec);
441 void __tasklet_schedule(struct tasklet_struct *t)
445 local_irq_save(flags);
447 *__this_cpu_read(tasklet_vec.tail) = t;
448 __this_cpu_write(tasklet_vec.tail, &(t->next));
449 raise_softirq_irqoff(TASKLET_SOFTIRQ);
450 local_irq_restore(flags);
453 EXPORT_SYMBOL(__tasklet_schedule);
455 void __tasklet_hi_schedule(struct tasklet_struct *t)
459 local_irq_save(flags);
461 *__this_cpu_read(tasklet_hi_vec.tail) = t;
462 __this_cpu_write(tasklet_hi_vec.tail, &(t->next));
463 raise_softirq_irqoff(HI_SOFTIRQ);
464 local_irq_restore(flags);
467 EXPORT_SYMBOL(__tasklet_hi_schedule);
469 void __tasklet_hi_schedule_first(struct tasklet_struct *t)
471 BUG_ON(!irqs_disabled());
473 t->next = __this_cpu_read(tasklet_hi_vec.head);
474 __this_cpu_write(tasklet_hi_vec.head, t);
475 __raise_softirq_irqoff(HI_SOFTIRQ);
478 EXPORT_SYMBOL(__tasklet_hi_schedule_first);
480 static void tasklet_action(struct softirq_action *a)
482 struct tasklet_struct *list;
485 list = __this_cpu_read(tasklet_vec.head);
486 __this_cpu_write(tasklet_vec.head, NULL);
487 __this_cpu_write(tasklet_vec.tail, &__get_cpu_var(tasklet_vec).head);
491 struct tasklet_struct *t = list;
495 if (tasklet_trylock(t)) {
496 if (!atomic_read(&t->count)) {
497 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
508 *__this_cpu_read(tasklet_vec.tail) = t;
509 __this_cpu_write(tasklet_vec.tail, &(t->next));
510 __raise_softirq_irqoff(TASKLET_SOFTIRQ);
515 static void tasklet_hi_action(struct softirq_action *a)
517 struct tasklet_struct *list;
520 list = __this_cpu_read(tasklet_hi_vec.head);
521 __this_cpu_write(tasklet_hi_vec.head, NULL);
522 __this_cpu_write(tasklet_hi_vec.tail, &__get_cpu_var(tasklet_hi_vec).head);
526 struct tasklet_struct *t = list;
530 if (tasklet_trylock(t)) {
531 if (!atomic_read(&t->count)) {
532 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
543 *__this_cpu_read(tasklet_hi_vec.tail) = t;
544 __this_cpu_write(tasklet_hi_vec.tail, &(t->next));
545 __raise_softirq_irqoff(HI_SOFTIRQ);
551 void tasklet_init(struct tasklet_struct *t,
552 void (*func)(unsigned long), unsigned long data)
556 atomic_set(&t->count, 0);
561 EXPORT_SYMBOL(tasklet_init);
563 void tasklet_kill(struct tasklet_struct *t)
566 printk("Attempt to kill tasklet from interrupt\n");
568 while (test_and_set_bit(TASKLET_STATE_SCHED, &t->state)) {
571 } while (test_bit(TASKLET_STATE_SCHED, &t->state));
573 tasklet_unlock_wait(t);
574 clear_bit(TASKLET_STATE_SCHED, &t->state);
577 EXPORT_SYMBOL(tasklet_kill);
584 * The trampoline is called when the hrtimer expires. It schedules a tasklet
585 * to run __tasklet_hrtimer_trampoline() which in turn will call the intended
586 * hrtimer callback, but from softirq context.
588 static enum hrtimer_restart __hrtimer_tasklet_trampoline(struct hrtimer *timer)
590 struct tasklet_hrtimer *ttimer =
591 container_of(timer, struct tasklet_hrtimer, timer);
593 tasklet_hi_schedule(&ttimer->tasklet);
594 return HRTIMER_NORESTART;
598 * Helper function which calls the hrtimer callback from
599 * tasklet/softirq context
601 static void __tasklet_hrtimer_trampoline(unsigned long data)
603 struct tasklet_hrtimer *ttimer = (void *)data;
604 enum hrtimer_restart restart;
606 restart = ttimer->function(&ttimer->timer);
607 if (restart != HRTIMER_NORESTART)
608 hrtimer_restart(&ttimer->timer);
612 * tasklet_hrtimer_init - Init a tasklet/hrtimer combo for softirq callbacks
613 * @ttimer: tasklet_hrtimer which is initialized
614 * @function: hrtimer callback function which gets called from softirq context
615 * @which_clock: clock id (CLOCK_MONOTONIC/CLOCK_REALTIME)
616 * @mode: hrtimer mode (HRTIMER_MODE_ABS/HRTIMER_MODE_REL)
618 void tasklet_hrtimer_init(struct tasklet_hrtimer *ttimer,
619 enum hrtimer_restart (*function)(struct hrtimer *),
620 clockid_t which_clock, enum hrtimer_mode mode)
622 hrtimer_init(&ttimer->timer, which_clock, mode);
623 ttimer->timer.function = __hrtimer_tasklet_trampoline;
624 tasklet_init(&ttimer->tasklet, __tasklet_hrtimer_trampoline,
625 (unsigned long)ttimer);
626 ttimer->function = function;
628 EXPORT_SYMBOL_GPL(tasklet_hrtimer_init);
631 * Remote softirq bits
634 DEFINE_PER_CPU(struct list_head [NR_SOFTIRQS], softirq_work_list);
635 EXPORT_PER_CPU_SYMBOL(softirq_work_list);
637 static void __local_trigger(struct call_single_data *cp, int softirq)
639 struct list_head *head = &__get_cpu_var(softirq_work_list[softirq]);
641 list_add_tail(&cp->list, head);
643 /* Trigger the softirq only if the list was previously empty. */
644 if (head->next == &cp->list)
645 raise_softirq_irqoff(softirq);
648 #ifdef CONFIG_USE_GENERIC_SMP_HELPERS
649 static void remote_softirq_receive(void *data)
651 struct call_single_data *cp = data;
655 softirq = *(int *)cp->info;
656 local_irq_save(flags);
657 __local_trigger(cp, softirq);
658 local_irq_restore(flags);
661 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
663 if (cpu_online(cpu)) {
664 cp->func = remote_softirq_receive;
668 __smp_call_function_single(cpu, cp, 0);
673 #else /* CONFIG_USE_GENERIC_SMP_HELPERS */
674 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
681 * __send_remote_softirq - try to schedule softirq work on a remote cpu
682 * @cp: private SMP call function data area
683 * @cpu: the remote cpu
684 * @this_cpu: the currently executing cpu
685 * @softirq: the softirq for the work
687 * Attempt to schedule softirq work on a remote cpu. If this cannot be
688 * done, the work is instead queued up on the local cpu.
690 * Interrupts must be disabled.
692 void __send_remote_softirq(struct call_single_data *cp, int cpu, int this_cpu, int softirq)
694 if (cpu == this_cpu || __try_remote_softirq(cp, cpu, softirq))
695 __local_trigger(cp, softirq);
697 EXPORT_SYMBOL(__send_remote_softirq);
700 * send_remote_softirq - try to schedule softirq work on a remote cpu
701 * @cp: private SMP call function data area
702 * @cpu: the remote cpu
703 * @softirq: the softirq for the work
705 * Like __send_remote_softirq except that disabling interrupts and
706 * computing the current cpu is done for the caller.
708 void send_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
713 local_irq_save(flags);
714 this_cpu = smp_processor_id();
715 __send_remote_softirq(cp, cpu, this_cpu, softirq);
716 local_irq_restore(flags);
718 EXPORT_SYMBOL(send_remote_softirq);
720 static int remote_softirq_cpu_notify(struct notifier_block *self,
721 unsigned long action, void *hcpu)
724 * If a CPU goes away, splice its entries to the current CPU
725 * and trigger a run of the softirq
727 if (action == CPU_DEAD || action == CPU_DEAD_FROZEN) {
728 int cpu = (unsigned long) hcpu;
732 for (i = 0; i < NR_SOFTIRQS; i++) {
733 struct list_head *head = &per_cpu(softirq_work_list[i], cpu);
734 struct list_head *local_head;
736 if (list_empty(head))
739 local_head = &__get_cpu_var(softirq_work_list[i]);
740 list_splice_init(head, local_head);
741 raise_softirq_irqoff(i);
749 static struct notifier_block remote_softirq_cpu_notifier = {
750 .notifier_call = remote_softirq_cpu_notify,
753 void __init softirq_init(void)
757 for_each_possible_cpu(cpu) {
760 per_cpu(tasklet_vec, cpu).tail =
761 &per_cpu(tasklet_vec, cpu).head;
762 per_cpu(tasklet_hi_vec, cpu).tail =
763 &per_cpu(tasklet_hi_vec, cpu).head;
764 for (i = 0; i < NR_SOFTIRQS; i++)
765 INIT_LIST_HEAD(&per_cpu(softirq_work_list[i], cpu));
768 register_hotcpu_notifier(&remote_softirq_cpu_notifier);
770 open_softirq(TASKLET_SOFTIRQ, tasklet_action);
771 open_softirq(HI_SOFTIRQ, tasklet_hi_action);
774 static int ksoftirqd_should_run(unsigned int cpu)
776 return local_softirq_pending();
779 static void run_ksoftirqd(unsigned int cpu)
782 if (local_softirq_pending()) {
784 * We can safely run softirq on inline stack, as we are not deep
785 * in the task stack here.
788 rcu_note_context_switch(cpu);
796 #ifdef CONFIG_HOTPLUG_CPU
798 * tasklet_kill_immediate is called to remove a tasklet which can already be
799 * scheduled for execution on @cpu.
801 * Unlike tasklet_kill, this function removes the tasklet
802 * _immediately_, even if the tasklet is in TASKLET_STATE_SCHED state.
804 * When this function is called, @cpu must be in the CPU_DEAD state.
806 void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu)
808 struct tasklet_struct **i;
810 BUG_ON(cpu_online(cpu));
811 BUG_ON(test_bit(TASKLET_STATE_RUN, &t->state));
813 if (!test_bit(TASKLET_STATE_SCHED, &t->state))
816 /* CPU is dead, so no lock needed. */
817 for (i = &per_cpu(tasklet_vec, cpu).head; *i; i = &(*i)->next) {
820 /* If this was the tail element, move the tail ptr */
822 per_cpu(tasklet_vec, cpu).tail = i;
829 static void takeover_tasklets(unsigned int cpu)
831 /* CPU is dead, so no lock needed. */
834 /* Find end, append list for that CPU. */
835 if (&per_cpu(tasklet_vec, cpu).head != per_cpu(tasklet_vec, cpu).tail) {
836 *__this_cpu_read(tasklet_vec.tail) = per_cpu(tasklet_vec, cpu).head;
837 this_cpu_write(tasklet_vec.tail, per_cpu(tasklet_vec, cpu).tail);
838 per_cpu(tasklet_vec, cpu).head = NULL;
839 per_cpu(tasklet_vec, cpu).tail = &per_cpu(tasklet_vec, cpu).head;
841 raise_softirq_irqoff(TASKLET_SOFTIRQ);
843 if (&per_cpu(tasklet_hi_vec, cpu).head != per_cpu(tasklet_hi_vec, cpu).tail) {
844 *__this_cpu_read(tasklet_hi_vec.tail) = per_cpu(tasklet_hi_vec, cpu).head;
845 __this_cpu_write(tasklet_hi_vec.tail, per_cpu(tasklet_hi_vec, cpu).tail);
846 per_cpu(tasklet_hi_vec, cpu).head = NULL;
847 per_cpu(tasklet_hi_vec, cpu).tail = &per_cpu(tasklet_hi_vec, cpu).head;
849 raise_softirq_irqoff(HI_SOFTIRQ);
853 #endif /* CONFIG_HOTPLUG_CPU */
855 static int cpu_callback(struct notifier_block *nfb,
856 unsigned long action,
860 #ifdef CONFIG_HOTPLUG_CPU
862 case CPU_DEAD_FROZEN:
863 takeover_tasklets((unsigned long)hcpu);
865 #endif /* CONFIG_HOTPLUG_CPU */
870 static struct notifier_block cpu_nfb = {
871 .notifier_call = cpu_callback
874 static struct smp_hotplug_thread softirq_threads = {
876 .thread_should_run = ksoftirqd_should_run,
877 .thread_fn = run_ksoftirqd,
878 .thread_comm = "ksoftirqd/%u",
881 static __init int spawn_ksoftirqd(void)
883 register_cpu_notifier(&cpu_nfb);
885 BUG_ON(smpboot_register_percpu_thread(&softirq_threads));
889 early_initcall(spawn_ksoftirqd);
892 * [ These __weak aliases are kept in a separate compilation unit, so that
893 * GCC does not inline them incorrectly. ]
896 int __init __weak early_irq_init(void)
901 int __init __weak arch_probe_nr_irqs(void)
903 return NR_IRQS_LEGACY;
906 int __init __weak arch_early_irq_init(void)