gpiolib: cdev: don't set GPIOD_FLAG_IS_OUT
Subsystems (3)
PATCH v2 1/1 gpiolib: cdev: don't set GPIOD_FLAG_IS_OUT
When a line is requested or reconfigured through the v2 uAPI, gpio_v2_line_config_flags_to_desc_flags() copies the requested configuration into the descriptor flags, GPIOD_FLAG_IS_OUT included, before gpiod_direction_input_nonotify() or gpiod_direction_output_nonotify() asks the driver for the direction. If the driver refuses, for instance with -EOPNOTSUPP from .direction_input() for a line that can only be an output, the ioctl fails but the flag keeps the refused direction. gpiod_free_commit() does not touch GPIOD_FLAG_IS_OUT, so this outlives the failed request, and GPIO_V2_GET_LINEINFO_IOCTL reports the line as an input while the hardware still drives it, until a request without direction flags makes gpiod_request_commit() read the direction back from the driver:
GPIO_V2_GET_LINE_IOCTL, line 0, input: -EOPNOTSUPP GPIO_V2_GET_LINEINFO_IOCTL, line 0: input GPIO_V2_GET_LINE_IOCTL, line 0, no direction: ok GPIO_V2_GET_LINEINFO_IOCTL, line 0: output
GPIO_V2_LINE_SET_CONFIG_IOCTL updates the flags in the same order. There the line stays requested, and since commit 92ac7de3175e ("gpiolib: don't allow setting values on input lines") GPIO_V2_LINE_SET_VALUES_IOCTL on it then fails with -EPERM, though the line is still an output. A line whose driver refuses to make it an output is likewise reported as one.
gpiod_direction_input_nonotify() and gpiod_direction_output_nonotify() set or clear GPIOD_FLAG_IS_OUT themselves once the driver has accepted the direction, emulated open drain and open source included, and nothing between the copy and those calls reads the flag. Leave it to them, as the v1 uAPI already does.
The other flags that the helper copies stay as they are. Active low, drive and bias are what gpiod_direction_*() applies, drive and bias possibly before the driver refuses the direction; edges and event clock are the character device's own. None of them is read back from the driver, so there is no earlier state that is more accurate to go back to. A failed request releases the line, which clears them, and a failed reconfiguration leaves the line, like the lines before it, with what was applied up to the failure.
Reproduced under QEMU with a test GPIO chip whose line 0 refuses input and line 1 refuses output: both refused requests and both refused reconfigurations leave the line info with the refused direction, and setting the value of the reconfigured output fails with -EPERM. With this change the line info shows the direction of the hardware in all four cases and setting the value works. First seen on real hardware with v6.12.
---
Changes in v2:
- Subject says what the patch does: cdev no longer sets
GPIOD_FLAG_IS_OUT (Kent).
- Comment dropped (Kent).
- Assisted-by tag.
- Link to v1: https://lore.kernel.org/r/[email protected]
drivers/gpio/gpiolib-cdev.c | 5 ----- 1 file changed, 5 deletions(-)
drivers/gpio/gpiolib-cdev.c +0 -5
@@ -1229,11 +1229,6 @@ static void gpio_v2_line_config_flags_to_desc_flags(u64 lflags,assign_bit (GPIOD_FLAG_ACTIVE_LOW , &flags, lflags &GPIO_V2_LINE_FLAG_ACTIVE_LOW ); -if (lflags &GPIO_V2_LINE_FLAG_OUTPUT ) -set_bit (GPIOD_FLAG_IS_OUT , &flags); -else if (lflags &GPIO_V2_LINE_FLAG_INPUT ) -clear_bit (GPIOD_FLAG_IS_OUT , &flags); -assign_bit (GPIOD_FLAG_EDGE_RISING , &flags, lflags &GPIO_V2_LINE_FLAG_EDGE_RISING ); assign_bit(GPIOD_FLAG_EDGE_FALLING, &flags,
base-commit: 72d3fcf802c45d00b300f25b848a93c3a2bd7c7e
Signature · 1 line
2.43.0
Quoted 48 lines · Adrian Ambrozewicz
When a line is requested or reconfigured through the v2 uAPI,
gpio_v2_line_config_flags_to_desc_flags()copies the requested configuration into the descriptor flags,GPIOD_FLAG_IS_OUTincluded, beforegpiod_direction_input_nonotify()orgpiod_direction_output_nonotify()asks the driver for the direction. If the driver refuses, for instance with-EOPNOTSUPPfrom .direction_input() for a line that can only be an output, the ioctl fails but the flag keeps the refused direction.gpiod_free_commit()does not touchGPIOD_FLAG_IS_OUT, so this outlives the failed request, andGPIO_V2_GET_LINEINFO_IOCTLreports the line as an input while the hardware still drives it, until a request without direction flags makesgpiod_request_commit()read the direction back from the driver:GPIO_V2_GET_LINE_IOCTL, line 0, input: -EOPNOTSUPP GPIO_V2_GET_LINEINFO_IOCTL, line 0: input GPIO_V2_GET_LINE_IOCTL, line 0, no direction: ok GPIO_V2_GET_LINEINFO_IOCTL, line 0: output
GPIO_V2_LINE_SET_CONFIG_IOCTLupdates the flags in the same order. There the line stays requested, and since commit92ac7de3175e("gpiolib: don't allow setting values on input lines")GPIO_V2_LINE_SET_VALUES_IOCTLon it then fails with-EPERM, though the line is still an output. A line whose driver refuses to make it an output is likewise reported as one.
gpiod_direction_input_nonotify()andgpiod_direction_output_nonotify()set or clearGPIOD_FLAG_IS_OUTthemselves once the driver has accepted the direction, emulated open drain and open source included, and nothing between the copy and those calls reads the flag. Leave it to them, as the v1 uAPI already does.The other flags that the helper copies stay as they are. Active low, drive and bias are what gpiod_direction_*() applies, drive and bias possibly before the driver refuses the direction; edges and event clock are the character device's own. None of them is read back from the driver, so there is no earlier state that is more accurate to go back to. A failed request releases the line, which clears them, and a failed reconfiguration leaves the line, like the lines before it, with what was applied up to the failure.
Reproduced under QEMU with a test GPIO chip whose line 0 refuses input and line 1 refuses output: both refused requests and both refused reconfigurations leave the line info with the refused direction, and setting the value of the reconfigured output fails with
-EPERM. With this change the line info shows the direction of the hardware in all four cases and setting the value works. First seen on real hardware with v6.12.
Quoted 4 lines
Fixes 3c0d9c635ae2 ("gpiolib: cdev: support GPIO_V2_GET_LINE_IOCTL and GPIO_V2_LINE_GET_VALUES_IOCTL")Assisted-by LLMSigned-off-by Adrian Ambrozewicz <[email protected]>
That is an incredibly verbose commit comment, particularly the discussion of error rollback behaviour, or lack thereof.
This probably isn't the place for it, but I'll leave that for others to judge.
I'm definitely ok with the code change.
Quoted 32 lines
---
Changes in v2:
- Subject says what the patch does: cdev no longer sets
GPIOD_FLAG_IS_OUT(Kent).
- Comment dropped (Kent).
- Assisted-by tag.
- Link to v1: https://lore.kernel.org/r/[email protected]drivers/gpio/gpiolib-cdev.c | 5 ----- 1 file changed, 5 deletions(-)drivers/gpio/gpiolib-cdev.c +0
-5@@ -1229,11 +1229,6 @@ static void gpio_v2_line_config_flags_to_desc_flags(u64 lflags,assign_bit (GPIOD_FLAG_ACTIVE_LOW , &flags, lflags &GPIO_V2_LINE_FLAG_ACTIVE_LOW ); -if (lflags &GPIO_V2_LINE_FLAG_OUTPUT ) -set_bit (GPIOD_FLAG_IS_OUT , &flags); -else if (lflags &GPIO_V2_LINE_FLAG_INPUT ) -clear_bit (GPIOD_FLAG_IS_OUT , &flags); -assign_bit (GPIOD_FLAG_EDGE_RISING , &flags, lflags &GPIO_V2_LINE_FLAG_EDGE_RISING ); assign_bit(GPIOD_FLAG_EDGE_FALLING, &flags,base-commit:
72d3fcf802c45d00b300f25b848a93c3a2bd7c7eSignature · 1 line
2.43.0
Bartosz Golaszewski
maintainerQuoted 54 lines · Kent Gibson
Quoted 48 lines · Adrian Ambrozewicz
When a line is requested or reconfigured through the v2 uAPI,
gpio_v2_line_config_flags_to_desc_flags()copies the requested configuration into the descriptor flags,GPIOD_FLAG_IS_OUTincluded, beforegpiod_direction_input_nonotify()orgpiod_direction_output_nonotify()asks the driver for the direction. If the driver refuses, for instance with-EOPNOTSUPPfrom .direction_input() for a line that can only be an output, the ioctl fails but the flag keeps the refused direction.gpiod_free_commit()does not touchGPIOD_FLAG_IS_OUT, so this outlives the failed request, andGPIO_V2_GET_LINEINFO_IOCTLreports the line as an input while the hardware still drives it, until a request without direction flags makesgpiod_request_commit()read the direction back from the driver:GPIO_V2_GET_LINE_IOCTL, line 0, input: -EOPNOTSUPP GPIO_V2_GET_LINEINFO_IOCTL, line 0: input GPIO_V2_GET_LINE_IOCTL, line 0, no direction: ok GPIO_V2_GET_LINEINFO_IOCTL, line 0: output
GPIO_V2_LINE_SET_CONFIG_IOCTLupdates the flags in the same order. There the line stays requested, and since commit92ac7de3175e("gpiolib: don't allow setting values on input lines")GPIO_V2_LINE_SET_VALUES_IOCTLon it then fails with-EPERM, though the line is still an output. A line whose driver refuses to make it an output is likewise reported as one.
gpiod_direction_input_nonotify()andgpiod_direction_output_nonotify()set or clearGPIOD_FLAG_IS_OUTthemselves once the driver has accepted the direction, emulated open drain and open source included, and nothing between the copy and those calls reads the flag. Leave it to them, as the v1 uAPI already does.The other flags that the helper copies stay as they are. Active low, drive and bias are what gpiod_direction_*() applies, drive and bias possibly before the driver refuses the direction; edges and event clock are the character device's own. None of them is read back from the driver, so there is no earlier state that is more accurate to go back to. A failed request releases the line, which clears them, and a failed reconfiguration leaves the line, like the lines before it, with what was applied up to the failure.
Reproduced under QEMU with a test GPIO chip whose line 0 refuses input and line 1 refuses output: both refused requests and both refused reconfigurations leave the line info with the refused direction, and setting the value of the reconfigured output fails with
-EPERM. With this change the line info shows the direction of the hardware in all four cases and setting the value works. First seen on real hardware with v6.12.Quoted 4 lines
Fixes 3c0d9c635ae2 ("gpiolib: cdev: support GPIO_V2_GET_LINE_IOCTL and GPIO_V2_LINE_GET_VALUES_IOCTL")Assisted-by LLMSigned-off-by Adrian Ambrozewicz <[email protected]>
Quoted 8 lines
That is an incredibly verbose commit comment, particularly the discussion of error rollback behaviour, or lack thereof.
This probably isn't the place for it, but I'll leave that for others to judge.I'm definitely ok with the code change.
Reviewed-by Kent Gibson <[email protected]>
Yeah, I would have loved it to be a bit shorter too. Is this an LLM that generated it? Anyway, I'll queue this for now but please try to make it more brief and to the point next time.
Bart
Quoted 3 lines · Bartosz Golaszewski
Yeah, I would have loved it to be a bit shorter too. Is this an LLM that generated it? Anyway, I'll queue this for now but please try to make it more brief and to the point next time.
Yes, an LLM helped with the analysis and the drafting, hence the Assisted-by tag, and I didn't cut the result down enough. Kent made the same point. I'll keep the messages short from now on, starting with v3 of the chip removal series.
Thanks for picking up this one and the event clock fix.
Adrian
Bartosz Golaszewski
AppliedQuoted 13 lines · Adrian Ambrozewicz
When a line is requested or reconfigured through the v2 uAPI,
gpio_v2_line_config_flags_to_desc_flags()copies the requested configuration into the descriptor flags,GPIOD_FLAG_IS_OUTincluded, beforegpiod_direction_input_nonotify()orgpiod_direction_output_nonotify()asks the driver for the direction. If the driver refuses, for instance with-EOPNOTSUPPfrom .direction_input() for a line that can only be an output, the ioctl fails but the flag keeps the refused direction.gpiod_free_commit()does not touchGPIOD_FLAG_IS_OUT, so this outlives the failed request, andGPIO_V2_GET_LINEINFO_IOCTLreports the line as an input while the hardware still drives it, until a request without direction flags makesgpiod_request_commit()read the direction back from the driver:
Quoted 1 line
[...]
Applied, thanks!
[1/1] gpiolib: cdev: don't set GPIOD_FLAG_IS_OUT
https://git.kernel.org/brgl/c/974d2712cb15014019595799b3ed68fef5fe9695
Best regards,
Signature · 1 line
Bartosz Golaszewski <[email protected]>