Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

genirq: Add the generic chip to the genirq docbook

Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Cc: Randy Dunlap <rdunlap@infradead.org>

+19 -5
+13
Documentation/DocBook/genericirq.tmpl
··· 464 464 protected via desc->lock, by the generic layer. 465 465 </para> 466 466 </chapter> 467 + 468 + <chapter id="genericchip"> 469 + <title>Generic interrupt chip</title> 470 + <para> 471 + To avoid copies of identical implementations of irq chips the 472 + core provides a configurable generic interrupt chip 473 + implementation. Developers should check carefuly whether the 474 + generic chip fits their needs before implementing the same 475 + functionality slightly different themself. 476 + </para> 477 + !Ekernel/irq/generic-chip.c 478 + </chapter> 479 + 467 480 <chapter id="structs"> 468 481 <title>Structures</title> 469 482 <para>
+6 -5
kernel/irq/generic-chip.c
··· 45 45 } 46 46 47 47 /** 48 - * irq_gc_mask_set_mask_bit - Mask chip via setting bit in mask register 48 + * irq_gc_mask_set_bit - Mask chip via setting bit in mask register 49 49 * @d: irq_data 50 50 * 51 51 * Chip has a single mask register. Values of this register are cached ··· 65 65 EXPORT_SYMBOL_GPL(irq_gc_mask_set_bit); 66 66 67 67 /** 68 - * irq_gc_mask_set_mask_bit - Mask chip via clearing bit in mask register 68 + * irq_gc_mask_clr_bit - Mask chip via clearing bit in mask register 69 69 * @d: irq_data 70 70 * 71 71 * Chip has a single mask register. Values of this register are cached ··· 167 167 168 168 /** 169 169 * irq_gc_set_wake - Set/clr wake bit for an interrupt 170 - * @d: irq_data 170 + * @d: irq_data 171 + * @on: Indicates whether the wake bit should be set or cleared 171 172 * 172 173 * For chips where the wake from suspend functionality is not 173 174 * configured in a separate register and the wakeup active state is ··· 340 339 */ 341 340 static struct lock_class_key irq_nested_lock_class; 342 341 343 - /** 342 + /* 344 343 * irq_map_generic_chip - Map a generic chip for an irq domain 345 344 */ 346 345 static int irq_map_generic_chip(struct irq_domain *d, unsigned int virq, ··· 455 454 /** 456 455 * irq_setup_alt_chip - Switch to alternative chip 457 456 * @d: irq_data for this interrupt 458 - * @type Flow type to be initialized 457 + * @type: Flow type to be initialized 459 458 * 460 459 * Only to be called from chip->irq_set_type() callbacks. 461 460 */