net: phy: fix cleanup after probe failure
Subsystems (3)
v4 cover net: phy: fix cleanup after probe failure
From: Xuanqiang Luo <[email protected]>
phy_probe() initializes the PHY driver, ports, SFP upstream, and LEDs in stages. Its error paths do not always release only the resources acquired at each stage. It can also mark the PHY ready before all setup succeeds.
Port setup also leaves SFP cleanup split between phy_sfp_probe(), phy_setup_ports(), and phy_probe(), and default port setup ignores errors from attaching the port to the PHY driver.
This series makes each initialization layer own its cleanup and propagates setup failures to the caller.
Patch 1 splits the phy_probe() cleanup by initialization stage.
Patch 2 makes SFP and port setup unwind their resources in the required order.
Patch 3 sets PHY_READY only after LED setup succeeds.
Patch 4 calls the PHY driver remove callback after later probe failures.
Patch 5 propagates errors from default port setup.
Patch 6 prevents a double-free after partial LED trigger registration.
---
Changes:
v4:
Patch 1:
- Explain that LED triggers are initialized after the SFP upstream and ports, so they must be unwound first. (Andrew Lunn.)
Patch 2-5:
- Add Reviewed-by: Andrew Lunn <[email protected]>.
Patch 6 (new):
- Prevent a double-free after partial LED trigger registration and make the cleanup ownership explicit. (Sashiko.)
v3: https://lore.kernel.org/all/[email protected]/
Patch 1:
- Rename cleanup labels to include verbs describing their actions. (Jakub Kicinski.)
Patch 3:
- Do not clear phydev->drv before device-core teardown completes; this can expose NULL dereferences in concurrent attach paths and devres callbacks. Set PHY_READY only after LED setup succeeds and update the Fixes tag. (Sashiko, Jakub Kicinski.)
v2: https://lore.kernel.org/all/[email protected]/
Patch 1:
- Limit this patch to splitting phy_probe() error paths, moving the SFP teardown fixes to Patch 2.
Patch 2 (new):
- makes SFP and port setup unwind their resources in the required order.
- Add phy_sfp_release() for complete SFP teardown instead of open-coding sfp_bus_del_upstream(). (Andrew Lunn, Maxime Chevallier.)
Patch 3 (new):
- Restore PHY_DOWN and clear phydev->drv after probe failure.
Patch 4:
- Move the former Patch 2 to Patch 4; no functional changes.
Patch 5 (new):
- Propagate errors from default port setup.
v1: https://lore.kernel.org/all/[email protected]/
Xuanqiang Luo (6):
net: phy: split phy_probe() error paths
net: phy: unregister SFP upstream before port cleanup
net: phy: set PHY_READY after LED setup
net: phy: call driver remove when core initialization fails
net: phy: propagate errors from default port setup
net: phy: avoid double-free after LED trigger registration failure
drivers/net/phy/phy_device.c | 80 ++++++++++++++++++++++-------- drivers/net/phy/phy_led_triggers.c | 11 ++-- 2 files changed, 65 insertions(+), 26 deletions(-)
base-commit: 746fc0787f616da418ffc04a110296fe95d53491
Signature · 1 line
2.43.0
PATCH v4 1/6 net: phy: split phy_probe() error paths
From: Xuanqiang Luo <[email protected]>
phy_probe() uses one cleanup path for failures at every initialization stage. This runs cleanup for resources that have not been initialized.
Split the cleanup by initialization stage so each failure path unwinds only the resources that may have been initialized.
Unregister LED triggers before releasing the SFP upstream and ports, because the LED triggers are initialized after those resources and must be unwound first.
--- drivers/net/phy/phy_device.c | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-)
drivers/net/phy/phy_device.c +11 -9
@@ -3706,7 +3706,7 @@ static int phy_probe(struct device *dev)if (phydev->drv->probe) { err = phydev->drv->probe (phydev);if (err) - goto out; + goto out_reset; }phy_disable_interrupts (phydev);
@@ -3727,7 +3727,7 @@ static int phy_probe(struct device *dev) err =genphy_read_abilities (phydev);if (err) - goto out; + goto out_reset;if (!linkmode_test_bit (ETHTOOL_LINK_MODE_Autoneg_BIT, phydev->supported))
@@ -3744,7 +3744,7 @@ static int phy_probe(struct device *dev) err =phy_setup_ports (phydev);if (err) - goto out; + goto out_sfp_release;phy_advertise_supported (phydev);
@@ -3753,7 +3753,7 @@ static int phy_probe(struct device *dev)*/ err =genphy_c45_read_eee_adv (phydev, phydev->advertising_eee);if (err) - goto out; + goto out_sfp_release;/* Get the EEE modes we want to prohibit. */ of_set_phy_eee_broken (phydev);
@@ -3806,20 +3806,22 @@ static int phy_probe(struct device *dev)if (IS_ENABLED (CONFIG_PHYLIB_LEDS ) && !phy_driver_is_genphy (phydev)) { err =of_phy_leds (phydev);if (err) - goto out; + goto out_unreg_led_triggers; }return 0 ; -out: +out_unreg_led_triggers: +if (!phydev->is_on_sfp_module) +phy_led_triggers_unregister (phydev); + +out_sfp_release:sfp_bus_del_upstream (phydev->sfp_bus); phydev->sfp_bus =NULL ;phy_cleanup_ports (phydev); -if (!phydev->is_on_sfp_module) -phy_led_triggers_unregister (phydev); - +out_reset:/* Re-assert the reset signal on error */ phy_device_reset (phydev,1 );
Signature · 1 line
2.43.0
PATCH v4 2/6 net: phy: unregister SFP upstream before port cleanup
In reply to Xuanqiang LuoFrom: Xuanqiang Luo <[email protected]>
Commit 4497f5028675 ("net: phy: Clean the phy_ports after unregistering the downstream SFP bus") established that an SFP upstream must be unregistered before its phy_ports are destroyed because SFP callbacks may access these ports.
phy_setup_ports() does not follow this order when a later port setup step fails after phy_sfp_probe() succeeds. It destroys the SFP phy_port and leaves phy_probe() to unregister the upstream later, creating a race between port destruction and SFP upstream callbacks.
The error unwind is also split across three functions. If phy_setup_sfp_port() fails, phy_sfp_probe() leaves the upstream registered and relies on phy_probe() to remove it after phy_setup_ports() returns.
Make each layer unwind the resources it successfully set up. Unregister only the upstream in phy_sfp_probe() when SFP port setup fails, since the failed port has already been destroyed. Add phy_sfp_release() for a successful SFP probe, and make phy_setup_ports() use it before cleaning up the remaining ports. Once phy_setup_ports() has rolled back all port setup, make phy_probe() skip this cleanup.
--- drivers/net/phy/phy_device.c | 49 ++++++++++++++++++++++++++++-------- 1 file changed, 38 insertions(+), 11 deletions(-)
drivers/net/phy/phy_device.c +38 -11
@@ -1723,12 +1723,41 @@ static int phy_sfp_probe(struct phy_device *phydev) phydev->sfp_bus =NULL ; } -if (!ret && phydev->sfp_bus) +if (!ret && phydev->sfp_bus) { ret =phy_setup_sfp_port (phydev); +if (ret) { +sfp_bus_del_upstream (phydev->sfp_bus); + phydev->sfp_bus =NULL ; + } + }return ret; } +/** +* phy_sfp_release - release resources set up by phy_sfp_probe() +* @phydev: the PHY device +* +* Release the SFP resources set up by a successful phy_sfp_probe(). Unregister +* the upstream before destroying its phy_port, so SFP upstream callbacks cannot +* race with port destruction. +*/ +static void phy_sfp_release (struct phy_device *phydev) +{ +struct phy_port *port, *tmp; + +sfp_bus_del_upstream (phydev->sfp_bus); + phydev->sfp_bus =NULL ; + +list_for_each_entry_safe (port, tmp, &phydev->ports, head) { +if (!port->is_sfp) +continue ; + +phy_del_port (phydev, port); +phy_port_destroy (port); + } +} +static bool phy_drv_supports_irq (const struct phy_driver *phydrv) {return phydrv->config_intr && phydrv->handle_interrupt;
@@ -3547,13 +3576,13 @@ static int phy_setup_ports(struct phy_device *phydev)if (!phydev->is_genphy_driven) { ret =phy_sfp_probe (phydev);if (ret) - goto out; + goto err_ports; }if (phydev->n_ports < phydev->max_n_ports) { ret =phy_default_setup_single_port (phydev);if (ret) - goto out; + goto err_sfp; }linkmode_zero (ports_supported);
@@ -3580,7 +3609,9 @@ static int phy_setup_ports(struct phy_device *phydev)return 0 ; -out: +err_sfp: +phy_sfp_release (phydev); +err_ports:phy_cleanup_ports (phydev);return ret; }
@@ -3744,7 +3775,7 @@ static int phy_probe(struct device *dev) err =phy_setup_ports (phydev);if (err) - goto out_sfp_release; + goto out_reset;phy_advertise_supported (phydev);
@@ -3816,9 +3847,7 @@ static int phy_probe(struct device *dev)phy_led_triggers_unregister (phydev); out_sfp_release: -sfp_bus_del_upstream (phydev->sfp_bus); - phydev->sfp_bus =NULL ; - +phy_sfp_release (phydev);phy_cleanup_ports (phydev); out_reset:
@@ -3842,9 +3871,7 @@ static int phy_remove(struct device *dev) phydev->state =PHY_DOWN ; -sfp_bus_del_upstream (phydev->sfp_bus); - phydev->sfp_bus =NULL ; - +phy_sfp_release (phydev);phy_cleanup_ports (phydev);if (phydev->drv && phydev->drv->remove)
Signature · 1 line
2.43.0
PATCH v4 3/6 net: phy: set PHY_READY after LED setup
In reply to Xuanqiang LuoFrom: Xuanqiang Luo <[email protected]>
phy_probe() sets PHY_READY before calling of_phy_leds(). If LED setup fails, the error path releases the initialized resources while the PHY state remains READY even though probing failed.
Set PHY_READY only after LED setup succeeds.
--- drivers/net/phy/phy_device.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)
drivers/net/phy/phy_device.c +3 -3
@@ -3824,9 +3824,6 @@ static int phy_probe(struct device *dev) phydev->supported); } -/* Set the state to READY by default */ - phydev->state =PHY_READY ; -/* Register the PHY LED triggers */ if (!phydev->is_on_sfp_module)phy_led_triggers_register (phydev);
@@ -3840,6 +3837,9 @@ static int phy_probe(struct device *dev) goto out_unreg_led_triggers; } +/* Set the state to READY by default */ + phydev->state =PHY_READY ; +return 0 ; out_unreg_led_triggers:
Signature · 1 line
2.43.0
PATCH v4 4/6 net: phy: call driver remove when core initialization fails
In reply to Xuanqiang LuoFrom: Xuanqiang Luo <[email protected]>
phy_probe() may fail while querying features or completing other core initialization after the PHY driver probe callback has succeeded. The driver core does not run the remove path after a probe error, so resources that the PHY driver releases in its remove callback are leaked.
Call the PHY driver remove callback on these failures.
--- drivers/net/phy/phy_device.c | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-)
drivers/net/phy/phy_device.c +6 -2
@@ -3758,7 +3758,7 @@ static int phy_probe(struct device *dev) err =genphy_read_abilities (phydev);if (err) - goto out_reset; + goto out_remove;if (!linkmode_test_bit (ETHTOOL_LINK_MODE_Autoneg_BIT, phydev->supported))
@@ -3775,7 +3775,7 @@ static int phy_probe(struct device *dev) err =phy_setup_ports (phydev);if (err) - goto out_reset; + goto out_remove;phy_advertise_supported (phydev);
@@ -3850,6 +3850,10 @@ static int phy_probe(struct device *dev)phy_sfp_release (phydev);phy_cleanup_ports (phydev); +out_remove: +if (phydev->drv->remove) + phydev->drv->remove (phydev); + out_reset:/* Re-assert the reset signal on error */ phy_device_reset (phydev,1 );
Signature · 1 line
2.43.0
PATCH v4 5/6 net: phy: propagate errors from default port setup
In reply to Xuanqiang LuoFrom: Xuanqiang Luo <[email protected]>
phy_default_setup_single_port() ignores errors from phy_add_port() and always reports success. If a PHY driver attach_mdi_port() callback fails, the phy_port is leaked and PHY probing continues without the expected default port.
Destroy the port and return the error.
--- drivers/net/phy/phy_device.c | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-)
drivers/net/phy/phy_device.c +5 -2
@@ -3483,6 +3483,7 @@ static int phy_default_setup_single_port(struct phy_device *phydev) {struct phy_port *port =phy_port_alloc ();unsigned long mode; +int ret;if (!port)return -ENOMEM ;
@@ -3509,9 +3510,11 @@ static int phy_default_setup_single_port(struct phy_device *phydev) port->pairs =max_t (int, port->pairs,ethtool_linkmode_n_pairs (mode)); -phy_add_port (phydev, port); + ret =phy_add_port (phydev, port); +if (ret) +phy_port_destroy (port); -return 0 ; +return ret; }static int of_phy_ports (struct phy_device *phydev)
Signature · 1 line
2.43.0
Re: [PATCH net v4 5/6] net: phy: propagate errors from default port setup
Quoted 7 lines · Xuanqiang Luo
From: Xuanqiang Luo <[email protected]>
phy_default_setup_single_port()ignores errors fromphy_add_port()and always reports success. If a PHY driverattach_mdi_port()callback fails, thephy_portis leaked and PHY probing continues without the expected default port.
Quoted 5 lines
Destroy the port and return the error.
Fixes 589e934d2735 ("net: phy: Introduce PHY ports representation")Reviewed-by Andrew Lunn <[email protected]>Signed-off-by Xuanqiang Luo <[email protected]>
I realized I made a mistake.
The Reviewed-by tag added to patch 5/6 should be:
Maxime Chevallier <[email protected]>
rather than:
Andrew Lunn <[email protected]>
Sorry for the mistake. I will send a corrected version after 24 hours.
Thanks,
Xuanqiang
PATCH v4 6/6 net: phy: avoid double-free after LED trigger registration failure
In reply to Xuanqiang LuoFrom: Xuanqiang Luo <[email protected]>
When a speed trigger registration fails, phy_led_triggers_register() frees phy_led_triggers but leaves the pointer set to the freed allocation. It then clears phy_num_led_triggers.
phy_probe() ignores this error. If device-tree LED setup then fails, its error path calls phy_led_triggers_unregister(). The zero trigger count skips the per-trigger unregister loop, but the helper still frees the dangling pointer.
Clear the pointer after partial registration cleanup and make phy_led_triggers_unregister() walk and free the array only while it is present.
--- drivers/net/phy/phy_led_triggers.c | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-)
drivers/net/phy/phy_led_triggers.c +7 -4
@@ -126,6 +126,7 @@ int phy_led_triggers_register(struct phy_device *phy)while (i--)phy_led_trigger_unregister (&phy->phy_led_triggers[i]);kfree (phy->phy_led_triggers); + phy->phy_led_triggers =NULL ; out_unreg_link:phy_led_trigger_unregister (phy->led_link_trigger); out_free_link:
@@ -141,10 +142,12 @@ void phy_led_triggers_unregister(struct phy_device *phy) {int i; -for (i =0 ; i < phy->phy_num_led_triggers; i++) -phy_led_trigger_unregister (&phy->phy_led_triggers[i]); -kfree (phy->phy_led_triggers); - phy->phy_led_triggers =NULL ; +if (phy->phy_led_triggers) { +for (i =0 ; i < phy->phy_num_led_triggers; i++) +phy_led_trigger_unregister (&phy->phy_led_triggers[i]); +kfree (phy->phy_led_triggers); + phy->phy_led_triggers =NULL ; + }if (phy->led_link_trigger) {phy_led_trigger_unregister (phy->led_link_trigger);
Signature · 1 line
2.43.0