From: Yangtao Li <frank.li@vivo.com>
To: Thomas Gleixner <tglx@linutronix.de>
Cc: "Yangtao Li" <frank.li@vivo.com>,
"Krzysztof Kozlowski" <krzk@kernel.org>,
"Uwe Kleine-König" <u.kleine-koenig@pengutronix.de>,
"Jonathan Cameron" <Jonathan.Cameron@Huawei.com>,
"AngeloGioacchino Del Regno"
<angelogioacchino.delregno@collabora.com>,
"Geert Uytterhoeven" <geert+renesas@glider.be>,
"Jonathan Cameron" <Jonathan.Cameron@huawei.com>,
linux-kernel@vger.kernel.org
Subject: [PATCH v5 01/22] genirq/devres: Add devm_request_threaded_irq_probe() and devm_request_irq_probe()
Date: Fri, 21 Jul 2023 17:46:20 +0800 [thread overview]
Message-ID: <20230721094641.77189-1-frank.li@vivo.com> (raw)
There are more than 700 calls to devm_request_threaded_irq method and
more than 1000 calls to devm_request_irq method. Most drivers only
request one interrupt resource, and these error messages are basically
the same. If error messages are printed everywhere, more than 2000 lines
of code can be saved by removing the msg in the driver.
And tglx point out that:
If we actually look at the call sites of
devm_request_threaded_irq() then the vast majority of them print more or
less lousy error messages. A quick grep/sed/awk/sort/uniq revealed
519 messages total (there are probably more)
352 unique messages
323 unique messages after lower casing
Those 323 are mostly just variants of the same patterns with
slight modifications in formatting and information provided.
186 of these messages do not deliver any useful information,
e.g. "no irq", "
The most useful one of all is: "could request wakeup irq: %d"
So there is certainly an argument to be made that this particular
function should print a well formatted and informative error message.
It's not a general allocator like kmalloc(). It's specialized and in the
vast majority of cases failing to request the interrupt causes the
device probe to fail. So having proper and consistent information why
the device cannot be used _is_ useful.
So add devm_request_threaded_irq_probe() and devm_request_irq_probe(),
which ensure that all error handling branches print error information.
In this way, when this function fails, the upper-layer functions can
directly return an error code without missing debugging information.
Otherwise, the error message will be printed redundantly or missing.
Cc: Thomas Gleixner <tglx@linutronix.de>
Cc: Krzysztof Kozlowski <krzk@kernel.org>
Cc: "Uwe Kleine-König" <u.kleine-koenig@pengutronix.de>
Cc: Jonathan Cameron <Jonathan.Cameron@Huawei.com>
Cc: AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
Signed-off-by: Yangtao Li <frank.li@vivo.com>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
---
include/linux/interrupt.h | 15 +++++++++++++++
kernel/irq/devres.c | 40 +++++++++++++++++++++++++++++++++++++++
2 files changed, 55 insertions(+)
diff --git a/include/linux/interrupt.h b/include/linux/interrupt.h
index a92bce40b04b..60a3d3bdcf45 100644
--- a/include/linux/interrupt.h
+++ b/include/linux/interrupt.h
@@ -201,6 +201,21 @@ extern void free_percpu_nmi(unsigned int irq, void __percpu *percpu_dev_id);
struct device;
+extern int __must_check
+devm_request_threaded_irq_probe(struct device *dev, unsigned int irq,
+ irq_handler_t handler, irq_handler_t thread_fn,
+ unsigned long irqflags, const char *devname,
+ void *dev_id, const char *info);
+
+static inline int __must_check
+devm_request_irq_probe(struct device *dev, unsigned int irq,
+ irq_handler_t handler, unsigned long irqflags,
+ const char *devname, void *dev_id, const char *info)
+{
+ return devm_request_threaded_irq_probe(dev, irq, handler, NULL, irqflags,
+ devname, dev_id, info);
+}
+
extern int __must_check
devm_request_threaded_irq(struct device *dev, unsigned int irq,
irq_handler_t handler, irq_handler_t thread_fn,
diff --git a/kernel/irq/devres.c b/kernel/irq/devres.c
index f6e5515ee077..40494eabb060 100644
--- a/kernel/irq/devres.c
+++ b/kernel/irq/devres.c
@@ -79,6 +79,46 @@ int devm_request_threaded_irq(struct device *dev, unsigned int irq,
}
EXPORT_SYMBOL(devm_request_threaded_irq);
+/**
+ * devm_request_threaded_irq_probe - allocate an interrupt line for a managed device(recommended)
+ * @dev: device to request interrupt for
+ * @irq: Interrupt line to allocate
+ * @handler: Function to be called when the IRQ occurs
+ * @thread_fn: function to be called in a threaded interrupt context. NULL
+ * for devices which handle everything in @handler
+ * @irqflags: Interrupt type flags
+ * @devname: An ascii name for the claiming device, dev_name(dev) if NULL
+ * @dev_id: A cookie passed back to the handler function
+ * @info: Optional additional error log
+ *
+ * This is a variant of the devm_request_threaded_irq function.
+ * It will print an error message by default when the request fails,
+ * and the consumer can add a special error msg.
+ *
+ * Except for the extra @info argument, this function takes the
+ * same arguments and performs the same function as
+ * devm_request_threaded_irq(). IRQs requested with this function will be
+ * automatically freed on driver detach.
+ *
+ * If an IRQ allocated with this function needs to be freed
+ * separately, devm_free_irq() must be used.
+ */
+int devm_request_threaded_irq_probe(struct device *dev, unsigned int irq,
+ irq_handler_t handler, irq_handler_t thread_fn,
+ unsigned long irqflags, const char *devname,
+ void *dev_id, const char *info)
+{
+ int rc;
+
+ rc = devm_request_threaded_irq(dev, irq, handler, NULL, irqflags, devname, dev_id);
+ if (rc)
+ return dev_err_probe(dev, rc, "Failed to request %sinterrupt %u %s %s\n",
+ thread_fn ? "threaded " : "", irq, devname ? : dev_name(dev),
+ info ? : "");
+ return 0;
+}
+EXPORT_SYMBOL(devm_request_threaded_irq_probe);
+
/**
* devm_request_any_context_irq - allocate an interrupt line for a managed device
* @dev: device to request interrupt for
--
2.39.0
next reply other threads:[~2023-07-21 9:47 UTC|newest]
Thread overview: 30+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-07-21 9:46 Yangtao Li [this message]
2023-07-21 9:46 ` [PATCH v5 02/22] thermal/drivers/sun8i: convert to use devm_request*_irq_probe() Yangtao Li
2023-07-21 10:45 ` Rafael J. Wysocki
2024-08-29 3:02 ` 答复: " 李扬韬
2024-08-29 3:21 ` Yangtao Li
2024-08-29 13:17 ` Thomas Gleixner
2023-07-21 9:46 ` [PATCH v5 03/22] thermal/drivers/armada: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 04/22] thermal/drivers/broadcom: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 05/22] thermal/drivers/tegra: " Yangtao Li
2023-07-21 9:55 ` Krzysztof Kozlowski
2023-07-21 9:46 ` [PATCH v5 06/22] thermal/drivers/qcom/lmh: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 07/22] thermal/drivers/db8500: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 08/22] thermal/drivers/rcar: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 09/22] thermal/drivers/qcom/temp-alarm: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 10/22] thermal: intel: int340x: processor_thermal: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 11/22] thermal/drivers/exynos: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 12/22] thermal/drivers/hisi: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 13/22] thermal/drivers/rockchip: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 14/22] drivers/thermal/rcar_gen3_thermal: " Yangtao Li
2023-07-21 9:56 ` Krzysztof Kozlowski
2023-07-21 9:46 ` [PATCH v5 15/22] thermal/drivers/mediatek/lvts_thermal: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 16/22] thermal: max77620: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 17/22] thermal/drivers/intel/bxt_pmic: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 18/22] thermal/drivers/stm: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 19/22] thermal/drivers/qcom/tsens-v0_1: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 20/22] thermal: qcom-spmi-adc-tm5: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 21/22] thermal/drivers/uniphier: " Yangtao Li
2023-07-21 9:46 ` [PATCH v5 22/22] thermal/drivers/imx: " Yangtao Li
2024-08-29 3:41 ` [PATCH v5 01/22] genirq/devres: Add devm_request_threaded_irq_probe() and devm_request_irq_probe() Yangtao Li
2024-08-29 13:24 ` Thomas Gleixner
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=20230721094641.77189-1-frank.li@vivo.com \
--to=frank.li@vivo.com \
--cc=Jonathan.Cameron@Huawei.com \
--cc=angelogioacchino.delregno@collabora.com \
--cc=geert+renesas@glider.be \
--cc=krzk@kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=tglx@linutronix.de \
--cc=u.kleine-koenig@pengutronix.de \
/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
all inboxes | Powered by JetHome®