phy_restore_page(9)

💖 phy_restore_page — the kernel API glow-up 🦋

okay so this is from the Kernel API Manual bestie, and it's literally the cleanup function you call after you've been messing with PHY pages. it puts the page register back and drops the bus lock. very "leave it how you found it" of her 💅

---

✨ NAME ✨

phy_restore_page — restore the page register and release the bus lock 🎀

🌸 SYNOPSIS 🌸

int phy_restore_page (struct phy_device *phydev , int oldpage , int ret );

🦋 ARGUMENTS 🦋

• phydev — a pointer to a struct phy_device 👑 like, the device in question.
• oldpage — the old page 🎯 this is the return value from phy_save_page or phy_select_page, so don't just make one up.
• ret — the operation's return code 📋 whatever the thing you were doing handed back.

💜 DESCRIPTION 💜

so what she does is release the MDIO bus lock, restoring oldpage if it's a valid page ✨ and yes she does both, she's a multi-tasker.

also important: this function propagates the earliest error code from the group of operations. so if something went wrong first, that's the error you're getting back. no cap 🙈

🌈 RETURN 🌈

okay so the return value is a little priority list, pay attention bestie 👀:

1. oldpage — if it was a negative value 😭
2. otherwise ret — if it was a negative errno value
3. otherwise phy_write_page's negative value — if it were in error
4. otherwise ret 🫶

so like, first negative thing wins. that's the whole vibe check.

⭐ SEE ALSO ⭐

kernel file ./drivers/net/phy/phy-core.c — and omg the friend group is huge, here's everyone 🧚:

• phy_speed_to_str(9)
• phy_duplex_to_str(9)
• phy_rate_matching_to_str(9)
• phy_fix_phy_mode_for_mac_delays(9)
• phy_interface_num_ports(9)
• phy_set_max_speed(9)
• of_set_phy_timing_role(9)
• phy_resolve_aneg_pause(9)
• phy_resolve_aneg_linkmode(9)
• phy_check_downshift(9)
• __phy_read_mmd(9)
• phy_read_mmd(9)
• __phy_write_mmd(9)
• phy_write_mmd(9)
• phy_modify_changed(9)
• __phy_modify(9)
• phy_modify(9)
• __phy_modify_mmd_changed(9)
• phy_modify_mmd_changed(9)
• __phy_modify_mmd(9)
• phy_modify_mmd(9)
• phy_save_page(9)
• phy_select_page(9)
• phy_read_paged(9)
• phy_write_paged(9)
• phy_modify_paged_changed(9)
• phy_modify_paged(9)

---

lowkey the whole phy_save_page → phy_select_page → phy_restore_page trio is giving main character energy. save, select, restore. iconic 💅

and that's the page!! 🌸 from ./drivers/net/phy, dated October 2026, brought to you by the phy_restore_page(9) girlies — mwah, love u, go restore those pages responsibly 💖🎀🦋