xref: /linux-6.15/include/linux/interrupt.h (revision 151f4e2b)
1b2441318SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0 */
21da177e4SLinus Torvalds /* interrupt.h */
31da177e4SLinus Torvalds #ifndef _LINUX_INTERRUPT_H
41da177e4SLinus Torvalds #define _LINUX_INTERRUPT_H
51da177e4SLinus Torvalds 
61da177e4SLinus Torvalds #include <linux/kernel.h>
71da177e4SLinus Torvalds #include <linux/bitops.h>
81da177e4SLinus Torvalds #include <linux/cpumask.h>
9908dcecdSJan Beulich #include <linux/irqreturn.h>
10dd3a1db9SThomas Gleixner #include <linux/irqnr.h>
111da177e4SLinus Torvalds #include <linux/hardirq.h>
12de30a2b3SIngo Molnar #include <linux/irqflags.h>
139ba5f005SPeter Zijlstra #include <linux/hrtimer.h>
14cd7eab44SBen Hutchings #include <linux/kref.h>
15cd7eab44SBen Hutchings #include <linux/workqueue.h>
160ebb26e7SIngo Molnar 
1760063497SArun Sharma #include <linux/atomic.h>
181da177e4SLinus Torvalds #include <asm/ptrace.h>
197d65f4a6SFrederic Weisbecker #include <asm/irq.h>
20229a7186SMasami Hiramatsu #include <asm/sections.h>
211da177e4SLinus Torvalds 
226e213616SThomas Gleixner /*
236e213616SThomas Gleixner  * These correspond to the IORESOURCE_IRQ_* defines in
246e213616SThomas Gleixner  * linux/ioport.h to select the interrupt line behaviour.  When
256e213616SThomas Gleixner  * requesting an interrupt without specifying a IRQF_TRIGGER, the
266e213616SThomas Gleixner  * setting should be assumed to be "as already configured", which
276e213616SThomas Gleixner  * may be as per machine or firmware initialisation.
286e213616SThomas Gleixner  */
296e213616SThomas Gleixner #define IRQF_TRIGGER_NONE	0x00000000
306e213616SThomas Gleixner #define IRQF_TRIGGER_RISING	0x00000001
316e213616SThomas Gleixner #define IRQF_TRIGGER_FALLING	0x00000002
326e213616SThomas Gleixner #define IRQF_TRIGGER_HIGH	0x00000004
336e213616SThomas Gleixner #define IRQF_TRIGGER_LOW	0x00000008
346e213616SThomas Gleixner #define IRQF_TRIGGER_MASK	(IRQF_TRIGGER_HIGH | IRQF_TRIGGER_LOW | \
356e213616SThomas Gleixner 				 IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING)
366e213616SThomas Gleixner #define IRQF_TRIGGER_PROBE	0x00000010
376e213616SThomas Gleixner 
386e213616SThomas Gleixner /*
396e213616SThomas Gleixner  * These flags used only by the kernel as part of the
406e213616SThomas Gleixner  * irq handling routines.
416e213616SThomas Gleixner  *
426e213616SThomas Gleixner  * IRQF_SHARED - allow sharing the irq among several devices
436e213616SThomas Gleixner  * IRQF_PROBE_SHARED - set by callers when they expect sharing mismatches to occur
446e213616SThomas Gleixner  * IRQF_TIMER - Flag to mark this interrupt as timer interrupt
45950f4427SThomas Gleixner  * IRQF_PERCPU - Interrupt is per cpu
46950f4427SThomas Gleixner  * IRQF_NOBALANCING - Flag to exclude this interrupt from irq balancing
47d85a60d8SBernhard Walle  * IRQF_IRQPOLL - Interrupt is used for polling (only the interrupt that is
48b8d62f33SGeert Uytterhoeven  *                registered first in a shared interrupt is considered for
49d85a60d8SBernhard Walle  *                performance reasons)
50b25c340cSThomas Gleixner  * IRQF_ONESHOT - Interrupt is not reenabled after the hardirq handler finished.
51b25c340cSThomas Gleixner  *                Used by threaded interrupts which need to keep the
52b25c340cSThomas Gleixner  *                irq line disabled until the threaded handler has been run.
53737eb030SMark Rutland  * IRQF_NO_SUSPEND - Do not disable this IRQ during suspend.  Does not guarantee
54737eb030SMark Rutland  *                   that this interrupt will wake the system from a suspended
55*151f4e2bSMauro Carvalho Chehab  *                   state.  See Documentation/power/suspend-and-interrupts.rst
56dc5f219eSThomas Gleixner  * IRQF_FORCE_RESUME - Force enable it on resume even if IRQF_NO_SUSPEND is set
570c4602ffSThomas Gleixner  * IRQF_NO_THREAD - Interrupt cannot be threaded
589bab0b7fSIan Campbell  * IRQF_EARLY_RESUME - Resume IRQ early during syscore instead of at device
599bab0b7fSIan Campbell  *                resume time.
6017f48034SRafael J. Wysocki  * IRQF_COND_SUSPEND - If the IRQ is shared with a NO_SUSPEND user, execute this
6117f48034SRafael J. Wysocki  *                interrupt handler after suspending interrupts. For system
6217f48034SRafael J. Wysocki  *                wakeup devices users need to implement wakeup detection in
6317f48034SRafael J. Wysocki  *                their interrupt handlers.
646e213616SThomas Gleixner  */
656e213616SThomas Gleixner #define IRQF_SHARED		0x00000080
666e213616SThomas Gleixner #define IRQF_PROBE_SHARED	0x00000100
67685fd0b4SIan Campbell #define __IRQF_TIMER		0x00000200
68284c6680SThomas Gleixner #define IRQF_PERCPU		0x00000400
69950f4427SThomas Gleixner #define IRQF_NOBALANCING	0x00000800
70d85a60d8SBernhard Walle #define IRQF_IRQPOLL		0x00001000
71b25c340cSThomas Gleixner #define IRQF_ONESHOT		0x00002000
72685fd0b4SIan Campbell #define IRQF_NO_SUSPEND		0x00004000
73dc5f219eSThomas Gleixner #define IRQF_FORCE_RESUME	0x00008000
740c4602ffSThomas Gleixner #define IRQF_NO_THREAD		0x00010000
759bab0b7fSIan Campbell #define IRQF_EARLY_RESUME	0x00020000
7617f48034SRafael J. Wysocki #define IRQF_COND_SUSPEND	0x00040000
77685fd0b4SIan Campbell 
780c4602ffSThomas Gleixner #define IRQF_TIMER		(__IRQF_TIMER | IRQF_NO_SUSPEND | IRQF_NO_THREAD)
793aa551c9SThomas Gleixner 
80b4e6b097SRandy Dunlap /*
81ae731f8dSMarc Zyngier  * These values can be returned by request_any_context_irq() and
82ae731f8dSMarc Zyngier  * describe the context the interrupt will be run in.
83ae731f8dSMarc Zyngier  *
84ae731f8dSMarc Zyngier  * IRQC_IS_HARDIRQ - interrupt runs in hardirq context
85ae731f8dSMarc Zyngier  * IRQC_IS_NESTED - interrupt runs in a nested threaded context
86ae731f8dSMarc Zyngier  */
87ae731f8dSMarc Zyngier enum {
88ae731f8dSMarc Zyngier 	IRQC_IS_HARDIRQ	= 0,
89ae731f8dSMarc Zyngier 	IRQC_IS_NESTED,
90ae731f8dSMarc Zyngier };
91ae731f8dSMarc Zyngier 
927d12e780SDavid Howells typedef irqreturn_t (*irq_handler_t)(int, void *);
93da482792SDavid Howells 
94a9d0a1a3SThomas Gleixner /**
95a9d0a1a3SThomas Gleixner  * struct irqaction - per interrupt action descriptor
96a9d0a1a3SThomas Gleixner  * @handler:	interrupt handler function
97a9d0a1a3SThomas Gleixner  * @name:	name of the device
98a9d0a1a3SThomas Gleixner  * @dev_id:	cookie to identify the device
9931d9d9b6SMarc Zyngier  * @percpu_dev_id:	cookie to identify the device
100a9d0a1a3SThomas Gleixner  * @next:	pointer to the next irqaction for shared interrupts
101a9d0a1a3SThomas Gleixner  * @irq:	interrupt number
102c0ecaa06SThomas Gleixner  * @flags:	flags (see IRQF_* above)
10325985edcSLucas De Marchi  * @thread_fn:	interrupt handler function for threaded interrupts
1043aa551c9SThomas Gleixner  * @thread:	thread pointer for threaded interrupts
1052a1d3ab8SThomas Gleixner  * @secondary:	pointer to secondary irqaction (force threading)
1063aa551c9SThomas Gleixner  * @thread_flags:	flags related to @thread
107b5faba21SThomas Gleixner  * @thread_mask:	bitmask for keeping track of @thread activity
108c0ecaa06SThomas Gleixner  * @dir:	pointer to the proc/irq/NN/name entry
109a9d0a1a3SThomas Gleixner  */
1101da177e4SLinus Torvalds struct irqaction {
111da482792SDavid Howells 	irq_handler_t		handler;
1121da177e4SLinus Torvalds 	void			*dev_id;
11331d9d9b6SMarc Zyngier 	void __percpu		*percpu_dev_id;
1141da177e4SLinus Torvalds 	struct irqaction	*next;
1153aa551c9SThomas Gleixner 	irq_handler_t		thread_fn;
1163aa551c9SThomas Gleixner 	struct task_struct	*thread;
1172a1d3ab8SThomas Gleixner 	struct irqaction	*secondary;
118c0ecaa06SThomas Gleixner 	unsigned int		irq;
119c0ecaa06SThomas Gleixner 	unsigned int		flags;
1203aa551c9SThomas Gleixner 	unsigned long		thread_flags;
121b5faba21SThomas Gleixner 	unsigned long		thread_mask;
122f6cd2477SEric Dumazet 	const char		*name;
123f6cd2477SEric Dumazet 	struct proc_dir_entry	*dir;
124f6cd2477SEric Dumazet } ____cacheline_internodealigned_in_smp;
1251da177e4SLinus Torvalds 
1267d12e780SDavid Howells extern irqreturn_t no_action(int cpl, void *dev_id);
1273aa551c9SThomas Gleixner 
128e237a551SChen Fan /*
129e237a551SChen Fan  * If a (PCI) device interrupt is not connected we set dev->irq to
130e237a551SChen Fan  * IRQ_NOTCONNECTED. This causes request_irq() to fail with -ENOTCONN, so we
131e237a551SChen Fan  * can distingiush that case from other error returns.
132e237a551SChen Fan  *
133e237a551SChen Fan  * 0x80000000 is guaranteed to be outside the available range of interrupts
134e237a551SChen Fan  * and easy to distinguish from other possible incorrect values.
135e237a551SChen Fan  */
136e237a551SChen Fan #define IRQ_NOTCONNECTED	(1U << 31)
137e237a551SChen Fan 
1383aa551c9SThomas Gleixner extern int __must_check
1393aa551c9SThomas Gleixner request_threaded_irq(unsigned int irq, irq_handler_t handler,
1403aa551c9SThomas Gleixner 		     irq_handler_t thread_fn,
1413aa551c9SThomas Gleixner 		     unsigned long flags, const char *name, void *dev);
1423aa551c9SThomas Gleixner 
1433aa551c9SThomas Gleixner static inline int __must_check
1443aa551c9SThomas Gleixner request_irq(unsigned int irq, irq_handler_t handler, unsigned long flags,
1453aa551c9SThomas Gleixner 	    const char *name, void *dev)
1463aa551c9SThomas Gleixner {
1473aa551c9SThomas Gleixner 	return request_threaded_irq(irq, handler, NULL, flags, name, dev);
1483aa551c9SThomas Gleixner }
1493aa551c9SThomas Gleixner 
150ae731f8dSMarc Zyngier extern int __must_check
151ae731f8dSMarc Zyngier request_any_context_irq(unsigned int irq, irq_handler_t handler,
152ae731f8dSMarc Zyngier 			unsigned long flags, const char *name, void *dev_id);
153ae731f8dSMarc Zyngier 
15431d9d9b6SMarc Zyngier extern int __must_check
155c80081b9SDaniel Lezcano __request_percpu_irq(unsigned int irq, irq_handler_t handler,
156c80081b9SDaniel Lezcano 		     unsigned long flags, const char *devname,
157c80081b9SDaniel Lezcano 		     void __percpu *percpu_dev_id);
158c80081b9SDaniel Lezcano 
159b525903cSJulien Thierry extern int __must_check
160b525903cSJulien Thierry request_nmi(unsigned int irq, irq_handler_t handler, unsigned long flags,
161b525903cSJulien Thierry 	    const char *name, void *dev);
162b525903cSJulien Thierry 
163c80081b9SDaniel Lezcano static inline int __must_check
16431d9d9b6SMarc Zyngier request_percpu_irq(unsigned int irq, irq_handler_t handler,
165c80081b9SDaniel Lezcano 		   const char *devname, void __percpu *percpu_dev_id)
166c80081b9SDaniel Lezcano {
167c80081b9SDaniel Lezcano 	return __request_percpu_irq(irq, handler, 0,
168c80081b9SDaniel Lezcano 				    devname, percpu_dev_id);
169c80081b9SDaniel Lezcano }
1703aa551c9SThomas Gleixner 
1714b078c3fSJulien Thierry extern int __must_check
1724b078c3fSJulien Thierry request_percpu_nmi(unsigned int irq, irq_handler_t handler,
1734b078c3fSJulien Thierry 		   const char *devname, void __percpu *dev);
1744b078c3fSJulien Thierry 
17525ce4be7SChristoph Hellwig extern const void *free_irq(unsigned int, void *);
17631d9d9b6SMarc Zyngier extern void free_percpu_irq(unsigned int, void __percpu *);
1771da177e4SLinus Torvalds 
178b525903cSJulien Thierry extern const void *free_nmi(unsigned int irq, void *dev_id);
1794b078c3fSJulien Thierry extern void free_percpu_nmi(unsigned int irq, void __percpu *percpu_dev_id);
180b525903cSJulien Thierry 
1810af3678fSAl Viro struct device;
1820af3678fSAl Viro 
183935bd5b9SArjan van de Ven extern int __must_check
184935bd5b9SArjan van de Ven devm_request_threaded_irq(struct device *dev, unsigned int irq,
185935bd5b9SArjan van de Ven 			  irq_handler_t handler, irq_handler_t thread_fn,
186935bd5b9SArjan van de Ven 			  unsigned long irqflags, const char *devname,
187935bd5b9SArjan van de Ven 			  void *dev_id);
188935bd5b9SArjan van de Ven 
189935bd5b9SArjan van de Ven static inline int __must_check
190935bd5b9SArjan van de Ven devm_request_irq(struct device *dev, unsigned int irq, irq_handler_t handler,
191935bd5b9SArjan van de Ven 		 unsigned long irqflags, const char *devname, void *dev_id)
192935bd5b9SArjan van de Ven {
193935bd5b9SArjan van de Ven 	return devm_request_threaded_irq(dev, irq, handler, NULL, irqflags,
194935bd5b9SArjan van de Ven 					 devname, dev_id);
195935bd5b9SArjan van de Ven }
196935bd5b9SArjan van de Ven 
1970668d306SStephen Boyd extern int __must_check
1980668d306SStephen Boyd devm_request_any_context_irq(struct device *dev, unsigned int irq,
1990668d306SStephen Boyd 		 irq_handler_t handler, unsigned long irqflags,
2000668d306SStephen Boyd 		 const char *devname, void *dev_id);
2010668d306SStephen Boyd 
2029ac7849eSTejun Heo extern void devm_free_irq(struct device *dev, unsigned int irq, void *dev_id);
2039ac7849eSTejun Heo 
204d7e9629dSIngo Molnar /*
205d7e9629dSIngo Molnar  * On lockdep we dont want to enable hardirqs in hardirq
206d7e9629dSIngo Molnar  * context. Use local_irq_enable_in_hardirq() to annotate
207d7e9629dSIngo Molnar  * kernel code that has to do this nevertheless (pretty much
208d7e9629dSIngo Molnar  * the only valid case is for old/broken hardware that is
209d7e9629dSIngo Molnar  * insanely slow).
210d7e9629dSIngo Molnar  *
211d7e9629dSIngo Molnar  * NOTE: in theory this might break fragile code that relies
212d7e9629dSIngo Molnar  * on hardirq delivery - in practice we dont seem to have such
213d7e9629dSIngo Molnar  * places left. So the only effect should be slightly increased
214d7e9629dSIngo Molnar  * irqs-off latencies.
215d7e9629dSIngo Molnar  */
216d7e9629dSIngo Molnar #ifdef CONFIG_LOCKDEP
217d7e9629dSIngo Molnar # define local_irq_enable_in_hardirq()	do { } while (0)
218d7e9629dSIngo Molnar #else
219d7e9629dSIngo Molnar # define local_irq_enable_in_hardirq()	local_irq_enable()
220d7e9629dSIngo Molnar #endif
2211da177e4SLinus Torvalds 
2221da177e4SLinus Torvalds extern void disable_irq_nosync(unsigned int irq);
22302cea395SPeter Zijlstra extern bool disable_hardirq(unsigned int irq);
2241da177e4SLinus Torvalds extern void disable_irq(unsigned int irq);
22531d9d9b6SMarc Zyngier extern void disable_percpu_irq(unsigned int irq);
2261da177e4SLinus Torvalds extern void enable_irq(unsigned int irq);
2271e7c5fd2SMarc Zyngier extern void enable_percpu_irq(unsigned int irq, unsigned int type);
228f0cb3220SThomas Petazzoni extern bool irq_percpu_is_enabled(unsigned int irq);
229a92444c6SThomas Gleixner extern void irq_wake_thread(unsigned int irq, void *dev_id);
230ba9a2331SThomas Gleixner 
231b525903cSJulien Thierry extern void disable_nmi_nosync(unsigned int irq);
2324b078c3fSJulien Thierry extern void disable_percpu_nmi(unsigned int irq);
233b525903cSJulien Thierry extern void enable_nmi(unsigned int irq);
2344b078c3fSJulien Thierry extern void enable_percpu_nmi(unsigned int irq, unsigned int type);
2354b078c3fSJulien Thierry extern int prepare_percpu_nmi(unsigned int irq);
2364b078c3fSJulien Thierry extern void teardown_percpu_nmi(unsigned int irq);
237b525903cSJulien Thierry 
2380a0c5168SRafael J. Wysocki /* The following three functions are for the core kernel use only. */
2390a0c5168SRafael J. Wysocki extern void suspend_device_irqs(void);
2400a0c5168SRafael J. Wysocki extern void resume_device_irqs(void);
2410a0c5168SRafael J. Wysocki 
242f0ba3d05SEyal Perry /**
243f0ba3d05SEyal Perry  * struct irq_affinity_notify - context for notification of IRQ affinity changes
244f0ba3d05SEyal Perry  * @irq:		Interrupt to which notification applies
245f0ba3d05SEyal Perry  * @kref:		Reference count, for internal use
246f0ba3d05SEyal Perry  * @work:		Work item, for internal use
247f0ba3d05SEyal Perry  * @notify:		Function to be called on change.  This will be
248f0ba3d05SEyal Perry  *			called in process context.
249f0ba3d05SEyal Perry  * @release:		Function to be called on release.  This will be
250f0ba3d05SEyal Perry  *			called in process context.  Once registered, the
251f0ba3d05SEyal Perry  *			structure must only be freed when this function is
252f0ba3d05SEyal Perry  *			called or later.
253f0ba3d05SEyal Perry  */
254f0ba3d05SEyal Perry struct irq_affinity_notify {
255f0ba3d05SEyal Perry 	unsigned int irq;
256f0ba3d05SEyal Perry 	struct kref kref;
257f0ba3d05SEyal Perry 	struct work_struct work;
258f0ba3d05SEyal Perry 	void (*notify)(struct irq_affinity_notify *, const cpumask_t *mask);
259f0ba3d05SEyal Perry 	void (*release)(struct kref *ref);
260f0ba3d05SEyal Perry };
261f0ba3d05SEyal Perry 
2629cfef55bSMing Lei #define	IRQ_AFFINITY_MAX_SETS  4
2639cfef55bSMing Lei 
26420e407e1SChristoph Hellwig /**
26520e407e1SChristoph Hellwig  * struct irq_affinity - Description for automatic irq affinity assignements
26620e407e1SChristoph Hellwig  * @pre_vectors:	Don't apply affinity to @pre_vectors at beginning of
26720e407e1SChristoph Hellwig  *			the MSI(-X) vector space
26820e407e1SChristoph Hellwig  * @post_vectors:	Don't apply affinity to @post_vectors at end of
26920e407e1SChristoph Hellwig  *			the MSI(-X) vector space
2709cfef55bSMing Lei  * @nr_sets:		The number of interrupt sets for which affinity
2719cfef55bSMing Lei  *			spreading is required
2729cfef55bSMing Lei  * @set_size:		Array holding the size of each interrupt set
273c66d4bd1SMing Lei  * @calc_sets:		Callback for calculating the number and size
274c66d4bd1SMing Lei  *			of interrupt sets
275c66d4bd1SMing Lei  * @priv:		Private data for usage by @calc_sets, usually a
276c66d4bd1SMing Lei  *			pointer to driver/device specific data.
27720e407e1SChristoph Hellwig  */
27820e407e1SChristoph Hellwig struct irq_affinity {
2790145c30eSThomas Gleixner 	unsigned int	pre_vectors;
2800145c30eSThomas Gleixner 	unsigned int	post_vectors;
2810145c30eSThomas Gleixner 	unsigned int	nr_sets;
2829cfef55bSMing Lei 	unsigned int	set_size[IRQ_AFFINITY_MAX_SETS];
283c66d4bd1SMing Lei 	void		(*calc_sets)(struct irq_affinity *, unsigned int nvecs);
284c66d4bd1SMing Lei 	void		*priv;
28520e407e1SChristoph Hellwig };
28620e407e1SChristoph Hellwig 
287bec04037SDou Liyang /**
288bec04037SDou Liyang  * struct irq_affinity_desc - Interrupt affinity descriptor
289bec04037SDou Liyang  * @mask:	cpumask to hold the affinity assignment
29070921ae2SJonathan Corbet  * @is_managed: 1 if the interrupt is managed internally
291bec04037SDou Liyang  */
292bec04037SDou Liyang struct irq_affinity_desc {
293bec04037SDou Liyang 	struct cpumask	mask;
294c410abbbSDou Liyang 	unsigned int	is_managed : 1;
295bec04037SDou Liyang };
296bec04037SDou Liyang 
2970244ad00SMartin Schwidefsky #if defined(CONFIG_SMP)
298d7b90689SRussell King 
299d036e67bSRusty Russell extern cpumask_var_t irq_default_affinity;
30018404756SMax Krasnyansky 
30101f8fa4fSThomas Gleixner /* Internal implementation. Use the helpers below */
30201f8fa4fSThomas Gleixner extern int __irq_set_affinity(unsigned int irq, const struct cpumask *cpumask,
30301f8fa4fSThomas Gleixner 			      bool force);
30401f8fa4fSThomas Gleixner 
30501f8fa4fSThomas Gleixner /**
30601f8fa4fSThomas Gleixner  * irq_set_affinity - Set the irq affinity of a given irq
30701f8fa4fSThomas Gleixner  * @irq:	Interrupt to set affinity
308def5f127SRandy Dunlap  * @cpumask:	cpumask
30901f8fa4fSThomas Gleixner  *
31001f8fa4fSThomas Gleixner  * Fails if cpumask does not contain an online CPU
31101f8fa4fSThomas Gleixner  */
31201f8fa4fSThomas Gleixner static inline int
31301f8fa4fSThomas Gleixner irq_set_affinity(unsigned int irq, const struct cpumask *cpumask)
31401f8fa4fSThomas Gleixner {
31501f8fa4fSThomas Gleixner 	return __irq_set_affinity(irq, cpumask, false);
31601f8fa4fSThomas Gleixner }
31701f8fa4fSThomas Gleixner 
31801f8fa4fSThomas Gleixner /**
31901f8fa4fSThomas Gleixner  * irq_force_affinity - Force the irq affinity of a given irq
32001f8fa4fSThomas Gleixner  * @irq:	Interrupt to set affinity
321def5f127SRandy Dunlap  * @cpumask:	cpumask
32201f8fa4fSThomas Gleixner  *
32301f8fa4fSThomas Gleixner  * Same as irq_set_affinity, but without checking the mask against
32401f8fa4fSThomas Gleixner  * online cpus.
32501f8fa4fSThomas Gleixner  *
32601f8fa4fSThomas Gleixner  * Solely for low level cpu hotplug code, where we need to make per
32701f8fa4fSThomas Gleixner  * cpu interrupts affine before the cpu becomes online.
32801f8fa4fSThomas Gleixner  */
32901f8fa4fSThomas Gleixner static inline int
33001f8fa4fSThomas Gleixner irq_force_affinity(unsigned int irq, const struct cpumask *cpumask)
33101f8fa4fSThomas Gleixner {
33201f8fa4fSThomas Gleixner 	return __irq_set_affinity(irq, cpumask, true);
33301f8fa4fSThomas Gleixner }
33401f8fa4fSThomas Gleixner 
335d7b90689SRussell King extern int irq_can_set_affinity(unsigned int irq);
33618404756SMax Krasnyansky extern int irq_select_affinity(unsigned int irq);
337d7b90689SRussell King 
338e7a297b0SPeter P Waskiewicz Jr extern int irq_set_affinity_hint(unsigned int irq, const struct cpumask *m);
339cd7eab44SBen Hutchings 
340cd7eab44SBen Hutchings extern int
341cd7eab44SBen Hutchings irq_set_affinity_notifier(unsigned int irq, struct irq_affinity_notify *notify);
342cd7eab44SBen Hutchings 
343bec04037SDou Liyang struct irq_affinity_desc *
344c66d4bd1SMing Lei irq_create_affinity_masks(unsigned int nvec, struct irq_affinity *affd);
345bec04037SDou Liyang 
3460145c30eSThomas Gleixner unsigned int irq_calc_affinity_vectors(unsigned int minvec, unsigned int maxvec,
3470145c30eSThomas Gleixner 				       const struct irq_affinity *affd);
3485e385a6eSChristoph Hellwig 
349d7b90689SRussell King #else /* CONFIG_SMP */
350d7b90689SRussell King 
3510de26520SRusty Russell static inline int irq_set_affinity(unsigned int irq, const struct cpumask *m)
352d7b90689SRussell King {
353d7b90689SRussell King 	return -EINVAL;
354d7b90689SRussell King }
355d7b90689SRussell King 
3564c88d7f9SArnd Bergmann static inline int irq_force_affinity(unsigned int irq, const struct cpumask *cpumask)
3574c88d7f9SArnd Bergmann {
3584c88d7f9SArnd Bergmann 	return 0;
3594c88d7f9SArnd Bergmann }
3604c88d7f9SArnd Bergmann 
361d7b90689SRussell King static inline int irq_can_set_affinity(unsigned int irq)
362d7b90689SRussell King {
363d7b90689SRussell King 	return 0;
364d7b90689SRussell King }
365d7b90689SRussell King 
36618404756SMax Krasnyansky static inline int irq_select_affinity(unsigned int irq)  { return 0; }
36718404756SMax Krasnyansky 
368e7a297b0SPeter P Waskiewicz Jr static inline int irq_set_affinity_hint(unsigned int irq,
369e7a297b0SPeter P Waskiewicz Jr 					const struct cpumask *m)
370e7a297b0SPeter P Waskiewicz Jr {
371e7a297b0SPeter P Waskiewicz Jr 	return -EINVAL;
372e7a297b0SPeter P Waskiewicz Jr }
373f0ba3d05SEyal Perry 
374f0ba3d05SEyal Perry static inline int
375f0ba3d05SEyal Perry irq_set_affinity_notifier(unsigned int irq, struct irq_affinity_notify *notify)
376f0ba3d05SEyal Perry {
377f0ba3d05SEyal Perry 	return 0;
378f0ba3d05SEyal Perry }
3795e385a6eSChristoph Hellwig 
380bec04037SDou Liyang static inline struct irq_affinity_desc *
381c66d4bd1SMing Lei irq_create_affinity_masks(unsigned int nvec, struct irq_affinity *affd)
38234c3d981SThomas Gleixner {
38334c3d981SThomas Gleixner 	return NULL;
38434c3d981SThomas Gleixner }
38534c3d981SThomas Gleixner 
3860145c30eSThomas Gleixner static inline unsigned int
3870145c30eSThomas Gleixner irq_calc_affinity_vectors(unsigned int minvec, unsigned int maxvec,
3880145c30eSThomas Gleixner 			  const struct irq_affinity *affd)
38934c3d981SThomas Gleixner {
39034c3d981SThomas Gleixner 	return maxvec;
39134c3d981SThomas Gleixner }
39234c3d981SThomas Gleixner 
3930244ad00SMartin Schwidefsky #endif /* CONFIG_SMP */
394d7b90689SRussell King 
395c01d403bSIngo Molnar /*
396c01d403bSIngo Molnar  * Special lockdep variants of irq disabling/enabling.
397c01d403bSIngo Molnar  * These should be used for locking constructs that
398c01d403bSIngo Molnar  * know that a particular irq context which is disabled,
399c01d403bSIngo Molnar  * and which is the only irq-context user of a lock,
400c01d403bSIngo Molnar  * that it's safe to take the lock in the irq-disabled
401c01d403bSIngo Molnar  * section without disabling hardirqs.
402c01d403bSIngo Molnar  *
403c01d403bSIngo Molnar  * On !CONFIG_LOCKDEP they are equivalent to the normal
404c01d403bSIngo Molnar  * irq disable/enable methods.
405c01d403bSIngo Molnar  */
406c01d403bSIngo Molnar static inline void disable_irq_nosync_lockdep(unsigned int irq)
407c01d403bSIngo Molnar {
408c01d403bSIngo Molnar 	disable_irq_nosync(irq);
409c01d403bSIngo Molnar #ifdef CONFIG_LOCKDEP
410c01d403bSIngo Molnar 	local_irq_disable();
411c01d403bSIngo Molnar #endif
412c01d403bSIngo Molnar }
413c01d403bSIngo Molnar 
414e8106b94SArjan van de Ven static inline void disable_irq_nosync_lockdep_irqsave(unsigned int irq, unsigned long *flags)
415e8106b94SArjan van de Ven {
416e8106b94SArjan van de Ven 	disable_irq_nosync(irq);
417e8106b94SArjan van de Ven #ifdef CONFIG_LOCKDEP
418e8106b94SArjan van de Ven 	local_irq_save(*flags);
419e8106b94SArjan van de Ven #endif
420e8106b94SArjan van de Ven }
421e8106b94SArjan van de Ven 
422c01d403bSIngo Molnar static inline void disable_irq_lockdep(unsigned int irq)
423c01d403bSIngo Molnar {
424c01d403bSIngo Molnar 	disable_irq(irq);
425c01d403bSIngo Molnar #ifdef CONFIG_LOCKDEP
426c01d403bSIngo Molnar 	local_irq_disable();
427c01d403bSIngo Molnar #endif
428c01d403bSIngo Molnar }
429c01d403bSIngo Molnar 
430c01d403bSIngo Molnar static inline void enable_irq_lockdep(unsigned int irq)
431c01d403bSIngo Molnar {
432c01d403bSIngo Molnar #ifdef CONFIG_LOCKDEP
433c01d403bSIngo Molnar 	local_irq_enable();
434c01d403bSIngo Molnar #endif
435c01d403bSIngo Molnar 	enable_irq(irq);
436c01d403bSIngo Molnar }
437c01d403bSIngo Molnar 
438e8106b94SArjan van de Ven static inline void enable_irq_lockdep_irqrestore(unsigned int irq, unsigned long *flags)
439e8106b94SArjan van de Ven {
440e8106b94SArjan van de Ven #ifdef CONFIG_LOCKDEP
441e8106b94SArjan van de Ven 	local_irq_restore(*flags);
442e8106b94SArjan van de Ven #endif
443e8106b94SArjan van de Ven 	enable_irq(irq);
444e8106b94SArjan van de Ven }
445e8106b94SArjan van de Ven 
446ba9a2331SThomas Gleixner /* IRQ wakeup (PM) control: */
447a0cd9ca2SThomas Gleixner extern int irq_set_irq_wake(unsigned int irq, unsigned int on);
448a0cd9ca2SThomas Gleixner 
449ba9a2331SThomas Gleixner static inline int enable_irq_wake(unsigned int irq)
450ba9a2331SThomas Gleixner {
451a0cd9ca2SThomas Gleixner 	return irq_set_irq_wake(irq, 1);
452ba9a2331SThomas Gleixner }
453ba9a2331SThomas Gleixner 
454ba9a2331SThomas Gleixner static inline int disable_irq_wake(unsigned int irq)
455ba9a2331SThomas Gleixner {
456a0cd9ca2SThomas Gleixner 	return irq_set_irq_wake(irq, 0);
457ba9a2331SThomas Gleixner }
458ba9a2331SThomas Gleixner 
4591b7047edSMarc Zyngier /*
4601b7047edSMarc Zyngier  * irq_get_irqchip_state/irq_set_irqchip_state specific flags
4611b7047edSMarc Zyngier  */
4621b7047edSMarc Zyngier enum irqchip_irq_state {
4631b7047edSMarc Zyngier 	IRQCHIP_STATE_PENDING,		/* Is interrupt pending? */
4641b7047edSMarc Zyngier 	IRQCHIP_STATE_ACTIVE,		/* Is interrupt in progress? */
4651b7047edSMarc Zyngier 	IRQCHIP_STATE_MASKED,		/* Is interrupt masked? */
4661b7047edSMarc Zyngier 	IRQCHIP_STATE_LINE_LEVEL,	/* Is IRQ line high? */
4671b7047edSMarc Zyngier };
4681b7047edSMarc Zyngier 
4691b7047edSMarc Zyngier extern int irq_get_irqchip_state(unsigned int irq, enum irqchip_irq_state which,
4701b7047edSMarc Zyngier 				 bool *state);
4711b7047edSMarc Zyngier extern int irq_set_irqchip_state(unsigned int irq, enum irqchip_irq_state which,
4721b7047edSMarc Zyngier 				 bool state);
4738d32a307SThomas Gleixner 
4748d32a307SThomas Gleixner #ifdef CONFIG_IRQ_FORCED_THREADING
4758d32a307SThomas Gleixner extern bool force_irqthreads;
4768d32a307SThomas Gleixner #else
4778d32a307SThomas Gleixner #define force_irqthreads	(0)
4788d32a307SThomas Gleixner #endif
4798d32a307SThomas Gleixner 
4800fd7d862SFrederic Weisbecker #ifndef local_softirq_pending
4810fd7d862SFrederic Weisbecker 
4820fd7d862SFrederic Weisbecker #ifndef local_softirq_pending_ref
4830fd7d862SFrederic Weisbecker #define local_softirq_pending_ref irq_stat.__softirq_pending
4840fd7d862SFrederic Weisbecker #endif
4850fd7d862SFrederic Weisbecker 
4860fd7d862SFrederic Weisbecker #define local_softirq_pending()	(__this_cpu_read(local_softirq_pending_ref))
4870fd7d862SFrederic Weisbecker #define set_softirq_pending(x)	(__this_cpu_write(local_softirq_pending_ref, (x)))
4880fd7d862SFrederic Weisbecker #define or_softirq_pending(x)	(__this_cpu_or(local_softirq_pending_ref, (x)))
4890fd7d862SFrederic Weisbecker 
4900fd7d862SFrederic Weisbecker #endif /* local_softirq_pending */
4910fd7d862SFrederic Weisbecker 
4922d3fbbb3SBenjamin Herrenschmidt /* Some architectures might implement lazy enabling/disabling of
4932d3fbbb3SBenjamin Herrenschmidt  * interrupts. In some cases, such as stop_machine, we might want
4942d3fbbb3SBenjamin Herrenschmidt  * to ensure that after a local_irq_disable(), interrupts have
4952d3fbbb3SBenjamin Herrenschmidt  * really been disabled in hardware. Such architectures need to
4962d3fbbb3SBenjamin Herrenschmidt  * implement the following hook.
4972d3fbbb3SBenjamin Herrenschmidt  */
4982d3fbbb3SBenjamin Herrenschmidt #ifndef hard_irq_disable
4992d3fbbb3SBenjamin Herrenschmidt #define hard_irq_disable()	do { } while(0)
5002d3fbbb3SBenjamin Herrenschmidt #endif
5012d3fbbb3SBenjamin Herrenschmidt 
5021da177e4SLinus Torvalds /* PLEASE, avoid to allocate new softirqs, if you need not _really_ high
5031da177e4SLinus Torvalds    frequency threaded job scheduling. For almost all the purposes
5041da177e4SLinus Torvalds    tasklets are more than enough. F.e. all serial device BHs et
5051da177e4SLinus Torvalds    al. should be converted to tasklets, not to softirqs.
5061da177e4SLinus Torvalds  */
5071da177e4SLinus Torvalds 
5081da177e4SLinus Torvalds enum
5091da177e4SLinus Torvalds {
5101da177e4SLinus Torvalds 	HI_SOFTIRQ=0,
5111da177e4SLinus Torvalds 	TIMER_SOFTIRQ,
5121da177e4SLinus Torvalds 	NET_TX_SOFTIRQ,
5131da177e4SLinus Torvalds 	NET_RX_SOFTIRQ,
514ff856badSJens Axboe 	BLOCK_SOFTIRQ,
515511cbce2SChristoph Hellwig 	IRQ_POLL_SOFTIRQ,
516c9819f45SChristoph Lameter 	TASKLET_SOFTIRQ,
517c9819f45SChristoph Lameter 	SCHED_SOFTIRQ,
518c6eb3f70SThomas Gleixner 	HRTIMER_SOFTIRQ, /* Unused, but kept as tools rely on the
519c6eb3f70SThomas Gleixner 			    numbering. Sigh! */
52009223371SShaohua Li 	RCU_SOFTIRQ,    /* Preferable RCU should always be the last softirq */
521978b0116SAlexey Dobriyan 
522978b0116SAlexey Dobriyan 	NR_SOFTIRQS
5231da177e4SLinus Torvalds };
5241da177e4SLinus Torvalds 
525803b0ebaSPaul E. McKenney #define SOFTIRQ_STOP_IDLE_MASK (~(1 << RCU_SOFTIRQ))
526803b0ebaSPaul E. McKenney 
5275d592b44SJason Baron /* map softirq index to softirq name. update 'softirq_to_name' in
5285d592b44SJason Baron  * kernel/softirq.c when adding a new softirq.
5295d592b44SJason Baron  */
530ce85b4f2SJoe Perches extern const char * const softirq_to_name[NR_SOFTIRQS];
5315d592b44SJason Baron 
5321da177e4SLinus Torvalds /* softirq mask and active fields moved to irq_cpustat_t in
5331da177e4SLinus Torvalds  * asm/hardirq.h to get better cache usage.  KAO
5341da177e4SLinus Torvalds  */
5351da177e4SLinus Torvalds 
5361da177e4SLinus Torvalds struct softirq_action
5371da177e4SLinus Torvalds {
5381da177e4SLinus Torvalds 	void	(*action)(struct softirq_action *);
5391da177e4SLinus Torvalds };
5401da177e4SLinus Torvalds 
5411da177e4SLinus Torvalds asmlinkage void do_softirq(void);
542eb0f1c44SAdrian Bunk asmlinkage void __do_softirq(void);
5437d65f4a6SFrederic Weisbecker 
5447d65f4a6SFrederic Weisbecker #ifdef __ARCH_HAS_DO_SOFTIRQ
5457d65f4a6SFrederic Weisbecker void do_softirq_own_stack(void);
5467d65f4a6SFrederic Weisbecker #else
5477d65f4a6SFrederic Weisbecker static inline void do_softirq_own_stack(void)
5487d65f4a6SFrederic Weisbecker {
5497d65f4a6SFrederic Weisbecker 	__do_softirq();
5507d65f4a6SFrederic Weisbecker }
5517d65f4a6SFrederic Weisbecker #endif
5527d65f4a6SFrederic Weisbecker 
553962cf36cSCarlos R. Mafra extern void open_softirq(int nr, void (*action)(struct softirq_action *));
5541da177e4SLinus Torvalds extern void softirq_init(void);
555f069686eSSteven Rostedt extern void __raise_softirq_irqoff(unsigned int nr);
5562bf2160dSLai Jiangshan 
557b3c97528SHarvey Harrison extern void raise_softirq_irqoff(unsigned int nr);
558b3c97528SHarvey Harrison extern void raise_softirq(unsigned int nr);
5591da177e4SLinus Torvalds 
5604dd53d89SVenkatesh Pallipadi DECLARE_PER_CPU(struct task_struct *, ksoftirqd);
5614dd53d89SVenkatesh Pallipadi 
5624dd53d89SVenkatesh Pallipadi static inline struct task_struct *this_cpu_ksoftirqd(void)
5634dd53d89SVenkatesh Pallipadi {
5644dd53d89SVenkatesh Pallipadi 	return this_cpu_read(ksoftirqd);
5654dd53d89SVenkatesh Pallipadi }
5664dd53d89SVenkatesh Pallipadi 
5671da177e4SLinus Torvalds /* Tasklets --- multithreaded analogue of BHs.
5681da177e4SLinus Torvalds 
5691da177e4SLinus Torvalds    Main feature differing them of generic softirqs: tasklet
5701da177e4SLinus Torvalds    is running only on one CPU simultaneously.
5711da177e4SLinus Torvalds 
5721da177e4SLinus Torvalds    Main feature differing them of BHs: different tasklets
5731da177e4SLinus Torvalds    may be run simultaneously on different CPUs.
5741da177e4SLinus Torvalds 
5751da177e4SLinus Torvalds    Properties:
5761da177e4SLinus Torvalds    * If tasklet_schedule() is called, then tasklet is guaranteed
5771da177e4SLinus Torvalds      to be executed on some cpu at least once after this.
57825985edcSLucas De Marchi    * If the tasklet is already scheduled, but its execution is still not
5791da177e4SLinus Torvalds      started, it will be executed only once.
5801da177e4SLinus Torvalds    * If this tasklet is already running on another CPU (or schedule is called
5811da177e4SLinus Torvalds      from tasklet itself), it is rescheduled for later.
5821da177e4SLinus Torvalds    * Tasklet is strictly serialized wrt itself, but not
5831da177e4SLinus Torvalds      wrt another tasklets. If client needs some intertask synchronization,
5841da177e4SLinus Torvalds      he makes it with spinlocks.
5851da177e4SLinus Torvalds  */
5861da177e4SLinus Torvalds 
5871da177e4SLinus Torvalds struct tasklet_struct
5881da177e4SLinus Torvalds {
5891da177e4SLinus Torvalds 	struct tasklet_struct *next;
5901da177e4SLinus Torvalds 	unsigned long state;
5911da177e4SLinus Torvalds 	atomic_t count;
5921da177e4SLinus Torvalds 	void (*func)(unsigned long);
5931da177e4SLinus Torvalds 	unsigned long data;
5941da177e4SLinus Torvalds };
5951da177e4SLinus Torvalds 
5961da177e4SLinus Torvalds #define DECLARE_TASKLET(name, func, data) \
5971da177e4SLinus Torvalds struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(0), func, data }
5981da177e4SLinus Torvalds 
5991da177e4SLinus Torvalds #define DECLARE_TASKLET_DISABLED(name, func, data) \
6001da177e4SLinus Torvalds struct tasklet_struct name = { NULL, 0, ATOMIC_INIT(1), func, data }
6011da177e4SLinus Torvalds 
6021da177e4SLinus Torvalds 
6031da177e4SLinus Torvalds enum
6041da177e4SLinus Torvalds {
6051da177e4SLinus Torvalds 	TASKLET_STATE_SCHED,	/* Tasklet is scheduled for execution */
6061da177e4SLinus Torvalds 	TASKLET_STATE_RUN	/* Tasklet is running (SMP only) */
6071da177e4SLinus Torvalds };
6081da177e4SLinus Torvalds 
6091da177e4SLinus Torvalds #ifdef CONFIG_SMP
6101da177e4SLinus Torvalds static inline int tasklet_trylock(struct tasklet_struct *t)
6111da177e4SLinus Torvalds {
6121da177e4SLinus Torvalds 	return !test_and_set_bit(TASKLET_STATE_RUN, &(t)->state);
6131da177e4SLinus Torvalds }
6141da177e4SLinus Torvalds 
6151da177e4SLinus Torvalds static inline void tasklet_unlock(struct tasklet_struct *t)
6161da177e4SLinus Torvalds {
6174e857c58SPeter Zijlstra 	smp_mb__before_atomic();
6181da177e4SLinus Torvalds 	clear_bit(TASKLET_STATE_RUN, &(t)->state);
6191da177e4SLinus Torvalds }
6201da177e4SLinus Torvalds 
6211da177e4SLinus Torvalds static inline void tasklet_unlock_wait(struct tasklet_struct *t)
6221da177e4SLinus Torvalds {
6231da177e4SLinus Torvalds 	while (test_bit(TASKLET_STATE_RUN, &(t)->state)) { barrier(); }
6241da177e4SLinus Torvalds }
6251da177e4SLinus Torvalds #else
6261da177e4SLinus Torvalds #define tasklet_trylock(t) 1
6271da177e4SLinus Torvalds #define tasklet_unlock_wait(t) do { } while (0)
6281da177e4SLinus Torvalds #define tasklet_unlock(t) do { } while (0)
6291da177e4SLinus Torvalds #endif
6301da177e4SLinus Torvalds 
631b3c97528SHarvey Harrison extern void __tasklet_schedule(struct tasklet_struct *t);
6321da177e4SLinus Torvalds 
6331da177e4SLinus Torvalds static inline void tasklet_schedule(struct tasklet_struct *t)
6341da177e4SLinus Torvalds {
6351da177e4SLinus Torvalds 	if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
6361da177e4SLinus Torvalds 		__tasklet_schedule(t);
6371da177e4SLinus Torvalds }
6381da177e4SLinus Torvalds 
639b3c97528SHarvey Harrison extern void __tasklet_hi_schedule(struct tasklet_struct *t);
6401da177e4SLinus Torvalds 
6411da177e4SLinus Torvalds static inline void tasklet_hi_schedule(struct tasklet_struct *t)
6421da177e4SLinus Torvalds {
6431da177e4SLinus Torvalds 	if (!test_and_set_bit(TASKLET_STATE_SCHED, &t->state))
6441da177e4SLinus Torvalds 		__tasklet_hi_schedule(t);
6451da177e4SLinus Torvalds }
6461da177e4SLinus Torvalds 
6471da177e4SLinus Torvalds static inline void tasklet_disable_nosync(struct tasklet_struct *t)
6481da177e4SLinus Torvalds {
6491da177e4SLinus Torvalds 	atomic_inc(&t->count);
6504e857c58SPeter Zijlstra 	smp_mb__after_atomic();
6511da177e4SLinus Torvalds }
6521da177e4SLinus Torvalds 
6531da177e4SLinus Torvalds static inline void tasklet_disable(struct tasklet_struct *t)
6541da177e4SLinus Torvalds {
6551da177e4SLinus Torvalds 	tasklet_disable_nosync(t);
6561da177e4SLinus Torvalds 	tasklet_unlock_wait(t);
6571da177e4SLinus Torvalds 	smp_mb();
6581da177e4SLinus Torvalds }
6591da177e4SLinus Torvalds 
6601da177e4SLinus Torvalds static inline void tasklet_enable(struct tasklet_struct *t)
6611da177e4SLinus Torvalds {
6624e857c58SPeter Zijlstra 	smp_mb__before_atomic();
6631da177e4SLinus Torvalds 	atomic_dec(&t->count);
6641da177e4SLinus Torvalds }
6651da177e4SLinus Torvalds 
6661da177e4SLinus Torvalds extern void tasklet_kill(struct tasklet_struct *t);
6671da177e4SLinus Torvalds extern void tasklet_kill_immediate(struct tasklet_struct *t, unsigned int cpu);
6681da177e4SLinus Torvalds extern void tasklet_init(struct tasklet_struct *t,
6691da177e4SLinus Torvalds 			 void (*func)(unsigned long), unsigned long data);
6701da177e4SLinus Torvalds 
6711da177e4SLinus Torvalds /*
6721da177e4SLinus Torvalds  * Autoprobing for irqs:
6731da177e4SLinus Torvalds  *
6741da177e4SLinus Torvalds  * probe_irq_on() and probe_irq_off() provide robust primitives
6751da177e4SLinus Torvalds  * for accurate IRQ probing during kernel initialization.  They are
6761da177e4SLinus Torvalds  * reasonably simple to use, are not "fooled" by spurious interrupts,
6771da177e4SLinus Torvalds  * and, unlike other attempts at IRQ probing, they do not get hung on
6781da177e4SLinus Torvalds  * stuck interrupts (such as unused PS2 mouse interfaces on ASUS boards).
6791da177e4SLinus Torvalds  *
6801da177e4SLinus Torvalds  * For reasonably foolproof probing, use them as follows:
6811da177e4SLinus Torvalds  *
6821da177e4SLinus Torvalds  * 1. clear and/or mask the device's internal interrupt.
6831da177e4SLinus Torvalds  * 2. sti();
6841da177e4SLinus Torvalds  * 3. irqs = probe_irq_on();      // "take over" all unassigned idle IRQs
6851da177e4SLinus Torvalds  * 4. enable the device and cause it to trigger an interrupt.
6861da177e4SLinus Torvalds  * 5. wait for the device to interrupt, using non-intrusive polling or a delay.
6871da177e4SLinus Torvalds  * 6. irq = probe_irq_off(irqs);  // get IRQ number, 0=none, negative=multiple
6881da177e4SLinus Torvalds  * 7. service the device to clear its pending interrupt.
6891da177e4SLinus Torvalds  * 8. loop again if paranoia is required.
6901da177e4SLinus Torvalds  *
6911da177e4SLinus Torvalds  * probe_irq_on() returns a mask of allocated irq's.
6921da177e4SLinus Torvalds  *
6931da177e4SLinus Torvalds  * probe_irq_off() takes the mask as a parameter,
6941da177e4SLinus Torvalds  * and returns the irq number which occurred,
6951da177e4SLinus Torvalds  * or zero if none occurred, or a negative irq number
6961da177e4SLinus Torvalds  * if more than one irq occurred.
6971da177e4SLinus Torvalds  */
6981da177e4SLinus Torvalds 
6990244ad00SMartin Schwidefsky #if !defined(CONFIG_GENERIC_IRQ_PROBE)
7001da177e4SLinus Torvalds static inline unsigned long probe_irq_on(void)
7011da177e4SLinus Torvalds {
7021da177e4SLinus Torvalds 	return 0;
7031da177e4SLinus Torvalds }
7041da177e4SLinus Torvalds static inline int probe_irq_off(unsigned long val)
7051da177e4SLinus Torvalds {
7061da177e4SLinus Torvalds 	return 0;
7071da177e4SLinus Torvalds }
7081da177e4SLinus Torvalds static inline unsigned int probe_irq_mask(unsigned long val)
7091da177e4SLinus Torvalds {
7101da177e4SLinus Torvalds 	return 0;
7111da177e4SLinus Torvalds }
7121da177e4SLinus Torvalds #else
7131da177e4SLinus Torvalds extern unsigned long probe_irq_on(void);	/* returns 0 on failure */
7141da177e4SLinus Torvalds extern int probe_irq_off(unsigned long);	/* returns 0 or negative on failure */
7151da177e4SLinus Torvalds extern unsigned int probe_irq_mask(unsigned long);	/* returns mask of ISA interrupts */
7161da177e4SLinus Torvalds #endif
7171da177e4SLinus Torvalds 
7186168a702SAndrew Morton #ifdef CONFIG_PROC_FS
7196168a702SAndrew Morton /* Initialize /proc/irq/ */
7206168a702SAndrew Morton extern void init_irq_proc(void);
7216168a702SAndrew Morton #else
7226168a702SAndrew Morton static inline void init_irq_proc(void)
7236168a702SAndrew Morton {
7246168a702SAndrew Morton }
7256168a702SAndrew Morton #endif
7266168a702SAndrew Morton 
727b2d3d61aSDaniel Lezcano #ifdef CONFIG_IRQ_TIMINGS
728b2d3d61aSDaniel Lezcano void irq_timings_enable(void);
729b2d3d61aSDaniel Lezcano void irq_timings_disable(void);
730e1c92149SDaniel Lezcano u64 irq_timings_next_event(u64 now);
731b2d3d61aSDaniel Lezcano #endif
732b2d3d61aSDaniel Lezcano 
733d43c36dcSAlexey Dobriyan struct seq_file;
734f74596d0SAdrian Bunk int show_interrupts(struct seq_file *p, void *v);
735c78b9b65SThomas Gleixner int arch_show_interrupts(struct seq_file *p, int prec);
736f74596d0SAdrian Bunk 
73743a25632SYinghai Lu extern int early_irq_init(void);
7384a046d17SYinghai Lu extern int arch_probe_nr_irqs(void);
73943a25632SYinghai Lu extern int arch_early_irq_init(void);
74043a25632SYinghai Lu 
741be7635e7SAlexander Potapenko /*
742be7635e7SAlexander Potapenko  * We want to know which function is an entrypoint of a hardirq or a softirq.
743be7635e7SAlexander Potapenko  */
744be7635e7SAlexander Potapenko #define __irq_entry		 __attribute__((__section__(".irqentry.text")))
745be7635e7SAlexander Potapenko #define __softirq_entry  \
746be7635e7SAlexander Potapenko 	__attribute__((__section__(".softirqentry.text")))
747be7635e7SAlexander Potapenko 
7481da177e4SLinus Torvalds #endif
749