From: Jianyu Zhan <nasa4836@gmail.com>
To: jiang.liu@linux.intel.com, marc.zyngier@arm.com, corbet@lwn.net,
grant.likely@secretlab.ca, cernekee@gmail.com,
ralf@linux-mips.org, rdunlap@infradead.org
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
Jianyu Zhan <nasa4836@gmail.com>
Subject: [PATCH] Documentation/IRQ-domain.txt: Document irq_domain_create_{linear, tree}
Date: Sun, 27 Mar 2016 11:51:20 +0800 [thread overview]
Message-ID: <1459050680-3053-1-git-send-email-nasa4836@gmail.com> (raw)
In-Reply-To: <56F6C127.3020405@infradead.org>
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
next prev parent reply other threads:[~2016-03-27 3:51 UTC|newest]
Thread overview: 5+ messages / expand[flat|nested] mbox.gz Atom feed top
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 [this message]
2016-03-29 10:15 ` Marc Zyngier
2016-03-31 6:33 ` Jonathan Corbet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1459050680-3053-1-git-send-email-nasa4836@gmail.com \
--to=nasa4836@gmail.com \
--cc=cernekee@gmail.com \
--cc=corbet@lwn.net \
--cc=grant.likely@secretlab.ca \
--cc=jiang.liu@linux.intel.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=marc.zyngier@arm.com \
--cc=ralf@linux-mips.org \
--cc=rdunlap@infradead.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox