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

Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

They have the same functionalities as irq_domain_add_{linear, tree},
except fro accepting different first argument.

Signed-off-by: Jianyu Zhan <nasa4836@gmail.com>
Acked-by: Marc Zyngier <marc.zyngier@arm.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>

authored by

Jianyu Zhan and committed by
Jonathan Corbet
dbe7fcda 83d26b63

+12
+12
Documentation/IRQ-domain.txt
··· 70 70 71 71 ==== Linear ==== 72 72 irq_domain_add_linear() 73 + irq_domain_create_linear() 73 74 74 75 The linear reverse map maintains a fixed size table indexed by the 75 76 hwirq number. When a hwirq is mapped, an irq_desc is allocated for ··· 82 81 allocated for in-use IRQs. The disadvantage is that the table must be 83 82 as large as the largest possible hwirq number. 84 83 84 + irq_domain_add_linear() and irq_domain_create_linear() are functionally 85 + equivalent, except for the first argument is different - the former 86 + accepts an Open Firmware specific 'struct device_node', while the latter 87 + accepts a more general abstraction 'struct fwnode_handle'. 88 + 85 89 The majority of drivers should use the linear map. 86 90 87 91 ==== Tree ==== 88 92 irq_domain_add_tree() 93 + irq_domain_create_tree() 89 94 90 95 The irq_domain maintains a radix tree map from hwirq numbers to Linux 91 96 IRQs. When an hwirq is mapped, an irq_desc is allocated and the ··· 101 94 since it doesn't need to allocate a table as large as the largest 102 95 hwirq number. The disadvantage is that hwirq to IRQ number lookup is 103 96 dependent on how many entries are in the table. 97 + 98 + irq_domain_add_tree() and irq_domain_create_tree() are functionally 99 + equivalent, except for the first argument is different - the former 100 + accepts an Open Firmware specific 'struct device_node', while the latter 101 + accepts a more general abstraction 'struct fwnode_handle'. 104 102 105 103 Very few drivers should need this mapping. 106 104