tty: serial: add and use a managed variant of uart_add_one_port()
cover tty: serial: add and use a managed variant of uart_add_one_port()
From: Bartosz Golaszewski <[email protected]>
Resending rebased on top of v6.2-rc1
--
This series adds a managed variant of uart_add_one_port() and uses it in the qcom-geni-serial driver.
I've been asked by Greg to send it separately and he didn't seem to be impressed by the proposition of adding devres interfaces to the tty layer in general. I can only assume it has something to do with the ongoing discussion about the supposed danger of using devres interfaces in conjunction with exporting character devices to user-space.
The bug in question can be triggered by opening a device file, unbinding the driver that exported it and then calling any of the system calls on the associated file descriptor.
After some testing I noticed that many subsystems are indeed either crashing or deadlocking in the above situation. I've sent patches that attempt to fix the GPIO and I2C subsystems[1][2]. Neither of these issues have anything to do with devres and all to do with the fact that certain resources are freed on driver unbind and others need to live for as long as the character device exists. More details on that in the cover letters and commit messages in the links.
I'd like to point out that the serial code is immune to this issue as before every operation, the serial core takes the port lock and checks the uart state. If the device no longer exists (when the uart port is removed, the pointer to uart_port inside uart_state is to NULL), it gracefully returns -ENODEV to user-space.
Please consider applying the patches in the series as devres is the easiest way to lessen the burden on driver developers when dealing with complex error paths and resource leaks. The general rule for devres is: if it can be freed in .remove() then it can be managed by devres, which is the case for this new helper.
Bart
[1] https://lkml.org/lkml/2022/12/8/826
[2] https://lkml.org/lkml/2022/12/5/414
Bartosz Golaszewski (2):
tty: serial: provide devm_uart_add_one_port()
tty: serial: qcom-geni-serial: use devres for uart port management
.../driver-api/driver-model/devres.rst | 3 ++ drivers/tty/serial/qcom_geni_serial.c | 8 +--- drivers/tty/serial/serial_core.c | 48 +++++++++++++++++++ include/linux/serial_core.h | 6 +++ 4 files changed, 58 insertions(+), 7 deletions(-)
Signature · 1 line
2.37.2
PATCH RESEND 1/2 tty: serial: provide devm_uart_add_one_port()
From: Bartosz Golaszewski <[email protected]>
Provide a devres variant of uart_add_one_port() that removes the managed port at device detach.
--- .../driver-api/driver-model/devres.rst | 3 ++ drivers/tty/serial/serial_core.c | 48 +++++++++++++++++++ include/linux/serial_core.h | 6 +++ 3 files changed, 57 insertions(+)
Documentation/driver-api/driver-model/devres.rst +3 -0
@@ -448,6 +448,9 @@ RTC SERDEV devm_serdev_device_open() +SERIAL + devm_uart_add_one_port() + SLAVE DMA ENGINE devm_acpi_dma_controller_register() devm_acpi_dma_controller_free()
drivers/tty/serial/serial_core.c +48 -0
54 lines not on this page · raw message
include/linux/serial_core.h +6 -0
@@ -857,6 +857,12 @@ int uart_remove_one_port(struct uart_driver *reg, struct uart_port *port);bool uart_match_port (const struct uart_port *port1,const struct uart_port *port2); +/* +* UART devres +*/ +int devm_uart_add_one_port (struct device *dev, +struct uart_driver *drv,struct uart_port *port); +/* * Power Management */
Signature · 1 line
2.37.2
PATCH RESEND 2/2 tty: serial: qcom-geni-serial: use devres for uart port management
In reply to Bartosz GolaszewskiFrom: Bartosz Golaszewski <[email protected]>
Shrink and simplify the probe() and remove() code by using the managed variant of uart_add_one_port().
--- drivers/tty/serial/qcom_geni_serial.c | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-)
drivers/tty/serial/qcom_geni_serial.c +1 -7
@@ -1470,7 +1470,7 @@ static int qcom_geni_serial_probe(struct platform_device *pdev)platform_set_drvdata (pdev, port); port->handle_rx = console ? handle_rx_console : handle_rx_uart; - ret =uart_add_one_port (drv, uport); + ret =devm_uart_add_one_port (&pdev->dev, drv, uport);if (ret)return ret;
@@ -1479,7 +1479,6 @@ static int qcom_geni_serial_probe(struct platform_device *pdev) IRQF_TRIGGER_HIGH, port->name, uport);if (ret) {dev_err (uport->dev,"Failed to get IRQ ret %d\n" , ret); -uart_remove_one_port (drv, uport);return ret; }
@@ -1496,7 +1495,6 @@ static int qcom_geni_serial_probe(struct platform_device *pdev) port->wakeup_irq);if (ret) {device_init_wakeup (&pdev->dev, false); -uart_remove_one_port (drv, uport);return ret; } }
@@ -1506,12 +1504,8 @@ static int qcom_geni_serial_probe(struct platform_device *pdev)static int qcom_geni_serial_remove (struct platform_device *pdev) { -struct qcom_geni_serial_port *port =platform_get_drvdata (pdev); -struct uart_driver *drv = port->private_data.drv; -dev_pm_clear_wake_irq (&pdev->dev);device_init_wakeup (&pdev->dev, false); -uart_remove_one_port (drv, &port->uport);return 0 ; }
Signature · 1 line
2.37.2
Greg Kroah-Hartman
maintainerQuoted 6 lines · Bartosz Golaszewski
From: Bartosz Golaszewski <[email protected]>
Resending rebased on top of v6.2-rc1
--
Quoted 8 lines
This series adds a managed variant of
uart_add_one_port()and uses it in the qcom-geni-serial driver.I've been asked by Greg to send it separately and he didn't seem to be impressed by the proposition of adding devres interfaces to the tty layer in general. I can only assume it has something to do with the ongoing discussion about the supposed danger of using devres interfaces in conjunction with exporting character devices to user-space.
That is correct.
Quoted 18 lines
The bug in question can be triggered by opening a device file, unbinding the driver that exported it and then calling any of the system calls on the associated file descriptor.
After some testing I noticed that many subsystems are indeed either crashing or deadlocking in the above situation. I've sent patches that attempt to fix the GPIO and I2C subsystems[1][2]. Neither of these issues have anything to do with devres and all to do with the fact that certain resources are freed on driver unbind and others need to live for as long as the character device exists. More details on that in the cover letters and commit messages in the links.
I'd like to point out that the serial code is immune to this issue as before every operation, the serial core takes the port lock and checks the uart state. If the device no longer exists (when the uart port is removed, the pointer to
uart_portinsideuart_stateis to NULL), it gracefully returns-ENODEVto user-space.
Quoted 5 lines
Please consider applying the patches in the series as devres is the easiest way to lessen the burden on driver developers when dealing with complex error paths and resource leaks. The general rule for devres is: if it can be freed in .remove() then it can be managed by devres, which is the case for this new helper.
Overall you are adding more code to the kernel than removing, so how is this a win? Perhaps if other drivers were converted over to this new function then I would be more inclined to be able to accept it.
But as-is, with only one user, it's a non-starter, sorry.
thanks,
greg k-h