public inbox for linux-doc@vger.kernel.org
 help / color / mirror / Atom feed
* [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup
@ 2026-01-27 10:32 Andy Shevchenko
  2026-01-27 10:32 ` [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister() Andy Shevchenko
                   ` (4 more replies)
  0 siblings, 5 replies; 9+ messages in thread
From: Andy Shevchenko @ 2026-01-27 10:32 UTC (permalink / raw)
  To: Andy Shevchenko, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan

I have stumbled over low-level APIs used for managed API implementations.
Here is a clean up along with a drop of some duplicate messages.

Andy Shevchenko (3):
  pinctrl: core: Remove unused devm_pinctrl_unregister()
  pinctrl: core: Simplify devm_pinctrl_*()
  pinctrl: core: Remove duplicate error messages

 .../driver-api/driver-model/devres.rst        |  1 -
 drivers/pinctrl/core.c                        | 93 +++++--------------
 include/linux/pinctrl/pinctrl.h               |  3 -
 3 files changed, 21 insertions(+), 76 deletions(-)

-- 
2.50.1


^ permalink raw reply	[flat|nested] 9+ messages in thread

* [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister()
  2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
@ 2026-01-27 10:32 ` Andy Shevchenko
  2026-01-28  8:57   ` Bartosz Golaszewski
  2026-01-27 10:32 ` [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*() Andy Shevchenko
                   ` (3 subsequent siblings)
  4 siblings, 1 reply; 9+ messages in thread
From: Andy Shevchenko @ 2026-01-27 10:32 UTC (permalink / raw)
  To: Andy Shevchenko, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan

There are no users, drop it for good.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 .../driver-api/driver-model/devres.rst        |  1 -
 drivers/pinctrl/core.c                        | 22 -------------------
 include/linux/pinctrl/pinctrl.h               |  3 ---
 3 files changed, 26 deletions(-)

diff --git a/Documentation/driver-api/driver-model/devres.rst b/Documentation/driver-api/driver-model/devres.rst
index 0198ac65e874..7d2b897d66fa 100644
--- a/Documentation/driver-api/driver-model/devres.rst
+++ b/Documentation/driver-api/driver-model/devres.rst
@@ -408,7 +408,6 @@ PINCTRL
   devm_pinctrl_get_select()
   devm_pinctrl_register()
   devm_pinctrl_register_and_init()
-  devm_pinctrl_unregister()
 
 POWER
   devm_reboot_mode_register()
diff --git a/drivers/pinctrl/core.c b/drivers/pinctrl/core.c
index 83254a95ef17..b2b86c4d8475 100644
--- a/drivers/pinctrl/core.c
+++ b/drivers/pinctrl/core.c
@@ -2323,16 +2323,6 @@ static void devm_pinctrl_dev_release(struct device *dev, void *res)
 	pinctrl_unregister(pctldev);
 }
 
-static int devm_pinctrl_dev_match(struct device *dev, void *res, void *data)
-{
-	struct pctldev **r = res;
-
-	if (WARN_ON(!r || !*r))
-		return 0;
-
-	return *r == data;
-}
-
 /**
  * devm_pinctrl_register() - Resource managed version of pinctrl_register().
  * @dev: parent device for this pin controller
@@ -2403,18 +2393,6 @@ int devm_pinctrl_register_and_init(struct device *dev,
 }
 EXPORT_SYMBOL_GPL(devm_pinctrl_register_and_init);
 
-/**
- * devm_pinctrl_unregister() - Resource managed version of pinctrl_unregister().
- * @dev: device for which resource was allocated
- * @pctldev: the pinctrl device to unregister.
- */
-void devm_pinctrl_unregister(struct device *dev, struct pinctrl_dev *pctldev)
-{
-	WARN_ON(devres_release(dev, devm_pinctrl_dev_release,
-			       devm_pinctrl_dev_match, pctldev));
-}
-EXPORT_SYMBOL_GPL(devm_pinctrl_unregister);
-
 static int __init pinctrl_init(void)
 {
 	pr_debug("initialized pinctrl subsystem\n");
diff --git a/include/linux/pinctrl/pinctrl.h b/include/linux/pinctrl/pinctrl.h
index 1a8084e29405..c329cc693139 100644
--- a/include/linux/pinctrl/pinctrl.h
+++ b/include/linux/pinctrl/pinctrl.h
@@ -187,9 +187,6 @@ extern struct pinctrl_dev *devm_pinctrl_register(struct device *dev,
 				const struct pinctrl_desc *pctldesc,
 				void *driver_data);
 
-extern void devm_pinctrl_unregister(struct device *dev,
-				struct pinctrl_dev *pctldev);
-
 extern void pinctrl_add_gpio_range(struct pinctrl_dev *pctldev,
 				struct pinctrl_gpio_range *range);
 extern void pinctrl_add_gpio_ranges(struct pinctrl_dev *pctldev,
-- 
2.50.1


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*()
  2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
  2026-01-27 10:32 ` [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister() Andy Shevchenko
@ 2026-01-27 10:32 ` Andy Shevchenko
  2026-01-28  8:59   ` Bartosz Golaszewski
  2026-01-27 10:32 ` [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages Andy Shevchenko
                   ` (2 subsequent siblings)
  4 siblings, 1 reply; 9+ messages in thread
From: Andy Shevchenko @ 2026-01-27 10:32 UTC (permalink / raw)
  To: Andy Shevchenko, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan

Use devm_add_action_or_reset() instead of devres_alloc() and
devres_add(), which works the same. This will simplify the
code. There is no functional changes.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 drivers/pinctrl/core.c | 67 +++++++++++++-----------------------------
 1 file changed, 20 insertions(+), 47 deletions(-)

diff --git a/drivers/pinctrl/core.c b/drivers/pinctrl/core.c
index b2b86c4d8475..ebf803bff867 100644
--- a/drivers/pinctrl/core.c
+++ b/drivers/pinctrl/core.c
@@ -1383,9 +1383,9 @@ int pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *state)
 }
 EXPORT_SYMBOL_GPL(pinctrl_select_state);
 
-static void devm_pinctrl_release(struct device *dev, void *res)
+static void devm_pinctrl_release(void *p)
 {
-	pinctrl_put(*(struct pinctrl **)res);
+	pinctrl_put(p);
 }
 
 /**
@@ -1397,31 +1397,21 @@ static void devm_pinctrl_release(struct device *dev, void *res)
  */
 struct pinctrl *devm_pinctrl_get(struct device *dev)
 {
-	struct pinctrl **ptr, *p;
-
-	ptr = devres_alloc(devm_pinctrl_release, sizeof(*ptr), GFP_KERNEL);
-	if (!ptr)
-		return ERR_PTR(-ENOMEM);
+	struct pinctrl *p;
+	int ret;
 
 	p = pinctrl_get(dev);
-	if (!IS_ERR(p)) {
-		*ptr = p;
-		devres_add(dev, ptr);
-	} else {
-		devres_free(ptr);
-	}
+	if (IS_ERR(p))
+		return p;
+
+	ret = devm_add_action_or_reset(dev, devm_pinctrl_release, p);
+	if (ret)
+		return ERR_PTR(ret);
 
 	return p;
 }
 EXPORT_SYMBOL_GPL(devm_pinctrl_get);
 
-static int devm_pinctrl_match(struct device *dev, void *res, void *data)
-{
-	struct pinctrl **p = res;
-
-	return *p == data;
-}
-
 /**
  * devm_pinctrl_put() - Resource managed pinctrl_put()
  * @p: the pinctrl handle to release
@@ -1432,8 +1422,7 @@ static int devm_pinctrl_match(struct device *dev, void *res, void *data)
  */
 void devm_pinctrl_put(struct pinctrl *p)
 {
-	WARN_ON(devres_release(p->dev, devm_pinctrl_release,
-			       devm_pinctrl_match, p));
+	devm_release_action(p->dev, devm_pinctrl_release, p);
 }
 EXPORT_SYMBOL_GPL(devm_pinctrl_put);
 
@@ -2316,10 +2305,8 @@ void pinctrl_unregister(struct pinctrl_dev *pctldev)
 }
 EXPORT_SYMBOL_GPL(pinctrl_unregister);
 
-static void devm_pinctrl_dev_release(struct device *dev, void *res)
+static void devm_pinctrl_dev_release(void *pctldev)
 {
-	struct pinctrl_dev *pctldev = *(struct pinctrl_dev **)res;
-
 	pinctrl_unregister(pctldev);
 }
 
@@ -2338,20 +2325,16 @@ struct pinctrl_dev *devm_pinctrl_register(struct device *dev,
 					  const struct pinctrl_desc *pctldesc,
 					  void *driver_data)
 {
-	struct pinctrl_dev **ptr, *pctldev;
-
-	ptr = devres_alloc(devm_pinctrl_dev_release, sizeof(*ptr), GFP_KERNEL);
-	if (!ptr)
-		return ERR_PTR(-ENOMEM);
+	struct pinctrl_dev *pctldev;
+	int ret;
 
 	pctldev = pinctrl_register(pctldesc, dev, driver_data);
-	if (IS_ERR(pctldev)) {
-		devres_free(ptr);
+	if (IS_ERR(pctldev))
 		return pctldev;
-	}
 
-	*ptr = pctldev;
-	devres_add(dev, ptr);
+	ret = devm_add_action_or_reset(dev, devm_pinctrl_dev_release, pctldev);
+	if (ret)
+		return ERR_PTR(ret);
 
 	return pctldev;
 }
@@ -2373,23 +2356,13 @@ int devm_pinctrl_register_and_init(struct device *dev,
 				   void *driver_data,
 				   struct pinctrl_dev **pctldev)
 {
-	struct pinctrl_dev **ptr;
 	int error;
 
-	ptr = devres_alloc(devm_pinctrl_dev_release, sizeof(*ptr), GFP_KERNEL);
-	if (!ptr)
-		return -ENOMEM;
-
 	error = pinctrl_register_and_init(pctldesc, dev, driver_data, pctldev);
-	if (error) {
-		devres_free(ptr);
+	if (error)
 		return error;
-	}
 
-	*ptr = *pctldev;
-	devres_add(dev, ptr);
-
-	return 0;
+	return devm_add_action_or_reset(dev, devm_pinctrl_dev_release, *pctldev);
 }
 EXPORT_SYMBOL_GPL(devm_pinctrl_register_and_init);
 
-- 
2.50.1


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages
  2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
  2026-01-27 10:32 ` [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister() Andy Shevchenko
  2026-01-27 10:32 ` [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*() Andy Shevchenko
@ 2026-01-27 10:32 ` Andy Shevchenko
  2026-01-28  9:00   ` Bartosz Golaszewski
  2026-01-28 13:30 ` [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
  2026-02-03  0:18 ` Linus Walleij
  4 siblings, 1 reply; 9+ messages in thread
From: Andy Shevchenko @ 2026-01-27 10:32 UTC (permalink / raw)
  To: Andy Shevchenko, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan

pinctrl_claim_hogs() is covered to report any error via message.
Since that it's not needed in the callers.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
---
 drivers/pinctrl/core.c | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/drivers/pinctrl/core.c b/drivers/pinctrl/core.c
index ebf803bff867..342bda2a1bd6 100644
--- a/drivers/pinctrl/core.c
+++ b/drivers/pinctrl/core.c
@@ -2187,10 +2187,8 @@ int pinctrl_enable(struct pinctrl_dev *pctldev)
 	int error;
 
 	error = pinctrl_claim_hogs(pctldev);
-	if (error) {
-		dev_err(pctldev->dev, "could not claim hogs: %i\n", error);
+	if (error)
 		return error;
-	}
 
 	mutex_lock(&pinctrldev_list_mutex);
 	list_add_tail(&pctldev->node, &pinctrldev_list);
-- 
2.50.1


^ permalink raw reply related	[flat|nested] 9+ messages in thread

* Re: [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister()
  2026-01-27 10:32 ` [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister() Andy Shevchenko
@ 2026-01-28  8:57   ` Bartosz Golaszewski
  0 siblings, 0 replies; 9+ messages in thread
From: Bartosz Golaszewski @ 2026-01-28  8:57 UTC (permalink / raw)
  To: Andy Shevchenko
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio

On Tue, 27 Jan 2026 11:32:06 +0100, Andy Shevchenko
<andriy.shevchenko@linux.intel.com> said:
> There are no users, drop it for good.
>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---

Reviewed-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*()
  2026-01-27 10:32 ` [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*() Andy Shevchenko
@ 2026-01-28  8:59   ` Bartosz Golaszewski
  0 siblings, 0 replies; 9+ messages in thread
From: Bartosz Golaszewski @ 2026-01-28  8:59 UTC (permalink / raw)
  To: Andy Shevchenko
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio

On Tue, 27 Jan 2026 11:32:07 +0100, Andy Shevchenko
<andriy.shevchenko@linux.intel.com> said:
> Use devm_add_action_or_reset() instead of devres_alloc() and
> devres_add(), which works the same. This will simplify the
> code. There is no functional changes.
>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---

Makes sense, we don't have a custom struct here.

Reviewed-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages
  2026-01-27 10:32 ` [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages Andy Shevchenko
@ 2026-01-28  9:00   ` Bartosz Golaszewski
  0 siblings, 0 replies; 9+ messages in thread
From: Bartosz Golaszewski @ 2026-01-28  9:00 UTC (permalink / raw)
  To: Andy Shevchenko
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan, Philipp Stanner, Linus Walleij,
	Bartosz Golaszewski, driver-core, linux-doc, linux-kernel,
	linux-gpio

On Tue, 27 Jan 2026 11:32:08 +0100, Andy Shevchenko
<andriy.shevchenko@linux.intel.com> said:
> pinctrl_claim_hogs() is covered to report any error via message.
> Since that it's not needed in the callers.
>
> Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
> ---
>  drivers/pinctrl/core.c | 4 +---
>  1 file changed, 1 insertion(+), 3 deletions(-)
>
> diff --git a/drivers/pinctrl/core.c b/drivers/pinctrl/core.c
> index ebf803bff867..342bda2a1bd6 100644
> --- a/drivers/pinctrl/core.c
> +++ b/drivers/pinctrl/core.c
> @@ -2187,10 +2187,8 @@ int pinctrl_enable(struct pinctrl_dev *pctldev)
>  	int error;
>
>  	error = pinctrl_claim_hogs(pctldev);
> -	if (error) {
> -		dev_err(pctldev->dev, "could not claim hogs: %i\n", error);
> +	if (error)
>  		return error;
> -	}
>
>  	mutex_lock(&pinctrldev_list_mutex);
>  	list_add_tail(&pctldev->node, &pinctrldev_list);
> --
> 2.50.1
>
>

Reviewed-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>

^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup
  2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
                   ` (2 preceding siblings ...)
  2026-01-27 10:32 ` [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages Andy Shevchenko
@ 2026-01-28 13:30 ` Andy Shevchenko
  2026-02-03  0:18 ` Linus Walleij
  4 siblings, 0 replies; 9+ messages in thread
From: Andy Shevchenko @ 2026-01-28 13:30 UTC (permalink / raw)
  To: Philipp Stanner, Linus Walleij, Bartosz Golaszewski, driver-core,
	linux-doc, linux-kernel, linux-gpio
  Cc: Greg Kroah-Hartman, Rafael J. Wysocki, Danilo Krummrich,
	Jonathan Corbet, Shuah Khan

On Tue, Jan 27, 2026 at 11:32:05AM +0100, Andy Shevchenko wrote:
> I have stumbled over low-level APIs used for managed API implementations.
> Here is a clean up along with a drop of some duplicate messages.

Thanks, Bart, for the prompt review!

Linus, if you want this to take via my Intel PR, please tell me, otherwise
I consider you take it via your tree directly. Whatever works for you!

-- 
With Best Regards,
Andy Shevchenko



^ permalink raw reply	[flat|nested] 9+ messages in thread

* Re: [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup
  2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
                   ` (3 preceding siblings ...)
  2026-01-28 13:30 ` [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
@ 2026-02-03  0:18 ` Linus Walleij
  4 siblings, 0 replies; 9+ messages in thread
From: Linus Walleij @ 2026-02-03  0:18 UTC (permalink / raw)
  To: Andy Shevchenko
  Cc: Philipp Stanner, Bartosz Golaszewski, driver-core, linux-doc,
	linux-kernel, linux-gpio, Greg Kroah-Hartman, Rafael J. Wysocki,
	Danilo Krummrich, Jonathan Corbet, Shuah Khan

On Tue, Jan 27, 2026 at 11:33 AM Andy Shevchenko
<andriy.shevchenko@linux.intel.com> wrote:

> I have stumbled over low-level APIs used for managed API implementations.
> Here is a clean up along with a drop of some duplicate messages.
>
> Andy Shevchenko (3):
>   pinctrl: core: Remove unused devm_pinctrl_unregister()
>   pinctrl: core: Simplify devm_pinctrl_*()
>   pinctrl: core: Remove duplicate error messages

Sweet, patches applied!

Yours,
Linus Walleij

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2026-02-03  0:18 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-01-27 10:32 [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
2026-01-27 10:32 ` [PATCH v1 1/3] pinctrl: core: Remove unused devm_pinctrl_unregister() Andy Shevchenko
2026-01-28  8:57   ` Bartosz Golaszewski
2026-01-27 10:32 ` [PATCH v1 2/3] pinctrl: core: Simplify devm_pinctrl_*() Andy Shevchenko
2026-01-28  8:59   ` Bartosz Golaszewski
2026-01-27 10:32 ` [PATCH v1 3/3] pinctrl: core: Remove duplicate error messages Andy Shevchenko
2026-01-28  9:00   ` Bartosz Golaszewski
2026-01-28 13:30 ` [PATCH v1 0/3] pinctrl: core: managed resource handling cleanup Andy Shevchenko
2026-02-03  0:18 ` Linus Walleij

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox