* [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
@ 2016-03-26 13:07 Jianyu Zhan
2016-03-26 17:04 ` Randy Dunlap
0 siblings, 1 reply; 5+ messages in thread
From: Jianyu Zhan @ 2016-03-26 13:07 UTC (permalink / raw)
To: jiang.liu, marc.zyngier, corbet, grant.likely, rdunlap
Cc: linux-doc, linux-kernel, Jianyu Zhan
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>
---
Documentation/IRQ-domain.txt | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/Documentation/IRQ-domain.txt b/Documentation/IRQ-domain.txt
index 8d990bd..89dda22 100644
--- a/Documentation/IRQ-domain.txt
+++ b/Documentation/IRQ-domain.txt
@@ -70,6 +70,7 @@ of the reverse map types are described below:
==== Linear ====
irq_domain_add_linear()
+irq_domain_create_linear()
The linear reverse map maintains a fixed size table indexed by the
hwirq number. When a hwirq is mapped, an irq_desc is allocated for
@@ -81,10 +82,16 @@ map are fixed time lookup for IRQ numbers, and irq_descs are only
allocated for in-use IRQs. The disadvantage is that the table must be
as large as the largest possible hwirq number.
+irq_domain_add_linear() and irq_domain_create_linear() are functionally
+equivalent, except for the first argument is different - the former
+accepts an Open Firmware specific 'struct device_node', while the latter
+accepts a more general abstration 'struct fwnode_handle'.
+
The majority of drivers should use the linear map.
==== Tree ====
irq_domain_add_tree()
+irq_domain_create_tree()
The irq_domain maintains a radix tree map from hwirq numbers to Linux
IRQs. When an hwirq is mapped, an irq_desc is allocated and the
@@ -95,6 +102,11 @@ since it doesn't need to allocate a table as large as the largest
hwirq number. The disadvantage is that hwirq to IRQ number lookup is
dependent on how many entries are in the table.
+irq_domain_add_tree() and irq_domain_create_tree() are functionally
+equivalent, except for the first argument is different - the former
+accepts an Open Firmware specific 'struct device_node', while the latter
+accepts a more general abstration 'struct fwnode_handle'.
+
Very few drivers should need this mapping.
==== No Map ===-
--
2.4.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
2016-03-26 13:07 [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree} Jianyu Zhan
@ 2016-03-26 17:04 ` Randy Dunlap
2016-03-27 3:51 ` Jianyu Zhan
0 siblings, 1 reply; 5+ messages in thread
From: Randy Dunlap @ 2016-03-26 17:04 UTC (permalink / raw)
To: Jianyu Zhan, jiang.liu, marc.zyngier, corbet, grant.likely
Cc: linux-doc, linux-kernel
On 03/26/16 06:07, Jianyu Zhan wrote:
> 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>
> ---
> Documentation/IRQ-domain.txt | 12 ++++++++++++
> 1 file changed, 12 insertions(+)
>
> diff --git a/Documentation/IRQ-domain.txt b/Documentation/IRQ-domain.txt
> index 8d990bd..89dda22 100644
> --- a/Documentation/IRQ-domain.txt
> +++ b/Documentation/IRQ-domain.txt
> @@ -70,6 +70,7 @@ of the reverse map types are described below:
>
> ==== Linear ====
> irq_domain_add_linear()
> +irq_domain_create_linear()
>
> The linear reverse map maintains a fixed size table indexed by the
> hwirq number. When a hwirq is mapped, an irq_desc is allocated for
> @@ -81,10 +82,16 @@ map are fixed time lookup for IRQ numbers, and irq_descs are only
> allocated for in-use IRQs. The disadvantage is that the table must be
> as large as the largest possible hwirq number.
>
> +irq_domain_add_linear() and irq_domain_create_linear() are functionally
> +equivalent, except for the first argument is different - the former
> +accepts an Open Firmware specific 'struct device_node', while the latter
> +accepts a more general abstration 'struct fwnode_handle'.
abstraction
> +
> The majority of drivers should use the linear map.
>
> ==== Tree ====
> irq_domain_add_tree()
> +irq_domain_create_tree()
>
> The irq_domain maintains a radix tree map from hwirq numbers to Linux
> IRQs. When an hwirq is mapped, an irq_desc is allocated and the
> @@ -95,6 +102,11 @@ since it doesn't need to allocate a table as large as the largest
> hwirq number. The disadvantage is that hwirq to IRQ number lookup is
> dependent on how many entries are in the table.
>
> +irq_domain_add_tree() and irq_domain_create_tree() are functionally
> +equivalent, except for the first argument is different - the former
> +accepts an Open Firmware specific 'struct device_node', while the latter
> +accepts a more general abstration 'struct fwnode_handle'.
ditto
> +
> Very few drivers should need this mapping.
>
> ==== No Map ===-
>
--
~Randy
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
2016-03-26 17:04 ` Randy Dunlap
@ 2016-03-27 3:51 ` Jianyu Zhan
2016-03-29 10:15 ` Marc Zyngier
2016-03-31 6:33 ` Jonathan Corbet
0 siblings, 2 replies; 5+ messages in thread
From: Jianyu Zhan @ 2016-03-27 3:51 UTC (permalink / raw)
To: jiang.liu, marc.zyngier, corbet, grant.likely, cernekee, ralf, rdunlap
Cc: linux-doc, linux-kernel, Jianyu Zhan
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>
---
v1->v2:
Fix spelling error.
Documentation/IRQ-domain.txt | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/Documentation/IRQ-domain.txt b/Documentation/IRQ-domain.txt
index 8d990bd..89dda22 100644
--- a/Documentation/IRQ-domain.txt
+++ b/Documentation/IRQ-domain.txt
@@ -70,6 +70,7 @@ of the reverse map types are described below:
==== Linear ====
irq_domain_add_linear()
+irq_domain_create_linear()
The linear reverse map maintains a fixed size table indexed by the
hwirq number. When a hwirq is mapped, an irq_desc is allocated for
@@ -81,10 +82,16 @@ map are fixed time lookup for IRQ numbers, and irq_descs are only
allocated for in-use IRQs. The disadvantage is that the table must be
as large as the largest possible hwirq number.
+irq_domain_add_linear() and irq_domain_create_linear() are functionally
+equivalent, except for the first argument is different - the former
+accepts an Open Firmware specific 'struct device_node', while the latter
+accepts a more general abstraction 'struct fwnode_handle'.
+
The majority of drivers should use the linear map.
==== Tree ====
irq_domain_add_tree()
+irq_domain_create_tree()
The irq_domain maintains a radix tree map from hwirq numbers to Linux
IRQs. When an hwirq is mapped, an irq_desc is allocated and the
@@ -95,6 +102,11 @@ since it doesn't need to allocate a table as large as the largest
hwirq number. The disadvantage is that hwirq to IRQ number lookup is
dependent on how many entries are in the table.
+irq_domain_add_tree() and irq_domain_create_tree() are functionally
+equivalent, except for the first argument is different - the former
+accepts an Open Firmware specific 'struct device_node', while the latter
+accepts a more general abstraction 'struct fwnode_handle'.
+
Very few drivers should need this mapping.
==== No Map ===-
--
2.4.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
2016-03-27 3:51 ` Jianyu Zhan
@ 2016-03-29 10:15 ` Marc Zyngier
2016-03-31 6:33 ` Jonathan Corbet
1 sibling, 0 replies; 5+ messages in thread
From: Marc Zyngier @ 2016-03-29 10:15 UTC (permalink / raw)
To: Jianyu Zhan, jiang.liu, corbet, grant.likely, cernekee, ralf, rdunlap
Cc: linux-doc, linux-kernel
On 27/03/16 04:51, Jianyu Zhan wrote:
> 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>
> ---
> v1->v2:
> Fix spelling error.
>
> Documentation/IRQ-domain.txt | 12 ++++++++++++
> 1 file changed, 12 insertions(+)
Acked-by: Marc Zyngier <marc.zyngier@arm.com>
M.
--
Jazz is not dead. It just smells funny...
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
2016-03-27 3:51 ` Jianyu Zhan
2016-03-29 10:15 ` Marc Zyngier
@ 2016-03-31 6:33 ` Jonathan Corbet
1 sibling, 0 replies; 5+ messages in thread
From: Jonathan Corbet @ 2016-03-31 6:33 UTC (permalink / raw)
To: Jianyu Zhan
Cc: jiang.liu, marc.zyngier, grant.likely, cernekee, ralf, rdunlap,
linux-doc, linux-kernel
On Sun, 27 Mar 2016 11:51:20 +0800
Jianyu Zhan <nasa4836@gmail.com> wrote:
> 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>
> ---
> v1->v2:
> Fix spelling error.
Applied to the docs tree, thanks.
jon
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2016-03-31 6:33 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-03-26 13:07 [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree} Jianyu Zhan
2016-03-26 17:04 ` Randy Dunlap
2016-03-27 3:51 ` Jianyu Zhan
2016-03-29 10:15 ` Marc Zyngier
2016-03-31 6:33 ` Jonathan Corbet
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.