[deliverable/linux.git] / include / linux / irq.h

#ifndef _LINUX_IRQ_H
#define _LINUX_IRQ_H

/*
 * Please do not include this file in generic code.  There is currently
 * no requirement for any architecture to implement anything held
 * within this file.
 *
 * Thanks. --rmk
 */

#include <linux/smp.h>

#ifndef CONFIG_S390

#include <linux/linkage.h>
#include <linux/cache.h>
#include <linux/spinlock.h>
#include <linux/cpumask.h>
#include <linux/gfp.h>
#include <linux/irqreturn.h>
#include <linux/irqnr.h>
#include <linux/errno.h>
#include <linux/topology.h>
#include <linux/wait.h>

#include <asm/irq.h>
#include <asm/ptrace.h>
#include <asm/irq_regs.h>

struct irq_desc;
typedef	void (*irq_flow_handler_t)(unsigned int irq,
					    struct irq_desc *desc);


/*
 * IRQ line status.
 *
 * Bits 0-7 are reserved for the IRQF_* bits in linux/interrupt.h
 *
 * IRQ types
 */
#define IRQ_TYPE_NONE		0x00000000	/* Default, unspecified type */
#define IRQ_TYPE_EDGE_RISING	0x00000001	/* Edge rising type */
#define IRQ_TYPE_EDGE_FALLING	0x00000002	/* Edge falling type */
#define IRQ_TYPE_EDGE_BOTH (IRQ_TYPE_EDGE_FALLING | IRQ_TYPE_EDGE_RISING)
#define IRQ_TYPE_LEVEL_HIGH	0x00000004	/* Level high type */
#define IRQ_TYPE_LEVEL_LOW	0x00000008	/* Level low type */
#define IRQ_TYPE_SENSE_MASK	0x0000000f	/* Mask of the above */
#define IRQ_TYPE_PROBE		0x00000010	/* Probing in progress */

/* Internal flags */

#ifndef CONFIG_GENERIC_HARDIRQS_NO_COMPAT
#define IRQ_INPROGRESS		0x00000100	/* DEPRECATED */
#define IRQ_REPLAY		0x00000200	/* DEPRECATED */
#define IRQ_WAITING		0x00000400	/* DEPRECATED */
#define IRQ_DISABLED		0x00000800	/* DEPRECATED */
#define IRQ_PENDING		0x00001000	/* DEPRECATED */
#define IRQ_MASKED		0x00002000	/* DEPRECATED */
/* DEPRECATED use irq_setaffinity_pending() instead*/
#define IRQ_MOVE_PENDING	0x00004000
#endif

#define IRQ_LEVEL		0x00008000	/* IRQ level triggered */
#define IRQ_PER_CPU		0x00010000	/* IRQ is per CPU */
#define IRQ_NOPROBE		0x00020000	/* IRQ is not valid for probing */
#define IRQ_NOREQUEST		0x00040000	/* IRQ cannot be requested */
#define IRQ_NOAUTOEN		0x00080000	/* IRQ will not be enabled on request irq */
#define IRQ_WAKEUP		0x00100000	/* IRQ triggers system wakeup */
#define IRQ_NO_BALANCING	0x00400000	/* IRQ is excluded from balancing */
#define IRQ_MOVE_PCNTXT		0x01000000	/* IRQ migration from process context */
#define IRQ_AFFINITY_SET	0x02000000	/* IRQ affinity was set from userspace*/
#define IRQ_NESTED_THREAD	0x10000000	/* IRQ is nested into another, no own handler thread */

#define IRQF_MODIFY_MASK	\
	(IRQ_TYPE_SENSE_MASK | IRQ_NOPROBE | IRQ_NOREQUEST | \
	 IRQ_NOAUTOEN | IRQ_MOVE_PCNTXT | IRQ_LEVEL | IRQ_NO_BALANCING | \
	 IRQ_PER_CPU | IRQ_NESTED_THREAD)

#define IRQ_NO_BALANCING_MASK	(IRQ_PER_CPU | IRQ_NO_BALANCING)

static inline __deprecated bool CHECK_IRQ_PER_CPU(unsigned int status)
{
	return status & IRQ_PER_CPU;
}

/*
 * Return value for chip->irq_set_affinity()
 *
 * IRQ_SET_MASK_OK	- OK, core updates irq_data.affinity
 * IRQ_SET_MASK_NOCPY	- OK, chip did update irq_data.affinity
 */
enum {
	IRQ_SET_MASK_OK = 0,
	IRQ_SET_MASK_OK_NOCOPY,
};

struct msi_desc;

/**
 * struct irq_data - per irq and irq chip data passed down to chip functions
 * @irq:		interrupt number
 * @node:		node index useful for balancing
 * @state_use_accessor: status information for irq chip functions.
 *			Use accessor functions to deal with it
 * @chip:		low level interrupt hardware access
 * @handler_data:	per-IRQ data for the irq_chip methods
 * @chip_data:		platform-specific per-chip private data for the chip
 *			methods, to allow shared chip implementations
 * @msi_desc:		MSI descriptor
 * @affinity:		IRQ affinity on SMP
 *
 * The fields here need to overlay the ones in irq_desc until we
 * cleaned up the direct references and switched everything over to
 * irq_data.
 */
struct irq_data {
	unsigned int		irq;
	unsigned int		node;
	unsigned int		state_use_accessors;
	struct irq_chip		*chip;
	void			*handler_data;
	void			*chip_data;
	struct msi_desc		*msi_desc;
#ifdef CONFIG_SMP
	cpumask_var_t		affinity;
#endif
};

/*
 * Bit masks for irq_data.state
 *
 * IRQD_SETAFFINITY_PENDING	- Affinity setting is pending
 */
enum {
	/* Bit 0 - 7 reserved for TYPE will use later */
	IRQD_SETAFFINITY_PENDING = (1 << 8),
};

static inline bool irqd_is_setaffinity_pending(struct irq_data *d)
{
	return d->state_use_accessors & IRQD_SETAFFINITY_PENDING;
}

/**
 * struct irq_chip - hardware interrupt chip descriptor
 *
 * @name:		name for /proc/interrupts
 * @startup:		deprecated, replaced by irq_startup
 * @shutdown:		deprecated, replaced by irq_shutdown
 * @enable:		deprecated, replaced by irq_enable
 * @disable:		deprecated, replaced by irq_disable
 * @ack:		deprecated, replaced by irq_ack
 * @mask:		deprecated, replaced by irq_mask
 * @mask_ack:		deprecated, replaced by irq_mask_ack
 * @unmask:		deprecated, replaced by irq_unmask
 * @eoi:		deprecated, replaced by irq_eoi
 * @end:		deprecated, will go away with __do_IRQ()
 * @set_affinity:	deprecated, replaced by irq_set_affinity
 * @retrigger:		deprecated, replaced by irq_retrigger
 * @set_type:		deprecated, replaced by irq_set_type
 * @set_wake:		deprecated, replaced by irq_wake
 * @bus_lock:		deprecated, replaced by irq_bus_lock
 * @bus_sync_unlock:	deprecated, replaced by irq_bus_sync_unlock
 *
 * @irq_startup:	start up the interrupt (defaults to ->enable if NULL)
 * @irq_shutdown:	shut down the interrupt (defaults to ->disable if NULL)
 * @irq_enable:		enable the interrupt (defaults to chip->unmask if NULL)
 * @irq_disable:	disable the interrupt
 * @irq_ack:		start of a new interrupt
 * @irq_mask:		mask an interrupt source
 * @irq_mask_ack:	ack and mask an interrupt source
 * @irq_unmask:		unmask an interrupt source
 * @irq_eoi:		end of interrupt
 * @irq_set_affinity:	set the CPU affinity on SMP machines
 * @irq_retrigger:	resend an IRQ to the CPU
 * @irq_set_type:	set the flow type (IRQ_TYPE_LEVEL/etc.) of an IRQ
 * @irq_set_wake:	enable/disable power-management wake-on of an IRQ
 * @irq_bus_lock:	function to lock access to slow bus (i2c) chips
 * @irq_bus_sync_unlock:function to sync and unlock slow bus (i2c) chips
 *
 * @release:		release function solely used by UML
 */
struct irq_chip {
	const char	*name;
#ifndef CONFIG_GENERIC_HARDIRQS_NO_DEPRECATED
	unsigned int	(*startup)(unsigned int irq);
	void		(*shutdown)(unsigned int irq);
	void		(*enable)(unsigned int irq);
	void		(*disable)(unsigned int irq);

	void		(*ack)(unsigned int irq);
	void		(*mask)(unsigned int irq);
	void		(*mask_ack)(unsigned int irq);
	void		(*unmask)(unsigned int irq);
	void		(*eoi)(unsigned int irq);

	void		(*end)(unsigned int irq);
	int		(*set_affinity)(unsigned int irq,
					const struct cpumask *dest);
	int		(*retrigger)(unsigned int irq);
	int		(*set_type)(unsigned int irq, unsigned int flow_type);
	int		(*set_wake)(unsigned int irq, unsigned int on);

	void		(*bus_lock)(unsigned int irq);
	void		(*bus_sync_unlock)(unsigned int irq);
#endif
	unsigned int	(*irq_startup)(struct irq_data *data);
	void		(*irq_shutdown)(struct irq_data *data);
	void		(*irq_enable)(struct irq_data *data);
	void		(*irq_disable)(struct irq_data *data);

	void		(*irq_ack)(struct irq_data *data);
	void		(*irq_mask)(struct irq_data *data);
	void		(*irq_mask_ack)(struct irq_data *data);
	void		(*irq_unmask)(struct irq_data *data);
	void		(*irq_eoi)(struct irq_data *data);

	int		(*irq_set_affinity)(struct irq_data *data, const struct cpumask *dest, bool force);
	int		(*irq_retrigger)(struct irq_data *data);
	int		(*irq_set_type)(struct irq_data *data, unsigned int flow_type);
	int		(*irq_set_wake)(struct irq_data *data, unsigned int on);

	void		(*irq_bus_lock)(struct irq_data *data);
	void		(*irq_bus_sync_unlock)(struct irq_data *data);

	/* Currently used only by UML, might disappear one day.*/
#ifdef CONFIG_IRQ_RELEASE_METHOD
	void		(*release)(unsigned int irq, void *dev_id);
#endif
};

/* This include will go away once we isolated irq_desc usage to core code */
#include <linux/irqdesc.h>

/*
 * Pick up the arch-dependent methods:
 */
#include <asm/hw_irq.h>

#ifndef NR_IRQS_LEGACY
# define NR_IRQS_LEGACY 0
#endif

#ifndef ARCH_IRQ_INIT_FLAGS
# define ARCH_IRQ_INIT_FLAGS	0
#endif

#define IRQ_DEFAULT_INIT_FLAGS	ARCH_IRQ_INIT_FLAGS

struct irqaction;
extern int setup_irq(unsigned int irq, struct irqaction *new);
extern void remove_irq(unsigned int irq, struct irqaction *act);

#ifdef CONFIG_GENERIC_HARDIRQS

#if defined(CONFIG_SMP) && defined(CONFIG_GENERIC_PENDING_IRQ)
void move_native_irq(int irq);
void move_masked_irq(int irq);
#else
static inline void move_native_irq(int irq) { }
static inline void move_masked_irq(int irq) { }
#endif

extern int no_irq_affinity;

/* Handle irq action chains: */
extern irqreturn_t handle_IRQ_event(unsigned int irq, struct irqaction *action);

/*
 * Built-in IRQ handlers for various IRQ types,
 * callable via desc->handle_irq()
 */
extern void handle_level_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_fasteoi_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_edge_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_simple_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_percpu_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_bad_irq(unsigned int irq, struct irq_desc *desc);
extern void handle_nested_irq(unsigned int irq);

/* Handling of unhandled and spurious interrupts: */
extern void note_interrupt(unsigned int irq, struct irq_desc *desc,
			   irqreturn_t action_ret);


/* Enable/disable irq debugging output: */
extern int noirqdebug_setup(char *str);

/* Checks whether the interrupt can be requested by request_irq(): */
extern int can_request_irq(unsigned int irq, unsigned long irqflags);

/* Dummy irq-chip implementations: */
extern struct irq_chip no_irq_chip;
extern struct irq_chip dummy_irq_chip;

extern void
set_irq_chip_and_handler(unsigned int irq, struct irq_chip *chip,
			 irq_flow_handler_t handle);
extern void
set_irq_chip_and_handler_name(unsigned int irq, struct irq_chip *chip,
			      irq_flow_handler_t handle, const char *name);

extern void
__set_irq_handler(unsigned int irq, irq_flow_handler_t handle, int is_chained,
		  const char *name);

/*
 * Set a highlevel flow handler for a given IRQ:
 */
static inline void
set_irq_handler(unsigned int irq, irq_flow_handler_t handle)
{
	__set_irq_handler(irq, handle, 0, NULL);
}

/*
 * Set a highlevel chained flow handler for a given IRQ.
 * (a chained handler is automatically enabled and set to
 *  IRQ_NOREQUEST and IRQ_NOPROBE)
 */
static inline void
set_irq_chained_handler(unsigned int irq, irq_flow_handler_t handle)
{
	__set_irq_handler(irq, handle, 1, NULL);
}

void irq_modify_status(unsigned int irq, unsigned long clr, unsigned long set);

static inline void irq_set_status_flags(unsigned int irq, unsigned long set)
{
	irq_modify_status(irq, 0, set);
}

static inline void irq_clear_status_flags(unsigned int irq, unsigned long clr)
{
	irq_modify_status(irq, clr, 0);
}

static inline void irq_set_noprobe(unsigned int irq)
{
	irq_modify_status(irq, 0, IRQ_NOPROBE);
}

static inline void irq_set_probe(unsigned int irq)
{
	irq_modify_status(irq, IRQ_NOPROBE, 0);
}

static inline void irq_set_nested_thread(unsigned int irq, bool nest)
{
	if (nest)
		irq_set_status_flags(irq, IRQ_NESTED_THREAD);
	else
		irq_clear_status_flags(irq, IRQ_NESTED_THREAD);
}

/* Handle dynamic irq creation and destruction */
extern unsigned int create_irq_nr(unsigned int irq_want, int node);
extern int create_irq(void);
extern void destroy_irq(unsigned int irq);

/*
 * Dynamic irq helper functions. Obsolete. Use irq_alloc_desc* and
 * irq_free_desc instead.
 */
extern void dynamic_irq_cleanup(unsigned int irq);
static inline void dynamic_irq_init(unsigned int irq)
{
	dynamic_irq_cleanup(irq);
}

/* Set/get chip/data for an IRQ: */
extern int irq_set_chip(unsigned int irq, struct irq_chip *chip);
extern int irq_set_handler_data(unsigned int irq, void *data);
extern int irq_set_chip_data(unsigned int irq, void *data);
extern int irq_set_irq_type(unsigned int irq, unsigned int type);
extern int irq_set_msi_desc(unsigned int irq, struct msi_desc *entry);
extern struct irq_data *irq_get_irq_data(unsigned int irq);

static inline struct irq_chip *irq_get_chip(unsigned int irq)
{
	struct irq_data *d = irq_get_irq_data(irq);
	return d ? d->chip : NULL;
}

static inline struct irq_chip *irq_data_get_irq_chip(struct irq_data *d)
{
	return d->chip;
}

static inline void *irq_get_chip_data(unsigned int irq)
{
	struct irq_data *d = irq_get_irq_data(irq);
	return d ? d->chip_data : NULL;
}

static inline void *irq_data_get_irq_chip_data(struct irq_data *d)
{
	return d->chip_data;
}

static inline void *irq_get_handler_data(unsigned int irq)
{
	struct irq_data *d = irq_get_irq_data(irq);
	return d ? d->handler_data : NULL;
}

static inline void *irq_data_get_irq_handler_data(struct irq_data *d)
{
	return d->handler_data;
}

static inline struct msi_desc *irq_get_msi_desc(unsigned int irq)
{
	struct irq_data *d = irq_get_irq_data(irq);
	return d ? d->msi_desc : NULL;
}

static inline struct msi_desc *irq_data_get_msi(struct irq_data *d)
{
	return d->msi_desc;
}

#ifndef CONFIG_GENERIC_HARDIRQS_NO_COMPAT
/* Please do not use: Use the replacement functions instead */
static inline int set_irq_chip(unsigned int irq, struct irq_chip *chip)
{
	return irq_set_chip(irq, chip);
}
static inline int set_irq_data(unsigned int irq, void *data)
{
	return irq_set_handler_data(irq, data);
}
static inline int set_irq_chip_data(unsigned int irq, void *data)
{
	return irq_set_chip_data(irq, data);
}
static inline int set_irq_type(unsigned int irq, unsigned int type)
{
	return irq_set_irq_type(irq, type);
}
static inline int set_irq_msi(unsigned int irq, struct msi_desc *entry)
{
	return irq_set_msi_desc(irq, entry);
}
static inline struct irq_chip *get_irq_chip(unsigned int irq)
{
	return irq_get_chip(irq);
}
static inline void *get_irq_chip_data(unsigned int irq)
{
	return irq_get_chip_data(irq);
}
static inline void *get_irq_data(unsigned int irq)
{
	return irq_get_handler_data(irq);
}
static inline void *irq_data_get_irq_data(struct irq_data *d)
{
	return irq_data_get_irq_handler_data(d);
}
static inline struct msi_desc *get_irq_msi(unsigned int irq)
{
	return irq_get_msi_desc(irq);
}
static inline void set_irq_noprobe(unsigned int irq)
{
	irq_set_noprobe(irq);
}
static inline void set_irq_probe(unsigned int irq)
{
	irq_set_probe(irq);
}
static inline void set_irq_nested_thread(unsigned int irq, int nest)
{
	irq_set_nested_thread(irq, nest);
}
#endif

int irq_alloc_descs(int irq, unsigned int from, unsigned int cnt, int node);
void irq_free_descs(unsigned int irq, unsigned int cnt);
int irq_reserve_irqs(unsigned int from, unsigned int cnt);

static inline int irq_alloc_desc(int node)
{
	return irq_alloc_descs(-1, 0, 1, node);
}

static inline int irq_alloc_desc_at(unsigned int at, int node)
{
	return irq_alloc_descs(at, at, 1, node);
}

static inline int irq_alloc_desc_from(unsigned int from, int node)
{
	return irq_alloc_descs(-1, from, 1, node);
}

static inline void irq_free_desc(unsigned int irq)
{
	irq_free_descs(irq, 1);
}

static inline int irq_reserve_irq(unsigned int irq)
{
	return irq_reserve_irqs(irq, 1);
}

#endif /* CONFIG_GENERIC_HARDIRQS */

#endif /* !CONFIG_S390 */

#endif /* _LINUX_IRQ_H */
Commit	Line	Data
06fcb0c6 IM	1	#ifndef _LINUX_IRQ_H
06fcb0c6 IM	2	#define _LINUX_IRQ_H
1da177e4 LT	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
23f9b317	12	#include <linux/smp.h>
1da177e4	13
06fcb0c6	14	#ifndef CONFIG_S390
1da177e4 LT	15
	16	#include <linux/linkage.h>
	17	#include <linux/cache.h>
	18	#include <linux/spinlock.h>
	19	#include <linux/cpumask.h>
503e5763	20	#include <linux/gfp.h>
908dcecd	21	#include <linux/irqreturn.h>
dd3a1db9	22	#include <linux/irqnr.h>
77904fd6	23	#include <linux/errno.h>
503e5763	24	#include <linux/topology.h>
3aa551c9	25	#include <linux/wait.h>
1da177e4 LT	26
	27	#include <asm/irq.h>
	28	#include <asm/ptrace.h>
7d12e780	29	#include <asm/irq_regs.h>
1da177e4	30
57a58a94	31	struct irq_desc;
ec701584	32	typedef void (*irq_flow_handler_t)(unsigned int irq,
7d12e780	33	struct irq_desc *desc);
57a58a94 DH	34
57a58a94 DH	35
1da177e4 LT	36	/*
1da177e4 LT	37	* IRQ line status.
6e213616	38	*
950f4427	39	* Bits 0-7 are reserved for the IRQF_* bits in linux/interrupt.h
6e213616 TG	40	*
6e213616 TG	41	* IRQ types
1da177e4	42	*/
6e213616 TG	43	#define IRQ_TYPE_NONE 0x00000000 /* Default, unspecified type */
	44	#define IRQ_TYPE_EDGE_RISING 0x00000001 /* Edge rising type */
	45	#define IRQ_TYPE_EDGE_FALLING 0x00000002 /* Edge falling type */
	46	#define IRQ_TYPE_EDGE_BOTH (IRQ_TYPE_EDGE_FALLING \| IRQ_TYPE_EDGE_RISING)
	47	#define IRQ_TYPE_LEVEL_HIGH 0x00000004 /* Level high type */
	48	#define IRQ_TYPE_LEVEL_LOW 0x00000008 /* Level low type */
	49	#define IRQ_TYPE_SENSE_MASK 0x0000000f /* Mask of the above */
	50	#define IRQ_TYPE_PROBE 0x00000010 /* Probing in progress */
	51
	52	/* Internal flags */
009b4c3b TG	53
	54	#ifndef CONFIG_GENERIC_HARDIRQS_NO_COMPAT
	55	#define IRQ_INPROGRESS 0x00000100 /* DEPRECATED */
163ef309 TG	56	#define IRQ_REPLAY 0x00000200 /* DEPRECATED */
163ef309 TG	57	#define IRQ_WAITING 0x00000400 /* DEPRECATED */
c1594b77	58	#define IRQ_DISABLED 0x00000800 /* DEPRECATED */
2a0d6fb3	59	#define IRQ_PENDING 0x00001000 /* DEPRECATED */
6e40262e	60	#define IRQ_MASKED 0x00002000 /* DEPRECATED */
f230b6d5 TG	61	/* DEPRECATED use irq_setaffinity_pending() instead*/
f230b6d5 TG	62	#define IRQ_MOVE_PENDING 0x00004000
009b4c3b TG	63	#endif
009b4c3b TG	64
f230b6d5	65	#define IRQ_LEVEL 0x00008000 /* IRQ level triggered */
950f4427 TG	66	#define IRQ_PER_CPU 0x00010000 /* IRQ is per CPU */
	67	#define IRQ_NOPROBE 0x00020000 /* IRQ is not valid for probing */
	68	#define IRQ_NOREQUEST 0x00040000 /* IRQ cannot be requested */
	69	#define IRQ_NOAUTOEN 0x00080000 /* IRQ will not be enabled on request irq */
d7e25f33	70	#define IRQ_WAKEUP 0x00100000 /* IRQ triggers system wakeup */
d7e25f33	71	#define IRQ_NO_BALANCING 0x00400000 /* IRQ is excluded from balancing */
f6d87f4b TG	72	#define IRQ_MOVE_PCNTXT 0x01000000 /* IRQ migration from process context */
f6d87f4b TG	73	#define IRQ_AFFINITY_SET 0x02000000 /* IRQ affinity was set from userspace*/
399b5da2	74	#define IRQ_NESTED_THREAD 0x10000000 /* IRQ is nested into another, no own handler thread */
950f4427	75
44247184 TG	76	#define IRQF_MODIFY_MASK \
44247184 TG	77	(IRQ_TYPE_SENSE_MASK \| IRQ_NOPROBE \| IRQ_NOREQUEST \| \
872434d6	78	IRQ_NOAUTOEN \| IRQ_MOVE_PCNTXT \| IRQ_LEVEL \| IRQ_NO_BALANCING \| \
6f91a52d	79	IRQ_PER_CPU \| IRQ_NESTED_THREAD)
44247184	80
8f53f924 TG	81	#define IRQ_NO_BALANCING_MASK (IRQ_PER_CPU \| IRQ_NO_BALANCING)
	82
	83	static inline __deprecated bool CHECK_IRQ_PER_CPU(unsigned int status)
	84	{
	85	return status & IRQ_PER_CPU;
	86	}
1da177e4	87
3b8249e7 TG	88	/*
	89	* Return value for chip->irq_set_affinity()
	90	*
	91	* IRQ_SET_MASK_OK - OK, core updates irq_data.affinity
	92	* IRQ_SET_MASK_NOCPY - OK, chip did update irq_data.affinity
	93	*/
	94	enum {
	95	IRQ_SET_MASK_OK = 0,
	96	IRQ_SET_MASK_OK_NOCOPY,
	97	};
	98
5b912c10	99	struct msi_desc;
6a6de9ef	100
ff7dcd44 TG	101	/**
	102	* struct irq_data - per irq and irq chip data passed down to chip functions
	103	* @irq: interrupt number
	104	* @node: node index useful for balancing
91c49917 TG	105	* @state_use_accessor: status information for irq chip functions.
91c49917 TG	106	* Use accessor functions to deal with it
ff7dcd44 TG	107	* @chip: low level interrupt hardware access
	108	* @handler_data: per-IRQ data for the irq_chip methods
	109	* @chip_data: platform-specific per-chip private data for the chip
	110	* methods, to allow shared chip implementations
	111	* @msi_desc: MSI descriptor
	112	* @affinity: IRQ affinity on SMP
ff7dcd44 TG	113	*
	114	* The fields here need to overlay the ones in irq_desc until we
	115	* cleaned up the direct references and switched everything over to
	116	* irq_data.
	117	*/
	118	struct irq_data {
	119	unsigned int irq;
	120	unsigned int node;
91c49917	121	unsigned int state_use_accessors;
ff7dcd44 TG	122	struct irq_chip *chip;
	123	void *handler_data;
	124	void *chip_data;
	125	struct msi_desc *msi_desc;
	126	#ifdef CONFIG_SMP
	127	cpumask_var_t affinity;
	128	#endif
ff7dcd44 TG	129	};
ff7dcd44 TG	130
f230b6d5 TG	131	/*
	132	* Bit masks for irq_data.state
	133	*
	134	* IRQD_SETAFFINITY_PENDING - Affinity setting is pending
	135	*/
	136	enum {
	137	/* Bit 0 - 7 reserved for TYPE will use later */
	138	IRQD_SETAFFINITY_PENDING = (1 << 8),
	139	};
	140
	141	static inline bool irqd_is_setaffinity_pending(struct irq_data *d)
	142	{
	143	return d->state_use_accessors & IRQD_SETAFFINITY_PENDING;
	144	}
	145
8fee5c36	146	/**
6a6de9ef	147	* struct irq_chip - hardware interrupt chip descriptor
8fee5c36 IM	148	*
8fee5c36 IM	149	* @name: name for /proc/interrupts
f8822657 TG	150	* @startup: deprecated, replaced by irq_startup
	151	* @shutdown: deprecated, replaced by irq_shutdown
	152	* @enable: deprecated, replaced by irq_enable
	153	* @disable: deprecated, replaced by irq_disable
	154	* @ack: deprecated, replaced by irq_ack
	155	* @mask: deprecated, replaced by irq_mask
	156	* @mask_ack: deprecated, replaced by irq_mask_ack
	157	* @unmask: deprecated, replaced by irq_unmask
	158	* @eoi: deprecated, replaced by irq_eoi
	159	* @end: deprecated, will go away with __do_IRQ()
	160	* @set_affinity: deprecated, replaced by irq_set_affinity
	161	* @retrigger: deprecated, replaced by irq_retrigger
	162	* @set_type: deprecated, replaced by irq_set_type
	163	* @set_wake: deprecated, replaced by irq_wake
	164	* @bus_lock: deprecated, replaced by irq_bus_lock
	165	* @bus_sync_unlock: deprecated, replaced by irq_bus_sync_unlock
8fee5c36	166	*
f8822657 TG	167	* @irq_startup: start up the interrupt (defaults to ->enable if NULL)
	168	* @irq_shutdown: shut down the interrupt (defaults to ->disable if NULL)
	169	* @irq_enable: enable the interrupt (defaults to chip->unmask if NULL)
	170	* @irq_disable: disable the interrupt
	171	* @irq_ack: start of a new interrupt
	172	* @irq_mask: mask an interrupt source
	173	* @irq_mask_ack: ack and mask an interrupt source
	174	* @irq_unmask: unmask an interrupt source
	175	* @irq_eoi: end of interrupt
	176	* @irq_set_affinity: set the CPU affinity on SMP machines
	177	* @irq_retrigger: resend an IRQ to the CPU
	178	* @irq_set_type: set the flow type (IRQ_TYPE_LEVEL/etc.) of an IRQ
	179	* @irq_set_wake: enable/disable power-management wake-on of an IRQ
	180	* @irq_bus_lock: function to lock access to slow bus (i2c) chips
	181	* @irq_bus_sync_unlock:function to sync and unlock slow bus (i2c) chips
70aedd24	182	*
8fee5c36	183	* @release: release function solely used by UML
1da177e4	184	*/
6a6de9ef TG	185	struct irq_chip {
6a6de9ef TG	186	const char *name;
bd151412	187	#ifndef CONFIG_GENERIC_HARDIRQS_NO_DEPRECATED
71d218b7 IM	188	unsigned int (*startup)(unsigned int irq);
	189	void (*shutdown)(unsigned int irq);
	190	void (*enable)(unsigned int irq);
	191	void (*disable)(unsigned int irq);
6a6de9ef	192
71d218b7	193	void (*ack)(unsigned int irq);
6a6de9ef TG	194	void (*mask)(unsigned int irq);
	195	void (*mask_ack)(unsigned int irq);
	196	void (*unmask)(unsigned int irq);
47c2a3aa	197	void (*eoi)(unsigned int irq);
6a6de9ef	198
71d218b7	199	void (*end)(unsigned int irq);
d5dedd45	200	int (*set_affinity)(unsigned int irq,
0de26520	201	const struct cpumask *dest);
c0ad90a3	202	int (*retrigger)(unsigned int irq);
6a6de9ef TG	203	int (*set_type)(unsigned int irq, unsigned int flow_type);
6a6de9ef TG	204	int (*set_wake)(unsigned int irq, unsigned int on);
c0ad90a3	205
70aedd24 TG	206	void (*bus_lock)(unsigned int irq);
70aedd24 TG	207	void (*bus_sync_unlock)(unsigned int irq);
bd151412	208	#endif
f8822657 TG	209	unsigned int (irq_startup)(struct irq_data data);
	210	void (irq_shutdown)(struct irq_data data);
	211	void (irq_enable)(struct irq_data data);
	212	void (irq_disable)(struct irq_data data);
	213
	214	void (irq_ack)(struct irq_data data);
	215	void (irq_mask)(struct irq_data data);
	216	void (irq_mask_ack)(struct irq_data data);
	217	void (irq_unmask)(struct irq_data data);
	218	void (irq_eoi)(struct irq_data data);
	219
	220	int (irq_set_affinity)(struct irq_data data, const struct cpumask *dest, bool force);
	221	int (irq_retrigger)(struct irq_data data);
	222	int (irq_set_type)(struct irq_data data, unsigned int flow_type);
	223	int (irq_set_wake)(struct irq_data data, unsigned int on);
	224
	225	void (irq_bus_lock)(struct irq_data data);
	226	void (irq_bus_sync_unlock)(struct irq_data data);
	227
b77d6adc PBG	228	/* Currently used only by UML, might disappear one day.*/
b77d6adc PBG	229	#ifdef CONFIG_IRQ_RELEASE_METHOD
71d218b7	230	void (release)(unsigned int irq, void dev_id);
b77d6adc	231	#endif
1da177e4 LT	232	};
1da177e4 LT	233
e144710b TG	234	/* This include will go away once we isolated irq_desc usage to core code */
e144710b TG	235	#include <linux/irqdesc.h>
0b8f1efa	236
34ffdb72 IM	237	/*
	238	* Pick up the arch-dependent methods:
	239	*/
	240	#include <asm/hw_irq.h>
1da177e4	241
b683de2b TG	242	#ifndef NR_IRQS_LEGACY
	243	# define NR_IRQS_LEGACY 0
	244	#endif
	245
1318a481 TG	246	#ifndef ARCH_IRQ_INIT_FLAGS
	247	# define ARCH_IRQ_INIT_FLAGS 0
	248	#endif
	249
c1594b77	250	#define IRQ_DEFAULT_INIT_FLAGS ARCH_IRQ_INIT_FLAGS
1318a481	251
e144710b	252	struct irqaction;
06fcb0c6	253	extern int setup_irq(unsigned int irq, struct irqaction *new);
cbf94f06	254	extern void remove_irq(unsigned int irq, struct irqaction *act);
1da177e4 LT	255
1da177e4 LT	256	#ifdef CONFIG_GENERIC_HARDIRQS
06fcb0c6	257
3a3856d0	258	#if defined(CONFIG_SMP) && defined(CONFIG_GENERIC_PENDING_IRQ)
c777ac55	259	void move_native_irq(int irq);
e7b946e9	260	void move_masked_irq(int irq);
e144710b TG	261	#else
	262	static inline void move_native_irq(int irq) { }
	263	static inline void move_masked_irq(int irq) { }
	264	#endif
54d5d424	265
1da177e4	266	extern int no_irq_affinity;
1da177e4	267
6a6de9ef	268	/* Handle irq action chains: */
bedd30d9	269	extern irqreturn_t handle_IRQ_event(unsigned int irq, struct irqaction *action);
6a6de9ef TG	270
	271	/*
	272	* Built-in IRQ handlers for various IRQ types,
bebd04cc	273	* callable via desc->handle_irq()
6a6de9ef	274	*/
ec701584 HH	275	extern void handle_level_irq(unsigned int irq, struct irq_desc *desc);
	276	extern void handle_fasteoi_irq(unsigned int irq, struct irq_desc *desc);
	277	extern void handle_edge_irq(unsigned int irq, struct irq_desc *desc);
	278	extern void handle_simple_irq(unsigned int irq, struct irq_desc *desc);
	279	extern void handle_percpu_irq(unsigned int irq, struct irq_desc *desc);
	280	extern void handle_bad_irq(unsigned int irq, struct irq_desc *desc);
31b47cf7	281	extern void handle_nested_irq(unsigned int irq);
6a6de9ef	282
6a6de9ef	283	/* Handling of unhandled and spurious interrupts: */
34ffdb72	284	extern void note_interrupt(unsigned int irq, struct irq_desc *desc,
bedd30d9	285	irqreturn_t action_ret);
1da177e4	286
a4633adc	287
6a6de9ef TG	288	/* Enable/disable irq debugging output: */
	289	extern int noirqdebug_setup(char *str);
	290
	291	/* Checks whether the interrupt can be requested by request_irq(): */
	292	extern int can_request_irq(unsigned int irq, unsigned long irqflags);
	293
f8b5473f	294	/* Dummy irq-chip implementations: */
6a6de9ef	295	extern struct irq_chip no_irq_chip;
f8b5473f	296	extern struct irq_chip dummy_irq_chip;
6a6de9ef	297
145fc655 IM	298	extern void
	299	set_irq_chip_and_handler(unsigned int irq, struct irq_chip *chip,
	300	irq_flow_handler_t handle);
6a6de9ef	301	extern void
a460e745 IM	302	set_irq_chip_and_handler_name(unsigned int irq, struct irq_chip *chip,
	303	irq_flow_handler_t handle, const char *name);
	304
6a6de9ef	305	extern void
a460e745 IM	306	__set_irq_handler(unsigned int irq, irq_flow_handler_t handle, int is_chained,
a460e745 IM	307	const char *name);
1da177e4	308
6a6de9ef TG	309	/*
	310	* Set a highlevel flow handler for a given IRQ:
	311	*/
	312	static inline void
57a58a94	313	set_irq_handler(unsigned int irq, irq_flow_handler_t handle)
6a6de9ef	314	{
a460e745	315	__set_irq_handler(irq, handle, 0, NULL);
6a6de9ef TG	316	}
	317
	318	/*
	319	* Set a highlevel chained flow handler for a given IRQ.
	320	* (a chained handler is automatically enabled and set to
	321	* IRQ_NOREQUEST and IRQ_NOPROBE)
	322	*/
	323	static inline void
a0cd9ca2	324	set_irq_chained_handler(unsigned int irq, irq_flow_handler_t handle)
6a6de9ef	325	{
a460e745	326	__set_irq_handler(irq, handle, 1, NULL);
6a6de9ef TG	327	}
6a6de9ef TG	328
44247184 TG	329	void irq_modify_status(unsigned int irq, unsigned long clr, unsigned long set);
	330
	331	static inline void irq_set_status_flags(unsigned int irq, unsigned long set)
	332	{
	333	irq_modify_status(irq, 0, set);
	334	}
	335
	336	static inline void irq_clear_status_flags(unsigned int irq, unsigned long clr)
	337	{
	338	irq_modify_status(irq, clr, 0);
	339	}
	340
a0cd9ca2	341	static inline void irq_set_noprobe(unsigned int irq)
44247184 TG	342	{
	343	irq_modify_status(irq, 0, IRQ_NOPROBE);
	344	}
	345
a0cd9ca2	346	static inline void irq_set_probe(unsigned int irq)
44247184 TG	347	{
	348	irq_modify_status(irq, IRQ_NOPROBE, 0);
	349	}
46f4f8f6	350
6f91a52d TG	351	static inline void irq_set_nested_thread(unsigned int irq, bool nest)
	352	{
	353	if (nest)
	354	irq_set_status_flags(irq, IRQ_NESTED_THREAD);
	355	else
	356	irq_clear_status_flags(irq, IRQ_NESTED_THREAD);
	357	}
	358
3a16d713	359	/* Handle dynamic irq creation and destruction */
d047f53a	360	extern unsigned int create_irq_nr(unsigned int irq_want, int node);
3a16d713 EB	361	extern int create_irq(void);
	362	extern void destroy_irq(unsigned int irq);
	363
b7b29338 TG	364	/*
	365	* Dynamic irq helper functions. Obsolete. Use irq_alloc_desc* and
	366	* irq_free_desc instead.
	367	*/
3a16d713	368	extern void dynamic_irq_cleanup(unsigned int irq);
b7b29338 TG	369	static inline void dynamic_irq_init(unsigned int irq)
	370	{
	371	dynamic_irq_cleanup(irq);
	372	}
dd87eb3a	373
3a16d713	374	/* Set/get chip/data for an IRQ: */
a0cd9ca2 TG	375	extern int irq_set_chip(unsigned int irq, struct irq_chip *chip);
	376	extern int irq_set_handler_data(unsigned int irq, void *data);
	377	extern int irq_set_chip_data(unsigned int irq, void *data);
	378	extern int irq_set_irq_type(unsigned int irq, unsigned int type);
	379	extern int irq_set_msi_desc(unsigned int irq, struct msi_desc *entry);
f303a6dd	380	extern struct irq_data *irq_get_irq_data(unsigned int irq);
dd87eb3a	381
a0cd9ca2	382	static inline struct irq_chip *irq_get_chip(unsigned int irq)
f303a6dd TG	383	{
	384	struct irq_data *d = irq_get_irq_data(irq);
	385	return d ? d->chip : NULL;
	386	}
	387
	388	static inline struct irq_chip irq_data_get_irq_chip(struct irq_data d)
	389	{
	390	return d->chip;
	391	}
	392
a0cd9ca2	393	static inline void *irq_get_chip_data(unsigned int irq)
f303a6dd TG	394	{
	395	struct irq_data *d = irq_get_irq_data(irq);
	396	return d ? d->chip_data : NULL;
	397	}
	398
	399	static inline void irq_data_get_irq_chip_data(struct irq_data d)
	400	{
	401	return d->chip_data;
	402	}
	403
a0cd9ca2	404	static inline void *irq_get_handler_data(unsigned int irq)
f303a6dd TG	405	{
	406	struct irq_data *d = irq_get_irq_data(irq);
	407	return d ? d->handler_data : NULL;
	408	}
	409
a0cd9ca2	410	static inline void irq_data_get_irq_handler_data(struct irq_data d)
f303a6dd TG	411	{
	412	return d->handler_data;
	413	}
	414
a0cd9ca2	415	static inline struct msi_desc *irq_get_msi_desc(unsigned int irq)
f303a6dd TG	416	{
	417	struct irq_data *d = irq_get_irq_data(irq);
	418	return d ? d->msi_desc : NULL;
	419	}
	420
	421	static inline struct msi_desc irq_data_get_msi(struct irq_data d)
	422	{
	423	return d->msi_desc;
	424	}
	425
a0cd9ca2 TG	426	#ifndef CONFIG_GENERIC_HARDIRQS_NO_COMPAT
	427	/* Please do not use: Use the replacement functions instead */
	428	static inline int set_irq_chip(unsigned int irq, struct irq_chip *chip)
	429	{
	430	return irq_set_chip(irq, chip);
	431	}
	432	static inline int set_irq_data(unsigned int irq, void *data)
	433	{
	434	return irq_set_handler_data(irq, data);
	435	}
	436	static inline int set_irq_chip_data(unsigned int irq, void *data)
	437	{
	438	return irq_set_chip_data(irq, data);
	439	}
	440	static inline int set_irq_type(unsigned int irq, unsigned int type)
	441	{
	442	return irq_set_irq_type(irq, type);
	443	}
	444	static inline int set_irq_msi(unsigned int irq, struct msi_desc *entry)
	445	{
	446	return irq_set_msi_desc(irq, entry);
	447	}
	448	static inline struct irq_chip *get_irq_chip(unsigned int irq)
	449	{
	450	return irq_get_chip(irq);
	451	}
	452	static inline void *get_irq_chip_data(unsigned int irq)
	453	{
	454	return irq_get_chip_data(irq);
	455	}
	456	static inline void *get_irq_data(unsigned int irq)
	457	{
	458	return irq_get_handler_data(irq);
	459	}
	460	static inline void irq_data_get_irq_data(struct irq_data d)
	461	{
	462	return irq_data_get_irq_handler_data(d);
	463	}
	464	static inline struct msi_desc *get_irq_msi(unsigned int irq)
	465	{
	466	return irq_get_msi_desc(irq);
	467	}
	468	static inline void set_irq_noprobe(unsigned int irq)
	469	{
	470	irq_set_noprobe(irq);
	471	}
	472	static inline void set_irq_probe(unsigned int irq)
	473	{
	474	irq_set_probe(irq);
	475	}
6f91a52d TG	476	static inline void set_irq_nested_thread(unsigned int irq, int nest)
	477	{
	478	irq_set_nested_thread(irq, nest);
	479	}
a0cd9ca2 TG	480	#endif
a0cd9ca2 TG	481
1f5a5b87 TG	482	int irq_alloc_descs(int irq, unsigned int from, unsigned int cnt, int node);
1f5a5b87 TG	483	void irq_free_descs(unsigned int irq, unsigned int cnt);
06f6c339	484	int irq_reserve_irqs(unsigned int from, unsigned int cnt);
1f5a5b87 TG	485
	486	static inline int irq_alloc_desc(int node)
	487	{
	488	return irq_alloc_descs(-1, 0, 1, node);
	489	}
	490
	491	static inline int irq_alloc_desc_at(unsigned int at, int node)
	492	{
	493	return irq_alloc_descs(at, at, 1, node);
	494	}
	495
	496	static inline int irq_alloc_desc_from(unsigned int from, int node)
	497	{
	498	return irq_alloc_descs(-1, from, 1, node);
	499	}
	500
	501	static inline void irq_free_desc(unsigned int irq)
	502	{
	503	irq_free_descs(irq, 1);
	504	}
	505
639bd12f PM	506	static inline int irq_reserve_irq(unsigned int irq)
	507	{
	508	return irq_reserve_irqs(irq, 1);
	509	}
	510
6a6de9ef	511	#endif /* CONFIG_GENERIC_HARDIRQS */
1da177e4	512
06fcb0c6	513	#endif /* !CONFIG_S390 */
1da177e4	514
06fcb0c6	515	#endif /* _LINUX_IRQ_H */