Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > linux.kernel > #1364943 > unrolled thread

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

Started byJianyu Zhan <nasa4836@gmail.com>
First post2016-03-26 14:10 +0100
Last post2016-03-31 08:40 +0200
Articles 5 — 4 participants

Back to article view | Back to linux.kernel

Contents

  [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree} Jianyu Zhan <nasa4836@gmail.com> - 2016-03-26 14:10 +0100
    Re: [PATCH] Documentation/IRQ-domain.txt: Document  irq_domain_create_{linear, tree} Randy Dunlap <rdunlap@infradead.org> - 2016-03-26 18:10 +0100
      [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree} Jianyu Zhan <nasa4836@gmail.com> - 2016-03-27 06:00 +0200
        Re: [PATCH] Documentation/IRQ-domain.txt: Document  irq_domain_create_{linear, tree} Marc Zyngier <marc.zyngier@arm.com> - 2016-03-29 12:20 +0200
        Re: [PATCH] Documentation/IRQ-domain.txt: Document  irq_domain_create_{linear, tree} Jonathan Corbet <corbet@lwn.net> - 2016-03-31 08:40 +0200

#1364943 — [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

FromJianyu Zhan <nasa4836@gmail.com>
Date2016-03-26 14:10 +0100
Subject[PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
Message-ID<rgW8z-1hh-37@gated-at.bofh.it>
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

[toc] | [next] | [standalone]

#1364958 — Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

FromRandy Dunlap <rdunlap@infradead.org>
Date2016-03-26 18:10 +0100
SubjectRe: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
Message-ID<rgZSN-3Ms-5@gated-at.bofh.it>
In reply to#1364943
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

[toc] | [prev] | [next] | [standalone]

#1365052

FromJianyu Zhan <nasa4836@gmail.com>
Date2016-03-27 06:00 +0200
Message-ID<rha1Q-2vS-11@gated-at.bofh.it>
In reply to#1364958
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

[toc] | [prev] | [next] | [standalone]

#1366108 — Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

FromMarc Zyngier <marc.zyngier@arm.com>
Date2016-03-29 12:20 +0200
SubjectRe: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
Message-ID<rhYUF-4CQ-3@gated-at.bofh.it>
In reply to#1365052
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...

[toc] | [prev] | [next] | [standalone]

#1367860 — Re: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}

FromJonathan Corbet <corbet@lwn.net>
Date2016-03-31 08:40 +0200
SubjectRe: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
Message-ID<riEqT-P8-41@gated-at.bofh.it>
In reply to#1365052
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

[toc] | [prev] | [standalone]

Back to top | Article view | linux.kernel

csiph-web