plca_check_valid(9)

🌸 NAME 🌸

plca_check_valid — Check PLCA configuration before enabling 💅

okay bestie, welcome to plca_check_valid(9) from the Kernel API Manual — yes, that's the manual name, and it's living right here near the top instead of the big copied header line. This one is the pre-enable vibe check for PLCA config, fr fr. 🫶

---

✨ SYNOPSIS ✨

int plca_check_valid (struct phy_device *phydev , const struct
phy_plca_cfg *plca_cfg , struct netlink_ext_ack *extack );

That's the whole signature, bestie — keep it exactly like that. 🎀

---

🎀 ARGUMENTS 🎀

• phydev — the phy_device struct. literally the PHY device in question. 🦋
• plca_cfg — the current PLCA configuration. yes, the config being checked. 💖
• extack — the extack for reporting useful error messages. it's giving helpful-error-message energy. ✨

---

🔥 DESCRIPTION 🔥

Checks whether the PLCA and PHY configuration are consistent and it is safe to enable PLCA. Returns 0 on success or a negative value if the PLCA or PHY configuration is not consistent.

No cap: consistency is the whole assignment here. If the PLCA and PHY configuration are consistent and it's safe to enable PLCA, you get 0. If the PLCA or PHY configuration is not consistent, you get a negative value, periodt. 💀

bestie, this is the pre-enable vibe check. don't skip it and then act surprised, iykyk. 💅

---

🦋 SEE ALSO 🦋

Here's the whole squad, all references exactly as they came, no skipping the "boring" ones:

• Kernel file: ./drivers/net/phy/phy.c
• phy_print_status(9)
• phy_get_rate_matching(9)
• phy_config_interrupt(9)
• phy_restart_aneg(9)
• phy_aneg_done(9)
• phy_supported_speeds(9)
• phy_check_valid(9)
• phy_sanitize_settings(9)
• phy_mii_ioctl(9)
• phy_do_ioctl(9)
• phy_do_ioctl_running(9)
• __phy_hwtstamp_get(9)
• __phy_hwtstamp_set(9)
• phy_queue_state_machine(9)
• phy_trigger_machine(9)
• phy_ethtool_get_strings(9)
• phy_ethtool_get_sset_count(9)
• phy_ethtool_get_stats(9)
• __phy_ethtool_get_phy_stats(9)
• __phy_ethtool_get_link_ext_stats(9)
• phy_ethtool_get_plca_cfg(9)
• phy_ethtool_set_plca_cfg(9)
• phy_ethtool_get_plca_status(9)
• phy_start_cable_test(9)
• phy_start_cable_test_tdr(9)
• phy_check_link_status(9)
• phy_inband_caps(9)
• phy_config_inband(9)
• _phy_start_aneg(9)
• phy_start_aneg(9)
• phy_speed_down(9)
• phy_speed_up(9)
• phy_start_machine(9)
• phy_stop_machine(9)
• phy_error(9)
• phy_write_barrier(9)
• phy_disable_interrupts(9)
• phy_interrupt(9)
• phy_enable_interrupts(9)
• phy_update_stats(9)
• phy_request_interrupt(9)
• phy_free_interrupt(9)
• phy_get_next_update_time(9)
• phy_state_machine(9)
• phy_stop(9)
• phy_start(9)
• phy_mac_interrupt(9)
• phy_loopback(9)
• phy_eee_tx_clock_stop_capable(9)
• phy_eee_rx_clock_stop(9)
• phy_init_eee(9)
• phy_get_eee_err(9)
• phy_ethtool_get_eee(9)
• phy_ethtool_set_eee_noneg(9)
• phy_ethtool_set_eee(9)
• phy_ethtool_set_wol(9)
• phy_ethtool_get_wol(9)
• phy_ethtool_nway_reset(9)

---

okay bye bestie 🫶 this page comes from ./drivers/net/phy and is dated October 2026 — that's the source/version and date sign-off, mwah 💋✨