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())
273 tick_check_idle(cpu);
278 #ifdef __ARCH_IRQ_EXIT_IRQS_DISABLED
279 # define invoke_softirq() __do_softirq()
281 # define invoke_softirq() do_softirq()
285 * Exit an interrupt context. Process softirqs if needed and possible:
289 account_system_vtime(current);
290 trace_hardirq_exit();
291 sub_preempt_count(IRQ_EXIT_OFFSET);
292 if (!in_interrupt() && local_softirq_pending())
296 /* Make sure that timer wheel updates are propagated */
297 if (!in_interrupt() && idle_cpu(smp_processor_id()) && !need_resched())
298 tick_nohz_stop_sched_tick(0);
301 preempt_enable_no_resched();
305 * This function must run with irqs disabled!
307 inline void raise_softirq_irqoff(unsigned int nr)
309 __raise_softirq_irqoff(nr);
312 * If we're in an interrupt or softirq, we're done
313 * (this also catches softirq-disabled code). We will
314 * actually run the softirq once we return from
315 * the irq or softirq.
317 * Otherwise we wake up ksoftirqd to make sure we
318 * schedule the softirq soon.
324 void raise_softirq(unsigned int nr)
328 local_irq_save(flags);
329 raise_softirq_irqoff(nr);
330 local_irq_restore(flags);
333 void open_softirq(int nr, void (*action)(struct softirq_action *))
335 softirq_vec[nr].action = action;
341 struct tasklet_struct *head;
342 struct tasklet_struct **tail;
345 static DEFINE_PER_CPU(struct tasklet_head, tasklet_vec);
346 static DEFINE_PER_CPU(struct tasklet_head, tasklet_hi_vec);
348 void __tasklet_schedule(struct tasklet_struct *t)
352 local_irq_save(flags);
354 *__get_cpu_var(tasklet_vec).tail = t;
355 __get_cpu_var(tasklet_vec).tail = &(t->next);
356 raise_softirq_irqoff(TASKLET_SOFTIRQ);
357 local_irq_restore(flags);
360 EXPORT_SYMBOL(__tasklet_schedule);
362 void __tasklet_hi_schedule(struct tasklet_struct *t)
366 local_irq_save(flags);
368 *__get_cpu_var(tasklet_hi_vec).tail = t;
369 __get_cpu_var(tasklet_hi_vec).tail = &(t->next);
370 raise_softirq_irqoff(HI_SOFTIRQ);
371 local_irq_restore(flags);
374 EXPORT_SYMBOL(__tasklet_hi_schedule);
376 static void tasklet_action(struct softirq_action *a)
378 struct tasklet_struct *list;
381 list = __get_cpu_var(tasklet_vec).head;
382 __get_cpu_var(tasklet_vec).head = NULL;
383 __get_cpu_var(tasklet_vec).tail = &__get_cpu_var(tasklet_vec).head;
387 struct tasklet_struct *t = list;
391 if (tasklet_trylock(t)) {
392 if (!atomic_read(&t->count)) {
393 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
404 *__get_cpu_var(tasklet_vec).tail = t;
405 __get_cpu_var(tasklet_vec).tail = &(t->next);
406 __raise_softirq_irqoff(TASKLET_SOFTIRQ);
411 static void tasklet_hi_action(struct softirq_action *a)
413 struct tasklet_struct *list;
416 list = __get_cpu_var(tasklet_hi_vec).head;
417 __get_cpu_var(tasklet_hi_vec).head = NULL;
418 __get_cpu_var(tasklet_hi_vec).tail = &__get_cpu_var(tasklet_hi_vec).head;
422 struct tasklet_struct *t = list;
426 if (tasklet_trylock(t)) {
427 if (!atomic_read(&t->count)) {
428 if (!test_and_clear_bit(TASKLET_STATE_SCHED, &t->state))
439 *__get_cpu_var(tasklet_hi_vec).tail = t;
440 __get_cpu_var(tasklet_hi_vec).tail = &(t->next);
441 __raise_softirq_irqoff(HI_SOFTIRQ);
447 void tasklet_init(struct tasklet_struct *t,
448 void (*func)(unsigned long), unsigned long data)
452 atomic_set(&t->count, 0);
457 EXPORT_SYMBOL(tasklet_init);
459 void tasklet_kill(struct tasklet_struct *t)
462 printk("Attempt to kill tasklet from interrupt\n");
464 while (test_and_set_bit(TASKLET_STATE_SCHED, &t->state)) {
467 while (test_bit(TASKLET_STATE_SCHED, &t->state));
469 tasklet_unlock_wait(t);
470 clear_bit(TASKLET_STATE_SCHED, &t->state);
473 EXPORT_SYMBOL(tasklet_kill);
475 DEFINE_PER_CPU(struct list_head [NR_SOFTIRQS], softirq_work_list);
476 EXPORT_PER_CPU_SYMBOL(softirq_work_list);
478 static void __local_trigger(struct call_single_data *cp, int softirq)
480 struct list_head *head = &__get_cpu_var(softirq_work_list[softirq]);
482 list_add_tail(&cp->list, head);
484 /* Trigger the softirq only if the list was previously empty. */
485 if (head->next == &cp->list)
486 raise_softirq_irqoff(softirq);
489 #ifdef CONFIG_USE_GENERIC_SMP_HELPERS
490 static void remote_softirq_receive(void *data)
492 struct call_single_data *cp = data;
498 local_irq_save(flags);
499 __local_trigger(cp, softirq);
500 local_irq_restore(flags);
503 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
505 if (cpu_online(cpu)) {
506 cp->func = remote_softirq_receive;
511 __smp_call_function_single(cpu, cp);
516 #else /* CONFIG_USE_GENERIC_SMP_HELPERS */
517 static int __try_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
524 * __send_remote_softirq - try to schedule softirq work on a remote cpu
525 * @cp: private SMP call function data area
526 * @cpu: the remote cpu
527 * @this_cpu: the currently executing cpu
528 * @softirq: the softirq for the work
530 * Attempt to schedule softirq work on a remote cpu. If this cannot be
531 * done, the work is instead queued up on the local cpu.
533 * Interrupts must be disabled.
535 void __send_remote_softirq(struct call_single_data *cp, int cpu, int this_cpu, int softirq)
537 if (cpu == this_cpu || __try_remote_softirq(cp, cpu, softirq))
538 __local_trigger(cp, softirq);
540 EXPORT_SYMBOL(__send_remote_softirq);
543 * send_remote_softirq - try to schedule softirq work on a remote cpu
544 * @cp: private SMP call function data area
545 * @cpu: the remote cpu
546 * @softirq: the softirq for the work
548 * Like __send_remote_softirq except that disabling interrupts and
549 * computing the current cpu is done for the caller.
551 void send_remote_softirq(struct call_single_data *cp, int cpu, int softirq)
556 local_irq_save(flags);
557 this_cpu = smp_processor_id();
558 __send_remote_softirq(cp, cpu, this_cpu, softirq);
559 local_irq_restore(flags);
561 EXPORT_SYMBOL(send_remote_softirq);
563 static int __cpuinit remote_softirq_cpu_notify(struct notifier_block *self,
564 unsigned long action, void *hcpu)
567 * If a CPU goes away, splice its entries to the current CPU
568 * and trigger a run of the softirq
570 if (action == CPU_DEAD || action == CPU_DEAD_FROZEN) {
571 int cpu = (unsigned long) hcpu;
575 for (i = 0; i < NR_SOFTIRQS; i++) {
576 struct list_head *head = &per_cpu(softirq_work_list[i], cpu);
577 struct list_head *local_head;
579 if (list_empty(head))
582 local_head = &__get_cpu_var(softirq_work_list[i]);
583 list_splice_init(head, local_head);
584 raise_softirq_irqoff(i);
592 static struct notifier_block __cpuinitdata remote_softirq_cpu_notifier = {
593 .notifier_call = remote_softirq_cpu_notify,
596 void __init softirq_init(void)
600 for_each_possible_cpu(cpu) {
603 per_cpu(tasklet_vec, cpu).tail =
604 &per_cpu(tasklet_vec, cpu).head;
605 per_cpu(tasklet_hi_vec, cpu).tail =
606 &per_cpu(tasklet_hi_vec, cpu).head;
607 for (i = 0; i < NR_SOFTIRQS; i++)
608 INIT_LIST_HEAD(&per_cpu(softirq_work_list[i], cpu));
611 register_hotcpu_notifier(&remote_softirq_cpu_notifier);
613 open_softirq(TASKLET_SOFTIRQ, tasklet_action);
614 open_softirq(HI_SOFTIRQ, tasklet_hi_action);
617 static int ksoftirqd(void * __bind_cpu)
619 set_current_state(TASK_INTERRUPTIBLE);
621 while (!kthread_should_stop()) {
623 if (!local_softirq_pending()) {
624 preempt_enable_no_resched();
629 __set_current_state(TASK_RUNNING);
631 while (local_softirq_pending()) {
632 /* Preempt disable stops cpu going offline.
633 If already offline, we'll be on wrong CPU:
635 if (cpu_is_offline((long)__bind_cpu))
638 preempt_enable_no_resched();
643 set_current_state(TASK_INTERRUPTIBLE);
645 __set_current_state(TASK_RUNNING);
650 /* Wait for kthread_stop */
651 set_current_state(TASK_INTERRUPTIBLE);
652 while (!kthread_should_stop()) {
654 set_current_state(TASK_INTERRUPTIBLE);
656 __set_current_state(TASK_RUNNING);
660 #ifdef CONFIG_HOTPLUG_CPU
662 * tasklet_kill_immediate is called to remove a tasklet which can already be
663 * scheduled for execution on @cpu.
665 * Unlike tasklet_kill, this function removes the tasklet
666 * _immediately_, even if the tasklet is in TASKLET_STATE_SCHED state.
668 * When this function is called, @cpu must be in the CPU_DEAD state.
670 void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu)
672 struct tasklet_struct **i;
674 BUG_ON(cpu_online(cpu));
675 BUG_ON(test_bit(TASKLET_STATE_RUN, &t->state));
677 if (!test_bit(TASKLET_STATE_SCHED, &t->state))
680 /* CPU is dead, so no lock needed. */
681 for (i = &per_cpu(tasklet_vec, cpu).head; *i; i = &(*i)->next) {
684 /* If this was the tail element, move the tail ptr */
686 per_cpu(tasklet_vec, cpu).tail = i;
693 static void takeover_tasklets(unsigned int cpu)
695 /* CPU is dead, so no lock needed. */
698 /* Find end, append list for that CPU. */
699 if (&per_cpu(tasklet_vec, cpu).head != per_cpu(tasklet_vec, cpu).tail) {
700 *(__get_cpu_var(tasklet_vec).tail) = per_cpu(tasklet_vec, cpu).head;
701 __get_cpu_var(tasklet_vec).tail = per_cpu(tasklet_vec, cpu).tail;
702 per_cpu(tasklet_vec, cpu).head = NULL;
703 per_cpu(tasklet_vec, cpu).tail = &per_cpu(tasklet_vec, cpu).head;
705 raise_softirq_irqoff(TASKLET_SOFTIRQ);
707 if (&per_cpu(tasklet_hi_vec, cpu).head != per_cpu(tasklet_hi_vec, cpu).tail) {
708 *__get_cpu_var(tasklet_hi_vec).tail = per_cpu(tasklet_hi_vec, cpu).head;
709 __get_cpu_var(tasklet_hi_vec).tail = per_cpu(tasklet_hi_vec, cpu).tail;
710 per_cpu(tasklet_hi_vec, cpu).head = NULL;
711 per_cpu(tasklet_hi_vec, cpu).tail = &per_cpu(tasklet_hi_vec, cpu).head;
713 raise_softirq_irqoff(HI_SOFTIRQ);
717 #endif /* CONFIG_HOTPLUG_CPU */
719 static int __cpuinit cpu_callback(struct notifier_block *nfb,
720 unsigned long action,
723 int hotcpu = (unsigned long)hcpu;
724 struct task_struct *p;
728 case CPU_UP_PREPARE_FROZEN:
729 p = kthread_create(ksoftirqd, hcpu, "ksoftirqd/%d", hotcpu);
731 printk("ksoftirqd for %i failed\n", hotcpu);
734 kthread_bind(p, hotcpu);
735 per_cpu(ksoftirqd, hotcpu) = p;
738 case CPU_ONLINE_FROZEN:
739 wake_up_process(per_cpu(ksoftirqd, hotcpu));
741 #ifdef CONFIG_HOTPLUG_CPU
742 case CPU_UP_CANCELED:
743 case CPU_UP_CANCELED_FROZEN:
744 if (!per_cpu(ksoftirqd, hotcpu))
746 /* Unbind so it can run. Fall thru. */
747 kthread_bind(per_cpu(ksoftirqd, hotcpu),
748 any_online_cpu(cpu_online_map));
750 case CPU_DEAD_FROZEN: {
751 struct sched_param param = { .sched_priority = MAX_RT_PRIO-1 };
753 p = per_cpu(ksoftirqd, hotcpu);
754 per_cpu(ksoftirqd, hotcpu) = NULL;
755 sched_setscheduler_nocheck(p, SCHED_FIFO, ¶m);
757 takeover_tasklets(hotcpu);
760 #endif /* CONFIG_HOTPLUG_CPU */
765 static struct notifier_block __cpuinitdata cpu_nfb = {
766 .notifier_call = cpu_callback
769 static __init int spawn_ksoftirqd(void)
771 void *cpu = (void *)(long)smp_processor_id();
772 int err = cpu_callback(&cpu_nfb, CPU_UP_PREPARE, cpu);
774 BUG_ON(err == NOTIFY_BAD);
775 cpu_callback(&cpu_nfb, CPU_ONLINE, cpu);
776 register_cpu_notifier(&cpu_nfb);
779 early_initcall(spawn_ksoftirqd);
783 * Call a function on all processors
785 int on_each_cpu(void (*func) (void *info), void *info, int wait)
790 ret = smp_call_function(func, info, wait);
797 EXPORT_SYMBOL(on_each_cpu);