arch/metag/kernel/kick.c

   1 /*
   2  *  Copyright (C) 2009 Imagination Technologies
   3  *
   4  * This file is subject to the terms and conditions of the GNU General Public
   5  * License.  See the file COPYING in the main directory of this archive
   6  * for more details.
   7  *
   8  * The Meta KICK interrupt mechanism is generally a useful feature, so
   9  * we provide an interface for registering multiple interrupt
  10  * handlers. All the registered interrupt handlers are "chained". When
  11  * a KICK interrupt is received the first function in the list is
  12  * called. If that interrupt handler cannot handle the KICK the next
  13  * one is called, then the next until someone handles it (or we run
  14  * out of functions). As soon as one function handles the interrupt no
  15  * other handlers are called.
  16  *
  17  * The only downside of chaining interrupt handlers is that each
  18  * handler must be able to detect whether the KICK was intended for it
  19  * or not.  For example, when the IPI handler runs and it sees that
  20  * there are no IPI messages it must not signal that the KICK was
  21  * handled, thereby giving the other handlers a chance to run.
  22  *
  23  * The reason that we provide our own interface for calling KICK
  24  * handlers instead of using the generic kernel infrastructure is that
  25  * the KICK handlers require access to a CPU's pTBI structure. So we
  26  * pass it as an argument.
  27  */
  28 #include <linux/kernel.h>
  29 #include <linux/mm.h>
  30 #include <linux/types.h>
  31
  32 #include <asm/traps.h>
  33
  34 /*
  35  * All accesses/manipulations of kick_handlers_list should be
  36  * performed while holding kick_handlers_lock.
  37  */
  38 static DEFINE_SPINLOCK(kick_handlers_lock);
  39 static LIST_HEAD(kick_handlers_list);
  40
  41 void kick_register_func(struct kick_irq_handler *kh)
  42 {
  43         unsigned long flags;
  44
  45         spin_lock_irqsave(&kick_handlers_lock, flags);
  46
  47         list_add_tail(&kh->list, &kick_handlers_list);
  48
  49         spin_unlock_irqrestore(&kick_handlers_lock, flags);
  50 }
  51
  52 void kick_unregister_func(struct kick_irq_handler *kh)
  53 {
  54         unsigned long flags;
  55
  56         spin_lock_irqsave(&kick_handlers_lock, flags);
  57
  58         list_del(&kh->list);
  59
  60         spin_unlock_irqrestore(&kick_handlers_lock, flags);
  61 }
  62
  63 TBIRES
  64 kick_handler(TBIRES State, int SigNum, int Triggers, int Inst, PTBI pTBI)
  65 {
  66         struct kick_irq_handler *kh;
  67         struct list_head *lh;
  68         int handled = 0;
  69         TBIRES ret;
  70
  71         head_end(State, ~INTS_OFF_MASK);
  72
  73         /* If we interrupted user code handle any critical sections. */
  74         if (State.Sig.SaveMask & TBICTX_PRIV_BIT)
  75                 restart_critical_section(State);
  76
  77         trace_hardirqs_off();
  78
  79         /*
  80          * There is no need to disable interrupts here because we
  81          * can't nest KICK interrupts in a KICK interrupt handler.
  82          */
  83         spin_lock(&kick_handlers_lock);
  84
  85         list_for_each(lh, &kick_handlers_list) {
  86                 kh = list_entry(lh, struct kick_irq_handler, list);
  87
  88                 ret = kh->func(State, SigNum, Triggers, Inst, pTBI, &handled);
  89                 if (handled)
  90                         break;
  91         }
  92
  93         spin_unlock(&kick_handlers_lock);
  94
  95         WARN_ON(!handled);
  96
  97         return tail_end(ret);
  98 }