phy_read(9)

👑 phy_read(9) — Kernel API Manual 👑

okay so bestie, this is the phy_read(9) page from the Kernel API Manual, and it’s giving “tiny convenience function with main-character energy.” no cap. 💅

🌸 NAME 🌸

phy_read — the convenience function for reading a given PHY register. yes, that’s literally the whole name vibe. 🎀

✨ SYNOPSIS ✨

int phy_read (struct phy_device *phydev , u32 regnum );

🎀 ARGUMENTS 🎀

• phydev — the phy_device struct. that’s the one, bestie. 🫶
• regnum — register number to read. in the synopsis it’s a u32, and it’s exactly what u think it is. ⭐

⚠️ NOTE ⚠️

🚨 MUST NOT be called from interrupt context, bestie. like, do not do it. the reason is that the bus read/write functions may wait for an interrupt to conclude the operation. so interrupt context is a hard no. periodt. 💀

💅 SEE ALSO 💅

okay these are the linked kernel-doc besties, and yes u need every single one. iykyk. 🦋

• Kernel file ./include/linux/phy.h
• enum phy_interface_t(9)
• phy_modes(9)
• rgmii_clock(9)
• struct mdio_bus_stats(9)
• struct mii_bus(9)
• mdiobus_alloc(9)
• enum phy_state(9)
• struct phy_c45_device_ids(9)
• struct phy_oatc14_sqi_capability(9)
• struct phy_device(9)
• struct phy_tdr_config(9)
• enum link_inband_signalling(9)
• struct phy_plca_cfg(9)
• struct phy_plca_status(9)
• struct phy_led(9)
• struct phy_mse_capability(9)
• struct phy_mse_snapshot(9)
• struct phy_driver(9)
• phy_id_compare(9)
• phy_id_compare_vendor(9)
• phy_id_compare_model(9)
• phydev_id_compare(9)
• phy_is_started(9)
• phy_driver_is_genphy(9)
• phy_disable_eee_mode(9)
• phy_can_wakeup(9)
• phy_may_wakeup(9)
• __phy_read(9)
• phy_write(9)
• __phy_write(9)
• __phy_modify_changed(9)
• phy_read_mmd_poll_timeout(9)
• __phy_set_bits(9)
• __phy_clear_bits(9)
• phy_set_bits(9)
• phy_clear_bits(9)
• __phy_set_bits_mmd(9)
• __phy_clear_bits_mmd(9)
• phy_set_bits_mmd(9)
• phy_clear_bits_mmd(9)
• phy_interrupt_is_valid(9)
• phy_polling_mode(9)
• phy_has_hwtstamp(9)
• phy_has_rxtstamp(9)
• phy_has_tsinfo(9)
• phy_has_txtstamp(9)
• phy_is_default_hwtstamp(9)
• phy_on_sfp(9)
• phy_interface_mode_is_rgmii(9)
• phy_interface_mode_is_8023z(9)
• phy_interface_is_rgmii(9)
• phy_is_pseudo_fixed_link(9)
• phy_module_driver(9)

source/version: ./include/linux · date: October 2026 · all about phy_read(9) — mwah, slay, bye bestie 💖✨