phy_stop_machine(9)

📦 version 7.3.1, in nixpkgs unstable

💖 phy_stop_machine(9) 💖

okay so you're in the Kernel API Manual bestie, and we're about to talk about phy_stop_machine — say hi 👋

✨ NAME ✨

phy_stop_machine — stop the PHY state machine tracking 🛑

🌸 SYNOPSIS 🌸

void phy_stop_machine (struct phy_device *phydev );

like, that's the whole vibe. void return, one arg, no drama 💅

🎀 ARGUMENTS 🎀

  • phydev — the target struct phy_device struct 🫶 that's the one you're aiming this at, bestie

🦋 DESCRIPTION 🦋

So what does it actually do? It stops the state machine delayed workqueue. Yep — the workqueue gets shut down, that's the whole point of the function. 🛑

Then it sets the state to UP — but only unless it wasn't up yet. Like, if it was already up, cool, nothing changes; if it wasn't, it becomes UP. Either way you end up at UP, iykyk 💅

⚠️ listen to me VERY carefully: this function must be called BEFORE phy_detach. Not after. Not "eh, close enough". BEFORE. no cap, this is the rule 🔥

💜 SEE ALSO 💜

Kernel file ./drivers/net/phy/phy.c — and honestly the whole friend group showed up for this one, so here's the full squad 🫶:

and that's the page, bestie 🧚 source vibes come straight from ./drivers/net/phy, stamped October 2026, all for phy_stop_machine(9) — go forth and stop that machine at the RIGHT time 👑✨

📦 where this page comes from