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/module.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/smp.h>
25 #include <linux/tick.h>
29 - No shared variables, all the data are CPU local.
30 - If a softirq needs serialization, let it serialize itself
32 - Even if softirq is serialized, only local cpu is marked for
33 execution. Hence, we get something sort of weak cpu binding.
34 Though it is still not clear, will it result in better locality
38 - NET RX softirq. It is multithreaded and does not require
39 any global serialization.
40 - NET TX softirq. It kicks software netdevice queues, hence
41 it is logically serialized per device, but this serialization
42 is invisible to common code.
43 - Tasklets: serialized wrt itself.
46 #ifndef __ARCH_IRQ_STAT
47 irq_cpustat_t irq_stat[NR_CPUS] ____cacheline_aligned;
48 EXPORT_SYMBOL(irq_stat);
51 static struct softirq_action softirq_vec[NR_SOFTIRQS] __cacheline_aligned_in_smp;
53 static DEFINE_PER_CPU(struct task_struct *, ksoftirqd);
56 * we cannot loop indefinitely here to avoid userspace starvation,
57 * but we also don't want to introduce a worst case 1/HZ latency
58 * to the pending events, so lets the scheduler to balance
59 * the softirq load for us.
61 static inline void wakeup_softirqd(void)
63 /* Interrupts are disabled: no need to stop preemption */
64 struct task_struct *tsk = __get_cpu_var(ksoftirqd);
66 if (tsk && tsk->state != TASK_RUNNING)
71 * This one is for softirq.c-internal use,
72 * where hardirqs are disabled legitimately:
74 #ifdef CONFIG_TRACE_IRQFLAGS
75 static void __local_bh_disable(unsigned long ip)
79 WARN_ON_ONCE(in_irq());
81 raw_local_irq_save(flags);
82 add_preempt_count(SOFTIRQ_OFFSET);
84 * Were softirqs turned off above:
86 if (softirq_count() == SOFTIRQ_OFFSET)
87 trace_softirqs_off(ip);
88 raw_local_irq_restore(flags);
90 #else /* !CONFIG_TRACE_IRQFLAGS */
91 static inline void __local_bh_disable(unsigned long ip)
93 add_preempt_count(SOFTIRQ_OFFSET);
96 #endif /* CONFIG_TRACE_IRQFLAGS */
98 void local_bh_disable(void)
100 __local_bh_disable((unsigned long)__builtin_return_address(0));
103 EXPORT_SYMBOL(local_bh_disable);
105 void __local_bh_enable(void)
107 WARN_ON_ONCE(in_irq());
110 * softirqs should never be enabled by __local_bh_enable(),
111 * it always nests inside local_bh_enable() sections:
113 WARN_ON_ONCE(softirq_count() == SOFTIRQ_OFFSET);
115 sub_preempt_count(SOFTIRQ_OFFSET);
117 EXPORT_SYMBOL_GPL(__local_bh_enable);
120 * Special-case - softirqs can safely be enabled in
121 * cond_resched_softirq(), or by __do_softirq(),
122 * without processing still-pending softirqs:
124 void _local_bh_enable(void)
126 WARN_ON_ONCE(in_irq());
127 WARN_ON_ONCE(!irqs_disabled());
129 if (softirq_count() == SOFTIRQ_OFFSET)
130 trace_softirqs_on((unsigned long)__builtin_return_address(0));
131 sub_preempt_count(SOFTIRQ_OFFSET);
134 EXPORT_SYMBOL(_local_bh_enable);
136 static inline void _local_bh_enable_ip(unsigned long ip)
138 WARN_ON_ONCE(in_irq() || irqs_disabled());
139 #ifdef CONFIG_TRACE_IRQFLAGS
143 * Are softirqs going to be turned on now:
145 if (softirq_count() == SOFTIRQ_OFFSET)
146 trace_softirqs_on(ip);
148 * Keep preemption disabled until we are done with
149 * softirq processing:
151 sub_preempt_count(SOFTIRQ_OFFSET - 1);
153 if (unlikely(!in_interrupt() && local_softirq_pending()))
157 #ifdef CONFIG_TRACE_IRQFLAGS
160 preempt_check_resched();
163 void local_bh_enable(void)
165 _local_bh_enable_ip((unsigned long)__builtin_return_address(0));
167 EXPORT_SYMBOL(local_bh_enable);
169 void local_bh_enable_ip(unsigned long ip)
171 _local_bh_enable_ip(ip);
173 EXPORT_SYMBOL(local_bh_enable_ip);
176 * We restart softirq processing MAX_SOFTIRQ_RESTART times,
177 * and we fall back to softirqd after that.
179 * This number has been established via experimentation.
180 * The two things to balance is latency against fairness -
181 * we want to handle softirqs as soon as possible, but they
182 * should not be able to lock up the box.
184 #define MAX_SOFTIRQ_RESTART 10
186 asmlinkage void __do_softirq(void)
188 struct softirq_action *h;
190 int max_restart = MAX_SOFTIRQ_RESTART;
193 pending = local_softirq_pending();
194 account_system_vtime(current);
196 __local_bh_disable((unsigned long)__builtin_return_address(0));
197 trace_softirq_enter();
199 cpu = smp_processor_id();
201 /* Reset the pending bitmask before enabling irqs */
202 set_softirq_pending(0);
210 int prev_count = preempt_count();
214 if (unlikely(prev_count != preempt_count())) {
215 printk(KERN_ERR "huh, entered softirq %td %p"
216 "with preempt_count %08x,"
217 " exited with %08x?\n", h - softirq_vec,
218 h->action, prev_count, preempt_count());
219 preempt_count() = prev_count;
222 rcu_bh_qsctr_inc(cpu);
230 pending = local_softirq_pending();
231 if (pending && --max_restart)
237 trace_softirq_exit();
239 account_system_vtime(current);
243 #ifndef __ARCH_HAS_DO_SOFTIRQ
245 asmlinkage void do_softirq(void)
253 local_irq_save(flags);
255 pending = local_softirq_pending();
260 local_irq_restore(flags);
266 * Enter an interrupt context.
270 int cpu = smp_processor_id();
272 if (idle_cpu(cpu) && !in_interrupt()) {
274 tick_check_idle(cpu);
279 #ifdef __ARCH_IRQ_EXIT_IRQS_DISABLED
280 # define invoke_softirq() __do_softirq()
282 # define invoke_softirq() do_softirq()
286 * Exit an interrupt context. Process softirqs if needed and possible:
290 account_system_vtime(current);
291 trace_hardirq_exit();
292 sub_preempt_count(IRQ_EXIT_OFFSET);
293 if (!in_interrupt() && local_softirq_pending())
297 /* Make sure that timer wheel updates are propagated */
298 if (!in_interrupt() && idle_cpu(smp_processor_id()) && !need_resched())
299 tick_nohz_stop_sched_tick(0);
302 preempt_enable_no_resched();
306 * This function must run with irqs disabled!
308 inline void raise_softirq_irqoff(unsigned int nr)
310 __raise_softirq_irqoff(nr);
313 * If we're in an interrupt or softirq, we're done
314 * (this also catches softirq-disabled code). We will
315 * actually run the softirq once we return from
316 * the irq or softirq.
318 * Otherwise we wake up ksoftirqd to make sure we
319 * schedule the softirq soon.
325 void raise_softirq(unsigned int nr)
329 local_irq_save(flags);
330 raise_softirq_irqoff(nr);
331 local_irq_restore(flags);
334 void open_softirq(int nr, void (*action)(struct softirq_action *))
336 softirq_vec[nr].action = action;
342 struct tasklet_struct *head;
343 struct tasklet_struct **tail;
346 static DEFINE_PER_CPU(struct tasklet_head, tasklet_vec);
347 static DEFINE_PER_CPU(struct tasklet_head, tasklet_hi_vec);
349 void __tasklet_schedule(struct tasklet_struct *t)
353 local_irq_save(flags);
355 *__get_cpu_var(tasklet_vec).tail = t;
356 __get_cpu_var(tasklet_vec).tail = &(t->next);
357 raise_softirq_irqoff(TASKLET_SOFTIRQ);
358 local_irq_restore(flags);
361 EXPORT_SYMBOL(__tasklet_schedule);
363 void __tasklet_hi_schedule(struct tasklet_struct *t)
367 local_irq_save(flags);
369 *__get_cpu_var(tasklet_hi_vec).tail = t;
370 __get_cpu_var(tasklet_hi_vec).tail = &(t->next);
371 raise_softirq_irqoff(HI_SOFTIRQ);
372 local_irq_restore(flags);
375 EXPORT_SYMBOL(__tasklet_hi_schedule);
377 static void tasklet_action(struct softirq_action *a)
379 struct tasklet_struct *list;
382 list = __get_cpu_var(tasklet_vec).head;
383 __get_cpu_var(tasklet_vec).head = NULL;
384 __get_cpu_var(tasklet_vec).tail = &__get_cpu_var(tasklet_vec).head;
388 struct tasklet_struct *t = list;
392 if (tasklet_trylock(t)) {
393 if (!atomic_read(&t->count)) {
394 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
405 *__get_cpu_var(tasklet_vec).tail = t;
406 __get_cpu_var(tasklet_vec).tail = &(t->next);
407 __raise_softirq_irqoff(TASKLET_SOFTIRQ);
412 static void tasklet_hi_action(struct softirq_action *a)
414 struct tasklet_struct *list;
417 list = __get_cpu_var(tasklet_hi_vec).head;
418 __get_cpu_var(tasklet_hi_vec).head = NULL;
419 __get_cpu_var(tasklet_hi_vec).tail = &__get_cpu_var(tasklet_hi_vec).head;
423 struct tasklet_struct *t = list;
427 if (tasklet_trylock(t)) {
428 if (!atomic_read(&t->count)) {
429 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
440 *__get_cpu_var(tasklet_hi_vec).tail = t;
441 __get_cpu_var(tasklet_hi_vec).tail = &(t->next);
442 __raise_softirq_irqoff(HI_SOFTIRQ);
448 void tasklet_init(struct tasklet_struct *t,
449 void (*func)(unsigned long), unsigned long data)
453 atomic_set(&t->count, 0);
458 EXPORT_SYMBOL(tasklet_init);
460 void tasklet_kill(struct tasklet_struct *t)
463 printk("Attempt to kill tasklet from interrupt\n");
465 while (test_and_set_bit(TASKLET_STATE_SCHED, &t->state)) {
468 while (test_bit(TASKLET_STATE_SCHED, &t->state));
470 tasklet_unlock_wait(t);
471 clear_bit(TASKLET_STATE_SCHED, &t->state);
474 EXPORT_SYMBOL(tasklet_kill);
476 DEFINE_PER_CPU(struct list_head [NR_SOFTIRQS], softirq_work_list);
477 EXPORT_PER_CPU_SYMBOL(softirq_work_list);
479 static void __local_trigger(struct call_single_data *cp, int softirq)
481 struct list_head *head = &__get_cpu_var(softirq_work_list[softirq]);
483 list_add_tail(&cp->list, head);
485 /* Trigger the softirq only if the list was previously empty. */
486 if (head->next == &cp->list)
487 raise_softirq_irqoff(softirq);
490 #ifdef CONFIG_USE_GENERIC_SMP_HELPERS
491 static void remote_softirq_receive(void *data)
493 struct call_single_data *cp = data;
499 local_irq_save(flags);
500 __local_trigger(cp, softirq);
501 local_irq_restore(flags);
504 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
506 if (cpu_online(cpu)) {
507 cp->func = remote_softirq_receive;
512 __smp_call_function_single(cpu, cp);
517 #else /* CONFIG_USE_GENERIC_SMP_HELPERS */
518 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
525 * __send_remote_softirq - try to schedule softirq work on a remote cpu
526 * @cp: private SMP call function data area
527 * @cpu: the remote cpu
528 * @this_cpu: the currently executing cpu
529 * @softirq: the softirq for the work
531 * Attempt to schedule softirq work on a remote cpu. If this cannot be
532 * done, the work is instead queued up on the local cpu.
534 * Interrupts must be disabled.
536 void __send_remote_softirq(struct call_single_data *cp, int cpu, int this_cpu, int softirq)
538 if (cpu == this_cpu || __try_remote_softirq(cp, cpu, softirq))
539 __local_trigger(cp, softirq);
541 EXPORT_SYMBOL(__send_remote_softirq);
544 * send_remote_softirq - try to schedule softirq work on a remote cpu
545 * @cp: private SMP call function data area
546 * @cpu: the remote cpu
547 * @softirq: the softirq for the work
549 * Like __send_remote_softirq except that disabling interrupts and
550 * computing the current cpu is done for the caller.
552 void send_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
557 local_irq_save(flags);
558 this_cpu = smp_processor_id();
559 __send_remote_softirq(cp, cpu, this_cpu, softirq);
560 local_irq_restore(flags);
562 EXPORT_SYMBOL(send_remote_softirq);
564 static int __cpuinit remote_softirq_cpu_notify(struct notifier_block *self,
565 unsigned long action, void *hcpu)
568 * If a CPU goes away, splice its entries to the current CPU
569 * and trigger a run of the softirq
571 if (action == CPU_DEAD || action == CPU_DEAD_FROZEN) {
572 int cpu = (unsigned long) hcpu;
576 for (i = 0; i < NR_SOFTIRQS; i++) {
577 struct list_head *head = &per_cpu(softirq_work_list[i], cpu);
578 struct list_head *local_head;
580 if (list_empty(head))
583 local_head = &__get_cpu_var(softirq_work_list[i]);
584 list_splice_init(head, local_head);
585 raise_softirq_irqoff(i);
593 static struct notifier_block __cpuinitdata remote_softirq_cpu_notifier = {
594 .notifier_call = remote_softirq_cpu_notify,
597 void __init softirq_init(void)
601 for_each_possible_cpu(cpu) {
604 per_cpu(tasklet_vec, cpu).tail =
605 &per_cpu(tasklet_vec, cpu).head;
606 per_cpu(tasklet_hi_vec, cpu).tail =
607 &per_cpu(tasklet_hi_vec, cpu).head;
608 for (i = 0; i < NR_SOFTIRQS; i++)
609 INIT_LIST_HEAD(&per_cpu(softirq_work_list[i], cpu));
612 register_hotcpu_notifier(&remote_softirq_cpu_notifier);
614 open_softirq(TASKLET_SOFTIRQ, tasklet_action);
615 open_softirq(HI_SOFTIRQ, tasklet_hi_action);
618 static int ksoftirqd(void * __bind_cpu)
620 set_current_state(TASK_INTERRUPTIBLE);
622 while (!kthread_should_stop()) {
624 if (!local_softirq_pending()) {
625 preempt_enable_no_resched();
630 __set_current_state(TASK_RUNNING);
632 while (local_softirq_pending()) {
633 /* Preempt disable stops cpu going offline.
634 If already offline, we'll be on wrong CPU:
636 if (cpu_is_offline((long)__bind_cpu))
639 preempt_enable_no_resched();
644 set_current_state(TASK_INTERRUPTIBLE);
646 __set_current_state(TASK_RUNNING);
651 /* Wait for kthread_stop */
652 set_current_state(TASK_INTERRUPTIBLE);
653 while (!kthread_should_stop()) {
655 set_current_state(TASK_INTERRUPTIBLE);
657 __set_current_state(TASK_RUNNING);
661 #ifdef CONFIG_HOTPLUG_CPU
663 * tasklet_kill_immediate is called to remove a tasklet which can already be
664 * scheduled for execution on @cpu.
666 * Unlike tasklet_kill, this function removes the tasklet
667 * _immediately_, even if the tasklet is in TASKLET_STATE_SCHED state.
669 * When this function is called, @cpu must be in the CPU_DEAD state.
671 void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu)
673 struct tasklet_struct **i;
675 BUG_ON(cpu_online(cpu));
676 BUG_ON(test_bit(TASKLET_STATE_RUN, &t->state));
678 if (!test_bit(TASKLET_STATE_SCHED, &t->state))
681 /* CPU is dead, so no lock needed. */
682 for (i = &per_cpu(tasklet_vec, cpu).head; *i; i = &(*i)->next) {
685 /* If this was the tail element, move the tail ptr */
687 per_cpu(tasklet_vec, cpu).tail = i;
694 static void takeover_tasklets(unsigned int cpu)
696 /* CPU is dead, so no lock needed. */
699 /* Find end, append list for that CPU. */
700 if (&per_cpu(tasklet_vec, cpu).head != per_cpu(tasklet_vec, cpu).tail) {
701 *(__get_cpu_var(tasklet_vec).tail) = per_cpu(tasklet_vec, cpu).head;
702 __get_cpu_var(tasklet_vec).tail = per_cpu(tasklet_vec, cpu).tail;
703 per_cpu(tasklet_vec, cpu).head = NULL;
704 per_cpu(tasklet_vec, cpu).tail = &per_cpu(tasklet_vec, cpu).head;
706 raise_softirq_irqoff(TASKLET_SOFTIRQ);
708 if (&per_cpu(tasklet_hi_vec, cpu).head != per_cpu(tasklet_hi_vec, cpu).tail) {
709 *__get_cpu_var(tasklet_hi_vec).tail = per_cpu(tasklet_hi_vec, cpu).head;
710 __get_cpu_var(tasklet_hi_vec).tail = per_cpu(tasklet_hi_vec, cpu).tail;
711 per_cpu(tasklet_hi_vec, cpu).head = NULL;
712 per_cpu(tasklet_hi_vec, cpu).tail = &per_cpu(tasklet_hi_vec, cpu).head;
714 raise_softirq_irqoff(HI_SOFTIRQ);
718 #endif /* CONFIG_HOTPLUG_CPU */
720 static int __cpuinit cpu_callback(struct notifier_block *nfb,
721 unsigned long action,
724 int hotcpu = (unsigned long)hcpu;
725 struct task_struct *p;
729 case CPU_UP_PREPARE_FROZEN:
730 p = kthread_create(ksoftirqd, hcpu, "ksoftirqd/%d", hotcpu);
732 printk("ksoftirqd for %i failed\n", hotcpu);
735 kthread_bind(p, hotcpu);
736 per_cpu(ksoftirqd, hotcpu) = p;
739 case CPU_ONLINE_FROZEN:
740 wake_up_process(per_cpu(ksoftirqd, hotcpu));
742 #ifdef CONFIG_HOTPLUG_CPU
743 case CPU_UP_CANCELED:
744 case CPU_UP_CANCELED_FROZEN:
745 if (!per_cpu(ksoftirqd, hotcpu))
747 /* Unbind so it can run. Fall thru. */
748 kthread_bind(per_cpu(ksoftirqd, hotcpu),
749 any_online_cpu(cpu_online_map));
751 case CPU_DEAD_FROZEN: {
752 struct sched_param param = { .sched_priority = MAX_RT_PRIO-1 };
754 p = per_cpu(ksoftirqd, hotcpu);
755 per_cpu(ksoftirqd, hotcpu) = NULL;
756 sched_setscheduler_nocheck(p, SCHED_FIFO, ¶m);
758 takeover_tasklets(hotcpu);
761 #endif /* CONFIG_HOTPLUG_CPU */
766 static struct notifier_block __cpuinitdata cpu_nfb = {
767 .notifier_call = cpu_callback
770 static __init int spawn_ksoftirqd(void)
772 void *cpu = (void *)(long)smp_processor_id();
773 int err = cpu_callback(&cpu_nfb, CPU_UP_PREPARE, cpu);
775 BUG_ON(err == NOTIFY_BAD);
776 cpu_callback(&cpu_nfb, CPU_ONLINE, cpu);
777 register_cpu_notifier(&cpu_nfb);
780 early_initcall(spawn_ksoftirqd);
784 * Call a function on all processors
786 int on_each_cpu(void (*func) (void *info), void *info, int wait)
791 ret = smp_call_function(func, info, wait);
798 EXPORT_SYMBOL(on_each_cpu);