519a1cb7c33100af73aa914825400115e76e0eb8
[linux-2.6.git] / include / linux / irq.h
1 #ifndef _LINUX_IRQ_H
2 #define _LINUX_IRQ_H
3
4 /*
5  * Please do not include this file in generic code.  There is currently
6  * no requirement for any architecture to implement anything held
7  * within this file.
8  *
9  * Thanks. --rmk
10  */
11
12 #include <linux/smp.h>
13
14 #ifndef CONFIG_S390
15
16 #include <linux/linkage.h>
17 #include <linux/cache.h>
18 #include <linux/spinlock.h>
19 #include <linux/cpumask.h>
20 #include <linux/irqreturn.h>
21
22 #include <asm/irq.h>
23 #include <asm/ptrace.h>
24
25 /*
26  * IRQ line status.
27  */
28 #define IRQ_INPROGRESS  1       /* IRQ handler active - do not enter! */
29 #define IRQ_DISABLED    2       /* IRQ disabled - do not enter! */
30 #define IRQ_PENDING     4       /* IRQ pending - replay on enable */
31 #define IRQ_REPLAY      8       /* IRQ has been replayed but not acked yet */
32 #define IRQ_AUTODETECT  16      /* IRQ is being autodetected */
33 #define IRQ_WAITING     32      /* IRQ not yet seen - for autodetection */
34 #define IRQ_LEVEL       64      /* IRQ level triggered */
35 #define IRQ_MASKED      128     /* IRQ masked - shouldn't be seen again */
36 #ifdef CONFIG_IRQ_PER_CPU
37 # define IRQ_PER_CPU    256     /* IRQ is per CPU */
38 # define CHECK_IRQ_PER_CPU(var) ((var) & IRQ_PER_CPU)
39 #else
40 # define CHECK_IRQ_PER_CPU(var) 0
41 #endif
42
43 /*
44  * Interrupt controller descriptor. This is all we need
45  * to describe about the low-level hardware. 
46  */
47 struct hw_interrupt_type {
48         const char      *typename;
49         unsigned int    (*startup)(unsigned int irq);
50         void            (*shutdown)(unsigned int irq);
51         void            (*enable)(unsigned int irq);
52         void            (*disable)(unsigned int irq);
53         void            (*ack)(unsigned int irq);
54         void            (*end)(unsigned int irq);
55         void            (*set_affinity)(unsigned int irq, cpumask_t dest);
56         /* Currently used only by UML, might disappear one day.*/
57 #ifdef CONFIG_IRQ_RELEASE_METHOD
58         void            (*release)(unsigned int irq, void *dev_id);
59 #endif
60 };
61
62 typedef struct hw_interrupt_type  hw_irq_controller;
63
64 struct proc_dir_entry;
65
66 /*
67  * This is the "IRQ descriptor", which contains various information
68  * about the irq, including what kind of hardware handling it has,
69  * whether it is disabled etc etc.
70  *
71  * Pad this out to 32 bytes for cache and indexing reasons.
72  */
73 struct irq_desc {
74         hw_irq_controller       *chip;
75         void                    *chip_data;
76         struct irqaction        *action;        /* IRQ action list */
77         unsigned int            status;         /* IRQ status */
78         unsigned int            depth;          /* nested irq disables */
79         unsigned int            irq_count;      /* For detecting broken IRQs */
80         unsigned int            irqs_unhandled;
81         spinlock_t              lock;
82 #ifdef CONFIG_SMP
83         cpumask_t               affinity;
84 #endif
85 #if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
86         cpumask_t               pending_mask;
87         unsigned int            move_irq;       /* need to re-target IRQ dest */
88 #endif
89 #ifdef CONFIG_PROC_FS
90         struct proc_dir_entry *dir;
91 #endif
92 } ____cacheline_aligned;
93
94 extern struct irq_desc irq_desc[NR_IRQS];
95
96 /*
97  * Migration helpers for obsolete names, they will go away:
98  */
99 typedef struct irq_desc         irq_desc_t;
100
101 /*
102  * Pick up the arch-dependent methods:
103  */
104 #include <asm/hw_irq.h>
105
106 extern int setup_irq(unsigned int irq, struct irqaction *new);
107
108 #ifdef CONFIG_GENERIC_HARDIRQS
109
110 #ifdef CONFIG_SMP
111 static inline void set_native_irq_info(int irq, cpumask_t mask)
112 {
113         irq_desc[irq].affinity = mask;
114 }
115 #else
116 static inline void set_native_irq_info(int irq, cpumask_t mask)
117 {
118 }
119 #endif
120
121 #ifdef CONFIG_SMP
122
123 #if defined(CONFIG_GENERIC_PENDING_IRQ) || defined(CONFIG_IRQBALANCE)
124
125 void set_pending_irq(unsigned int irq, cpumask_t mask);
126 void move_native_irq(int irq);
127
128 #ifdef CONFIG_PCI_MSI
129 /*
130  * Wonder why these are dummies?
131  * For e.g the set_ioapic_affinity_vector() calls the set_ioapic_affinity_irq()
132  * counter part after translating the vector to irq info. We need to perform
133  * this operation on the real irq, when we dont use vector, i.e when
134  * pci_use_vector() is false.
135  */
136 static inline void move_irq(int irq)
137 {
138 }
139
140 static inline void set_irq_info(int irq, cpumask_t mask)
141 {
142 }
143
144 #else /* CONFIG_PCI_MSI */
145
146 static inline void move_irq(int irq)
147 {
148         move_native_irq(irq);
149 }
150
151 static inline void set_irq_info(int irq, cpumask_t mask)
152 {
153         set_native_irq_info(irq, mask);
154 }
155
156 #endif /* CONFIG_PCI_MSI */
157
158 #else /* CONFIG_GENERIC_PENDING_IRQ || CONFIG_IRQBALANCE */
159
160 static inline void move_irq(int irq)
161 {
162 }
163
164 static inline void move_native_irq(int irq)
165 {
166 }
167
168 static inline void set_pending_irq(unsigned int irq, cpumask_t mask)
169 {
170 }
171
172 static inline void set_irq_info(int irq, cpumask_t mask)
173 {
174         set_native_irq_info(irq, mask);
175 }
176
177 #endif /* CONFIG_GENERIC_PENDING_IRQ */
178
179 #else /* CONFIG_SMP */
180
181 #define move_irq(x)
182 #define move_native_irq(x)
183
184 #endif /* CONFIG_SMP */
185
186 #ifdef CONFIG_IRQBALANCE
187 extern void set_balance_irq_affinity(unsigned int irq, cpumask_t mask);
188 #else
189 static inline void set_balance_irq_affinity(unsigned int irq, cpumask_t mask)
190 {
191 }
192 #endif
193
194 #ifdef CONFIG_AUTO_IRQ_AFFINITY
195 extern int select_smp_affinity(unsigned int irq);
196 #else
197 static inline int select_smp_affinity(unsigned int irq)
198 {
199         return 1;
200 }
201 #endif
202
203 extern int no_irq_affinity;
204 extern int noirqdebug_setup(char *str);
205
206 extern irqreturn_t handle_IRQ_event(unsigned int irq, struct pt_regs *regs,
207                                     struct irqaction *action);
208 /*
209  * Explicit fastcall, because i386 4KSTACKS calls it from assembly:
210  */
211 extern fastcall unsigned int __do_IRQ(unsigned int irq, struct pt_regs *regs);
212
213 extern void note_interrupt(unsigned int irq, struct irq_desc *desc,
214                            int action_ret, struct pt_regs *regs);
215 extern int can_request_irq(unsigned int irq, unsigned long irqflags);
216
217 extern void init_irq_proc(void);
218
219 #endif /* CONFIG_GENERIC_HARDIRQS */
220
221 extern hw_irq_controller no_irq_type;  /* needed in every arch ? */
222
223 #endif /* !CONFIG_S390 */
224
225 #endif /* _LINUX_IRQ_H */