Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 1 | #ifndef _LINUX_IRQDESC_H |
| 2 | #define _LINUX_IRQDESC_H |
| 3 | |
| 4 | /* |
| 5 | * Core internal functions to deal with irq descriptors |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 6 | */ |
| 7 | |
Ben Hutchings | cd7eab4 | 2011-01-19 21:01:44 +0000 | [diff] [blame] | 8 | struct irq_affinity_notify; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 9 | struct proc_dir_entry; |
Paul Gortmaker | ec53cf2 | 2011-09-19 20:33:19 -0400 | [diff] [blame] | 10 | struct module; |
Thomas Gleixner | 293a7a0 | 2012-10-16 15:07:49 -0700 | [diff] [blame] | 11 | struct irq_desc; |
Marc Zyngier | 76ba59f | 2014-08-26 11:03:16 +0100 | [diff] [blame] | 12 | struct irq_domain; |
| 13 | struct pt_regs; |
Thomas Gleixner | 293a7a0 | 2012-10-16 15:07:49 -0700 | [diff] [blame] | 14 | |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 15 | /** |
| 16 | * struct irq_desc - interrupt descriptor |
Jiang Liu | 0d0b4c8 | 2015-06-01 16:05:12 +0800 | [diff] [blame] | 17 | * @irq_common_data: per irq and chip data passed down to chip functions |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 18 | * @kstat_irqs: irq stats per cpu |
Geert Uytterhoeven | 7707677 | 2011-04-10 11:01:52 +0200 | [diff] [blame] | 19 | * @handle_irq: highlevel irq-events handler |
| 20 | * @preflow_handler: handler called before the flow handler (currently used by sparc) |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 21 | * @action: the irq action chain |
| 22 | * @status: status information |
Thomas Gleixner | dbec07b | 2011-02-07 20:19:55 +0100 | [diff] [blame] | 23 | * @core_internal_state__do_not_mess_with_it: core internal status information |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 24 | * @depth: disable-depth, for nested irq_disable() calls |
Geert Uytterhoeven | 0911f12 | 2011-04-10 11:01:51 +0200 | [diff] [blame] | 25 | * @wake_depth: enable depth, for multiple irq_set_irq_wake() callers |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 26 | * @irq_count: stats field to detect stalled irqs |
| 27 | * @last_unhandled: aging timer for unhandled count |
| 28 | * @irqs_unhandled: stats field for spurious unhandled interrupts |
Thomas Gleixner | 1e77d0a | 2013-03-07 14:53:45 +0100 | [diff] [blame] | 29 | * @threads_handled: stats field for deferred spurious detection of threaded handlers |
| 30 | * @threads_handled_last: comparator field for deferred spurious detection of theraded handlers |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 31 | * @lock: locking for SMP |
Geert Uytterhoeven | 7707677 | 2011-04-10 11:01:52 +0200 | [diff] [blame] | 32 | * @affinity_hint: hint to user space for preferred irq affinity |
Ben Hutchings | cd7eab4 | 2011-01-19 21:01:44 +0000 | [diff] [blame] | 33 | * @affinity_notify: context for notification of affinity changes |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 34 | * @pending_mask: pending rebalanced interrupts |
Thomas Gleixner | b5faba2 | 2011-02-23 23:52:13 +0000 | [diff] [blame] | 35 | * @threads_oneshot: bitfield to handle shared oneshot threads |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 36 | * @threads_active: number of irqaction threads currently running |
| 37 | * @wait_for_threads: wait queue for sync_irq to wait for threaded handlers |
Thomas Gleixner | cab303b | 2014-08-28 11:44:31 +0200 | [diff] [blame] | 38 | * @nr_actions: number of installed actions on this descriptor |
| 39 | * @no_suspend_depth: number of irqactions on a irq descriptor with |
| 40 | * IRQF_NO_SUSPEND set |
| 41 | * @force_resume_depth: number of irqactions on a irq descriptor with |
| 42 | * IRQF_FORCE_RESUME set |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 43 | * @dir: /proc/irq/ procfs entry |
| 44 | * @name: flow handler name for /proc/interrupts output |
| 45 | */ |
| 46 | struct irq_desc { |
Jiang Liu | 0d0b4c8 | 2015-06-01 16:05:12 +0800 | [diff] [blame] | 47 | struct irq_common_data irq_common_data; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 48 | struct irq_data irq_data; |
Eric Dumazet | 6c9ae00 | 2011-01-13 15:45:38 -0800 | [diff] [blame] | 49 | unsigned int __percpu *kstat_irqs; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 50 | irq_flow_handler_t handle_irq; |
Thomas Gleixner | 7812957 | 2011-02-10 15:14:20 +0100 | [diff] [blame] | 51 | #ifdef CONFIG_IRQ_PREFLOW_FASTEOI |
| 52 | irq_preflow_handler_t preflow_handler; |
| 53 | #endif |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 54 | struct irqaction *action; /* IRQ action list */ |
Thomas Gleixner | a6967ca | 2011-02-10 22:01:25 +0100 | [diff] [blame] | 55 | unsigned int status_use_accessors; |
Thomas Gleixner | dbec07b | 2011-02-07 20:19:55 +0100 | [diff] [blame] | 56 | unsigned int core_internal_state__do_not_mess_with_it; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 57 | unsigned int depth; /* nested irq disables */ |
| 58 | unsigned int wake_depth; /* nested wake enables */ |
| 59 | unsigned int irq_count; /* For detecting broken IRQs */ |
| 60 | unsigned long last_unhandled; /* Aging timer for unhandled count */ |
| 61 | unsigned int irqs_unhandled; |
Thomas Gleixner | 1e77d0a | 2013-03-07 14:53:45 +0100 | [diff] [blame] | 62 | atomic_t threads_handled; |
| 63 | int threads_handled_last; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 64 | raw_spinlock_t lock; |
Marc Zyngier | 31d9d9b | 2011-09-23 17:03:06 +0100 | [diff] [blame] | 65 | struct cpumask *percpu_enabled; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 66 | #ifdef CONFIG_SMP |
| 67 | const struct cpumask *affinity_hint; |
Ben Hutchings | cd7eab4 | 2011-01-19 21:01:44 +0000 | [diff] [blame] | 68 | struct irq_affinity_notify *affinity_notify; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 69 | #ifdef CONFIG_GENERIC_PENDING_IRQ |
| 70 | cpumask_var_t pending_mask; |
| 71 | #endif |
| 72 | #endif |
Thomas Gleixner | b5faba2 | 2011-02-23 23:52:13 +0000 | [diff] [blame] | 73 | unsigned long threads_oneshot; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 74 | atomic_t threads_active; |
| 75 | wait_queue_head_t wait_for_threads; |
Thomas Gleixner | cab303b | 2014-08-28 11:44:31 +0200 | [diff] [blame] | 76 | #ifdef CONFIG_PM_SLEEP |
| 77 | unsigned int nr_actions; |
| 78 | unsigned int no_suspend_depth; |
Rafael J. Wysocki | 17f4803 | 2015-02-27 00:07:55 +0100 | [diff] [blame] | 79 | unsigned int cond_suspend_depth; |
Thomas Gleixner | cab303b | 2014-08-28 11:44:31 +0200 | [diff] [blame] | 80 | unsigned int force_resume_depth; |
| 81 | #endif |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 82 | #ifdef CONFIG_PROC_FS |
| 83 | struct proc_dir_entry *dir; |
| 84 | #endif |
Thomas Gleixner | 293a7a0 | 2012-10-16 15:07:49 -0700 | [diff] [blame] | 85 | int parent_irq; |
Sebastian Andrzej Siewior | b687380 | 2011-07-11 12:17:31 +0200 | [diff] [blame] | 86 | struct module *owner; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 87 | const char *name; |
| 88 | } ____cacheline_internodealigned_in_smp; |
| 89 | |
Thomas Gleixner | a899418 | 2015-07-05 17:12:30 +0000 | [diff] [blame] | 90 | #ifdef CONFIG_SPARSE_IRQ |
| 91 | extern void irq_lock_sparse(void); |
| 92 | extern void irq_unlock_sparse(void); |
| 93 | #else |
| 94 | static inline void irq_lock_sparse(void) { } |
| 95 | static inline void irq_unlock_sparse(void) { } |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 96 | extern struct irq_desc irq_desc[NR_IRQS]; |
| 97 | #endif |
| 98 | |
Jiang Liu | 7bbf1dd | 2015-06-01 16:05:10 +0800 | [diff] [blame] | 99 | static inline struct irq_desc *irq_data_to_desc(struct irq_data *data) |
| 100 | { |
| 101 | #ifdef CONFIG_IRQ_DOMAIN_HIERARCHY |
| 102 | return irq_to_desc(data->irq); |
| 103 | #else |
| 104 | return container_of(data, struct irq_desc, irq_data); |
| 105 | #endif |
| 106 | } |
| 107 | |
Jiang Liu | 304adf8 | 2015-06-04 12:13:26 +0800 | [diff] [blame] | 108 | static inline unsigned int irq_desc_get_irq(struct irq_desc *desc) |
| 109 | { |
| 110 | return desc->irq_data.irq; |
| 111 | } |
| 112 | |
Thomas Gleixner | d9936bb | 2011-03-11 14:15:35 +0100 | [diff] [blame] | 113 | static inline struct irq_data *irq_desc_get_irq_data(struct irq_desc *desc) |
| 114 | { |
| 115 | return &desc->irq_data; |
| 116 | } |
| 117 | |
Thomas Gleixner | a0cd9ca | 2011-02-10 11:36:33 +0100 | [diff] [blame] | 118 | static inline struct irq_chip *irq_desc_get_chip(struct irq_desc *desc) |
| 119 | { |
| 120 | return desc->irq_data.chip; |
| 121 | } |
| 122 | |
| 123 | static inline void *irq_desc_get_chip_data(struct irq_desc *desc) |
| 124 | { |
| 125 | return desc->irq_data.chip_data; |
| 126 | } |
| 127 | |
| 128 | static inline void *irq_desc_get_handler_data(struct irq_desc *desc) |
| 129 | { |
| 130 | return desc->irq_data.handler_data; |
| 131 | } |
| 132 | |
| 133 | static inline struct msi_desc *irq_desc_get_msi_desc(struct irq_desc *desc) |
| 134 | { |
| 135 | return desc->irq_data.msi_desc; |
| 136 | } |
| 137 | |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 138 | /* |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 139 | * Architectures call this to let the generic IRQ layer |
| 140 | * handle an interrupt. If the descriptor is attached to an |
| 141 | * irqchip-style controller then we call the ->handle_irq() handler, |
| 142 | * and it calls __do_IRQ() if it's attached to an irqtype-style controller. |
| 143 | */ |
| 144 | static inline void generic_handle_irq_desc(unsigned int irq, struct irq_desc *desc) |
| 145 | { |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 146 | desc->handle_irq(irq, desc); |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 147 | } |
| 148 | |
Thomas Gleixner | fe12bc2 | 2011-05-18 12:48:00 +0200 | [diff] [blame] | 149 | int generic_handle_irq(unsigned int irq); |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 150 | |
Marc Zyngier | 76ba59f | 2014-08-26 11:03:16 +0100 | [diff] [blame] | 151 | #ifdef CONFIG_HANDLE_DOMAIN_IRQ |
| 152 | /* |
| 153 | * Convert a HW interrupt number to a logical one using a IRQ domain, |
| 154 | * and handle the result interrupt number. Return -EINVAL if |
| 155 | * conversion failed. Providing a NULL domain indicates that the |
| 156 | * conversion has already been done. |
| 157 | */ |
| 158 | int __handle_domain_irq(struct irq_domain *domain, unsigned int hwirq, |
| 159 | bool lookup, struct pt_regs *regs); |
| 160 | |
| 161 | static inline int handle_domain_irq(struct irq_domain *domain, |
| 162 | unsigned int hwirq, struct pt_regs *regs) |
| 163 | { |
| 164 | return __handle_domain_irq(domain, hwirq, true, regs); |
| 165 | } |
| 166 | #endif |
| 167 | |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 168 | /* Test to see if a driver has successfully requested an irq */ |
| 169 | static inline int irq_has_action(unsigned int irq) |
| 170 | { |
| 171 | struct irq_desc *desc = irq_to_desc(irq); |
| 172 | return desc->action != NULL; |
| 173 | } |
| 174 | |
Thomas Gleixner | a2e8461 | 2011-03-23 13:10:31 +0100 | [diff] [blame] | 175 | /* caller has locked the irq_desc and both params are valid */ |
| 176 | static inline void __irq_set_handler_locked(unsigned int irq, |
| 177 | irq_flow_handler_t handler) |
| 178 | { |
| 179 | struct irq_desc *desc; |
| 180 | |
| 181 | desc = irq_to_desc(irq); |
| 182 | desc->handle_irq = handler; |
| 183 | } |
| 184 | |
| 185 | /* caller has locked the irq_desc and both params are valid */ |
| 186 | static inline void |
| 187 | __irq_set_chip_handler_name_locked(unsigned int irq, struct irq_chip *chip, |
| 188 | irq_flow_handler_t handler, const char *name) |
| 189 | { |
| 190 | struct irq_desc *desc; |
| 191 | |
| 192 | desc = irq_to_desc(irq); |
| 193 | irq_desc_get_irq_data(desc)->chip = chip; |
| 194 | desc->handle_irq = handler; |
| 195 | desc->name = name; |
| 196 | } |
| 197 | |
Thomas Gleixner | bbc9d21 | 2015-06-23 15:01:30 +0200 | [diff] [blame] | 198 | /** |
| 199 | * irq_set_handler_locked - Set irq handler from a locked region |
| 200 | * @data: Pointer to the irq_data structure which identifies the irq |
| 201 | * @handler: Flow control handler function for this interrupt |
| 202 | * |
| 203 | * Sets the handler in the irq descriptor associated to @data. |
| 204 | * |
| 205 | * Must be called with irq_desc locked and valid parameters. Typical |
| 206 | * call site is the irq_set_type() callback. |
| 207 | */ |
| 208 | static inline void irq_set_handler_locked(struct irq_data *data, |
| 209 | irq_flow_handler_t handler) |
| 210 | { |
| 211 | struct irq_desc *desc = irq_data_to_desc(data); |
| 212 | |
| 213 | desc->handle_irq = handler; |
| 214 | } |
| 215 | |
| 216 | /** |
| 217 | * irq_set_chip_handler_name_locked - Set chip, handler and name from a locked region |
| 218 | * @data: Pointer to the irq_data structure for which the chip is set |
| 219 | * @chip: Pointer to the new irq chip |
| 220 | * @handler: Flow control handler function for this interrupt |
| 221 | * @name: Name of the interrupt |
| 222 | * |
| 223 | * Replace the irq chip at the proper hierarchy level in @data and |
| 224 | * sets the handler and name in the associated irq descriptor. |
| 225 | * |
| 226 | * Must be called with irq_desc locked and valid parameters. |
| 227 | */ |
| 228 | static inline void |
| 229 | irq_set_chip_handler_name_locked(struct irq_data *data, struct irq_chip *chip, |
| 230 | irq_flow_handler_t handler, const char *name) |
| 231 | { |
| 232 | struct irq_desc *desc = irq_data_to_desc(data); |
| 233 | |
| 234 | desc->handle_irq = handler; |
| 235 | desc->name = name; |
| 236 | data->chip = chip; |
| 237 | } |
| 238 | |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 239 | static inline int irq_balancing_disabled(unsigned int irq) |
| 240 | { |
| 241 | struct irq_desc *desc; |
| 242 | |
| 243 | desc = irq_to_desc(irq); |
Thomas Gleixner | 0c6f8a8 | 2011-03-28 13:32:20 +0200 | [diff] [blame] | 244 | return desc->status_use_accessors & IRQ_NO_BALANCING_MASK; |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 245 | } |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 246 | |
Vinayak Kale | 7f4a8e7 | 2013-12-04 10:09:50 +0000 | [diff] [blame] | 247 | static inline int irq_is_percpu(unsigned int irq) |
| 248 | { |
| 249 | struct irq_desc *desc; |
| 250 | |
| 251 | desc = irq_to_desc(irq); |
| 252 | return desc->status_use_accessors & IRQ_PER_CPU; |
| 253 | } |
| 254 | |
Thomas Gleixner | d3e17de | 2011-03-22 17:08:15 +0100 | [diff] [blame] | 255 | static inline void |
| 256 | irq_set_lockdep_class(unsigned int irq, struct lock_class_key *class) |
| 257 | { |
| 258 | struct irq_desc *desc = irq_to_desc(irq); |
| 259 | |
| 260 | if (desc) |
| 261 | lockdep_set_class(&desc->lock, class); |
| 262 | } |
| 263 | |
Thomas Gleixner | 7812957 | 2011-02-10 15:14:20 +0100 | [diff] [blame] | 264 | #ifdef CONFIG_IRQ_PREFLOW_FASTEOI |
| 265 | static inline void |
| 266 | __irq_set_preflow_handler(unsigned int irq, irq_preflow_handler_t handler) |
| 267 | { |
| 268 | struct irq_desc *desc; |
| 269 | |
| 270 | desc = irq_to_desc(irq); |
| 271 | desc->preflow_handler = handler; |
| 272 | } |
| 273 | #endif |
Thomas Gleixner | e144710 | 2010-10-01 16:03:45 +0200 | [diff] [blame] | 274 | |
| 275 | #endif |