[PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Uwe Kleine-König]

The .remove() callback for a platform driver returns an int which makes
many driver authors wrongly assume it's possible to do error handling by
returning an error code. However the value returned is ignored (apart
from emitting a warning) and this typically results in resource leaks.

To improve here there is a quest to make the remove callback return
void. In the first step of this quest all drivers are converted to
.remove_new(), which already returns void. Eventually after all drivers
are converted, .remove_new() will be renamed to .remove().

Trivially convert this driver from always returning zero in the remove
callback to the void returning variant.

Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
---
 drivers/pps/clients/pps-gpio.c | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/drivers/pps/clients/pps-gpio.c b/drivers/pps/clients/pps-gpio.c
index 2f4b11b4dfcd..791fdc9326dd 100644
--- a/drivers/pps/clients/pps-gpio.c
+++ b/drivers/pps/clients/pps-gpio.c
@@ -220,7 +220,7 @@ static int pps_gpio_probe(struct platform_device *pdev)
 	return 0;
 }
 
-static int pps_gpio_remove(struct platform_device *pdev)
+static void pps_gpio_remove(struct platform_device *pdev)
 {
 	struct pps_gpio_device_data *data = platform_get_drvdata(pdev);
 
@@ -229,7 +229,6 @@ static int pps_gpio_remove(struct platform_device *pdev)
 	/* reset echo pin in any case */
 	gpiod_set_value(data->echo_pin, 0);
 	dev_info(&pdev->dev, "removed IRQ %d as PPS source\n", data->irq);
-	return 0;
 }
 
 static const struct of_device_id pps_gpio_dt_ids[] = {
@@ -240,7 +239,7 @@ MODULE_DEVICE_TABLE(of, pps_gpio_dt_ids);
 
 static struct platform_driver pps_gpio_driver = {
 	.probe		= pps_gpio_probe,
-	.remove		= pps_gpio_remove,
+	.remove_new	= pps_gpio_remove,
 	.driver		= {
 		.name	= PPS_GPIO_NAME,
 		.of_match_table	= pps_gpio_dt_ids,

base-commit: 8ffc8b1bbd505e27e2c8439d326b6059c906c9dd
-- 
2.43.0

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Rodolfo Giometti]

On 08/03/24 09:51, Uwe Kleine-König wrote:
> The .remove() callback for a platform driver returns an int which makes
> many driver authors wrongly assume it's possible to do error handling by
> returning an error code. However the value returned is ignored (apart
> from emitting a warning) and this typically results in resource leaks.
> 
> To improve here there is a quest to make the remove callback return
> void. In the first step of this quest all drivers are converted to
> .remove_new(), which already returns void. Eventually after all drivers
> are converted, .remove_new() will be renamed to .remove().
> 
> Trivially convert this driver from always returning zero in the remove
> callback to the void returning variant.
> 
> Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>

Acked-by: Rodolfo Giometti <giometti@enneenne.com>

> ---
>   drivers/pps/clients/pps-gpio.c | 5 ++---
>   1 file changed, 2 insertions(+), 3 deletions(-)
> 
> diff --git a/drivers/pps/clients/pps-gpio.c b/drivers/pps/clients/pps-gpio.c
> index 2f4b11b4dfcd..791fdc9326dd 100644
> --- a/drivers/pps/clients/pps-gpio.c
> +++ b/drivers/pps/clients/pps-gpio.c
> @@ -220,7 +220,7 @@ static int pps_gpio_probe(struct platform_device *pdev)
>   	return 0;
>   }
>   
> -static int pps_gpio_remove(struct platform_device *pdev)
> +static void pps_gpio_remove(struct platform_device *pdev)
>   {
>   	struct pps_gpio_device_data *data = platform_get_drvdata(pdev);
>   
> @@ -229,7 +229,6 @@ static int pps_gpio_remove(struct platform_device *pdev)
>   	/* reset echo pin in any case */
>   	gpiod_set_value(data->echo_pin, 0);
>   	dev_info(&pdev->dev, "removed IRQ %d as PPS source\n", data->irq);
> -	return 0;
>   }
>   
>   static const struct of_device_id pps_gpio_dt_ids[] = {
> @@ -240,7 +239,7 @@ MODULE_DEVICE_TABLE(of, pps_gpio_dt_ids);
>   
>   static struct platform_driver pps_gpio_driver = {
>   	.probe		= pps_gpio_probe,
> -	.remove		= pps_gpio_remove,
> +	.remove_new	= pps_gpio_remove,
>   	.driver		= {
>   		.name	= PPS_GPIO_NAME,
>   		.of_match_table	= pps_gpio_dt_ids,
> 
> base-commit: 8ffc8b1bbd505e27e2c8439d326b6059c906c9dd

-- 
GNU/Linux Solutions                  e-mail: giometti@enneenne.com
Linux Device Driver                          giometti@linux.it
Embedded Systems                     phone:  +39 349 2432127
UNIX programming

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Uwe Kleine-König]

[-- Attachment #1: Type: text/plain, Size: 1422 bytes --]

[Cc: += linuxpps@ml.enneenne.com]

On Fri, Mar 08, 2024 at 09:57:29AM +0100, Rodolfo Giometti wrote:
> On 08/03/24 09:51, Uwe Kleine-König wrote:
> > The .remove() callback for a platform driver returns an int which makes
> > many driver authors wrongly assume it's possible to do error handling by
> > returning an error code. However the value returned is ignored (apart
> > from emitting a warning) and this typically results in resource leaks.
> > 
> > To improve here there is a quest to make the remove callback return
> > void. In the first step of this quest all drivers are converted to
> > .remove_new(), which already returns void. Eventually after all drivers
> > are converted, .remove_new() will be renamed to .remove().
> > 
> > Trivially convert this driver from always returning zero in the remove
> > callback to the void returning variant.
> > 
> > Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
> 
> Acked-by: Rodolfo Giometti <giometti@enneenne.com>

The MAINTAINERS entry for drivers/pps lists you as single maintainer.
Who is expected to pick up this patch given that you "only" send an ack
but didn't pick up the patch? (Or only picked it up in a tree not
included in next.)

Best regards
Uwe

-- 
Pengutronix e.K.                           | Uwe Kleine-König            |
Industrial Linux Solutions                 | https://www.pengutronix.de/ |

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Rodolfo Giometti]

On 08/03/24 09:51, Uwe Kleine-König wrote:
> The .remove() callback for a platform driver returns an int which makes
> many driver authors wrongly assume it's possible to do error handling by
> returning an error code. However the value returned is ignored (apart
> from emitting a warning) and this typically results in resource leaks.
> 
> To improve here there is a quest to make the remove callback return
> void. In the first step of this quest all drivers are converted to
> .remove_new(), which already returns void. Eventually after all drivers
> are converted, .remove_new() will be renamed to .remove().
> 
> Trivially convert this driver from always returning zero in the remove
> callback to the void returning variant.
> 
> Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>

Acked-by: Rodolfo Giometti <giometti@enneenne.com>

> ---
>   drivers/pps/clients/pps-gpio.c | 5 ++---
>   1 file changed, 2 insertions(+), 3 deletions(-)
> 
> diff --git a/drivers/pps/clients/pps-gpio.c b/drivers/pps/clients/pps-gpio.c
> index 2f4b11b4dfcd..791fdc9326dd 100644
> --- a/drivers/pps/clients/pps-gpio.c
> +++ b/drivers/pps/clients/pps-gpio.c
> @@ -220,7 +220,7 @@ static int pps_gpio_probe(struct platform_device *pdev)
>   	return 0;
>   }
>   
> -static int pps_gpio_remove(struct platform_device *pdev)
> +static void pps_gpio_remove(struct platform_device *pdev)
>   {
>   	struct pps_gpio_device_data *data = platform_get_drvdata(pdev);
>   
> @@ -229,7 +229,6 @@ static int pps_gpio_remove(struct platform_device *pdev)
>   	/* reset echo pin in any case */
>   	gpiod_set_value(data->echo_pin, 0);
>   	dev_info(&pdev->dev, "removed IRQ %d as PPS source\n", data->irq);
> -	return 0;
>   }
>   
>   static const struct of_device_id pps_gpio_dt_ids[] = {
> @@ -240,7 +239,7 @@ MODULE_DEVICE_TABLE(of, pps_gpio_dt_ids);
>   
>   static struct platform_driver pps_gpio_driver = {
>   	.probe		= pps_gpio_probe,
> -	.remove		= pps_gpio_remove,
> +	.remove_new	= pps_gpio_remove,
>   	.driver		= {
>   		.name	= PPS_GPIO_NAME,
>   		.of_match_table	= pps_gpio_dt_ids,
> 
> base-commit: 8ffc8b1bbd505e27e2c8439d326b6059c906c9dd

-- 
GNU/Linux Solutions                  e-mail: giometti@enneenne.com
Linux Device Driver                          giometti@linux.it
Embedded Systems                     phone:  +39 349 2432127
UNIX programming

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Rodolfo Giometti]

On 12/04/24 14:26, Uwe Kleine-König wrote:
> [Cc: += linuxpps@ml.enneenne.com]
> 
> On Fri, Mar 08, 2024 at 09:57:29AM +0100, Rodolfo Giometti wrote:
>> On 08/03/24 09:51, Uwe Kleine-König wrote:
>>> The .remove() callback for a platform driver returns an int which makes
>>> many driver authors wrongly assume it's possible to do error handling by
>>> returning an error code. However the value returned is ignored (apart
>>> from emitting a warning) and this typically results in resource leaks.
>>>
>>> To improve here there is a quest to make the remove callback return
>>> void. In the first step of this quest all drivers are converted to
>>> .remove_new(), which already returns void. Eventually after all drivers
>>> are converted, .remove_new() will be renamed to .remove().
>>>
>>> Trivially convert this driver from always returning zero in the remove
>>> callback to the void returning variant.
>>>
>>> Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
>>
>> Acked-by: Rodolfo Giometti <giometti@enneenne.com>
> 
> The MAINTAINERS entry for drivers/pps lists you as single maintainer.
> Who is expected to pick up this patch given that you "only" send an ack
> but didn't pick up the patch? (Or only picked it up in a tree not
> included in next.)

Sorry. I forgot to add Greg Kroah-Hartman into CC. :-(

I've just resent the acked-by mail.

Ciao,

Rodolfo

-- 
GNU/Linux Solutions                  e-mail: giometti@enneenne.com
Linux Device Driver                          giometti@linux.it
Embedded Systems                     phone:  +39 349 2432127
UNIX programming

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Uwe Kleine-König]

[-- Attachment #1: Type: text/plain, Size: 1752 bytes --]

On Fri, Apr 12, 2024 at 02:26:48PM +0200, Uwe Kleine-König wrote:
> [Cc: += linuxpps@ml.enneenne.com]
> 
> On Fri, Mar 08, 2024 at 09:57:29AM +0100, Rodolfo Giometti wrote:
> > On 08/03/24 09:51, Uwe Kleine-König wrote:
> > > The .remove() callback for a platform driver returns an int which makes
> > > many driver authors wrongly assume it's possible to do error handling by
> > > returning an error code. However the value returned is ignored (apart
> > > from emitting a warning) and this typically results in resource leaks.
> > > 
> > > To improve here there is a quest to make the remove callback return
> > > void. In the first step of this quest all drivers are converted to
> > > .remove_new(), which already returns void. Eventually after all drivers
> > > are converted, .remove_new() will be renamed to .remove().
> > > 
> > > Trivially convert this driver from always returning zero in the remove
> > > callback to the void returning variant.
> > > 
> > > Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
> > 
> > Acked-by: Rodolfo Giometti <giometti@enneenne.com>
> 
> The MAINTAINERS entry for drivers/pps lists you as single maintainer.
> Who is expected to pick up this patch given that you "only" send an ack
> but didn't pick up the patch? (Or only picked it up in a tree not
> included in next.)

In the meantime you sent an Ack to my patch. Does that mean I can/should
include this patch in the series changing struct platform_driver that I
intend to send to Greg after the upcoming merge window closes?

Best regards
Uwe

-- 
Pengutronix e.K.                           | Uwe Kleine-König            |
Industrial Linux Solutions                 | https://www.pengutronix.de/ |

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 488 bytes --]

Re: [PATCH] pps: clients: gpio: Convert to platform remove callback returning void

[Rodolfo Giometti]

On 08/05/24 15:57, Uwe Kleine-König wrote:
> On Fri, Apr 12, 2024 at 02:26:48PM +0200, Uwe Kleine-König wrote:
>> [Cc: += linuxpps@ml.enneenne.com]
>>
>> On Fri, Mar 08, 2024 at 09:57:29AM +0100, Rodolfo Giometti wrote:
>>> On 08/03/24 09:51, Uwe Kleine-König wrote:
>>>> The .remove() callback for a platform driver returns an int which makes
>>>> many driver authors wrongly assume it's possible to do error handling by
>>>> returning an error code. However the value returned is ignored (apart
>>>> from emitting a warning) and this typically results in resource leaks.
>>>>
>>>> To improve here there is a quest to make the remove callback return
>>>> void. In the first step of this quest all drivers are converted to
>>>> .remove_new(), which already returns void. Eventually after all drivers
>>>> are converted, .remove_new() will be renamed to .remove().
>>>>
>>>> Trivially convert this driver from always returning zero in the remove
>>>> callback to the void returning variant.
>>>>
>>>> Signed-off-by: Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
>>>
>>> Acked-by: Rodolfo Giometti <giometti@enneenne.com>
>>
>> The MAINTAINERS entry for drivers/pps lists you as single maintainer.
>> Who is expected to pick up this patch given that you "only" send an ack
>> but didn't pick up the patch? (Or only picked it up in a tree not
>> included in next.)
> 
> In the meantime you sent an Ack to my patch. Does that mean I can/should
> include this patch in the series changing struct platform_driver that I
> intend to send to Greg after the upcoming merge window closes?

Yes.

Rodolfo

-- 
GNU/Linux Solutions                  e-mail: giometti@enneenne.com
Linux Device Driver                          giometti@linux.it
Embedded Systems                     phone:  +39 349 2432127
UNIX programming