pcs_an_restart(9)

💅 pcs_an_restart(9) — the Kernel API Manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual, and no cap, it's a little one but she's important. sit down, grab a strawberry 🍓, and let's talk about restarting autoneg because we literally have to.

---

✨ NAME ✨

pcs_an_restart — restart the 802.3z BaseX autonegotiation. that's it, that's the whole job. she restarts it. iconic behavior honestly 👑

---

🌸 SYNOPSIS 🌸

void pcs_an_restart (struct phylink_pcs *pcs );

no return value (she's a void, she gives nothing back and she's valid for it), just vibes and one argument 🫶

---

🦋 ARGUMENTS 🦋

• pcs — a pointer to a struct phylink_pcs. that's your girl. that's who you're handing over. not optional, not decorative, she is the whole point 💖

---

💅 DESCRIPTION 💅

okay so here's the tea: when PCS ops are present — like, when the PCS side actually has its ops filled in — this function overrides mac_an_restart in struct phylink_mac_ops.

so if you were wondering "wait, which one runs, the mac one or the pcs one?" — it's this one. the PCS one wins. main character energy, fr fr 🌈✨

lowkey important: this only kicks in when PCS ops are present. that's the whole condition. no ops, no override. periodt 💅

---

🔥 SEE ALSO 🔥

the whole friend group, in order, no one left out of the group chat:

• Kernel file ./include/linux/phylink.h
• struct phylink_link_state(9)
• struct phylink_config(9)
• struct phylink_mac_ops(9)
• mac_get_caps(9)
• mac_select_pcs(9)
• mac_prepare(9)
• mac_config(9)
• mac_finish(9)
• mac_link_down(9)
• mac_link_up(9)
• mac_disable_tx_lpi(9)
• mac_enable_tx_lpi(9)
• mac_wol_set(9)
• struct phylink_pcs(9)
• struct phylink_pcs_ops(9)
• pcs_validate(9)
• pcs_inband_caps(9)
• pcs_enable(9)
• pcs_disable(9)
• pcs_get_state(9)
• pcs_config(9)
• pcs_link_up(9)
• pcs_disable_eee(9)
• pcs_enable_eee(9)
• pcs_pre_init(9)
• phylink_get_link_timer_ns(9)
• phylink_mac_implements_lpi(9)

---

and that's the page!! 🧚 mwah, go restart some autonegotiation responsibly.

signed, sealed, delivered by ./include/linux 💜 — dated October 2026, so she's fresh. bye bestie!! 🎀💖