pcs_link_up(9)

💅 pcs_link_up — program the PCS for the resolved link configuration

Okay bestie, welcome to the pcs_link_up(9) page — straight out of the Kernel API Manual, no cap. Let's get into it. 🦋

✨ SYNOPSIS ✨

void pcs_link_up (struct phylink_pcs *pcs , unsigned int neg_mode ,
       phy_interface_t interface , int speed , int duplex );

🎀 ARGUMENTS 🎀

• pcs — a pointer to a struct phylink_pcs. Your main character struct, literally. 💖
• neg_mode — the link negotiation mode (peep the DESCRIPTION below, it's all explained there 👀).
• interface — the link's typedef phy_interface_t mode.
• speed — the link speed. Zoom zoom. 🔥
• duplex — the link duplex.

🌸 DESCRIPTION 🌸

So this call gets made just before mac_link_up, and its whole job is to inform the PCS of the resolved link parameters. Think of it as the little heads-up text before the main event 🫶.

Real talk on when it actually matters: a PCS operating in SGMII mode without in-band AN needs to be manually configured for the link and duplex setting. That's the case where this is doing the work. Otherwise? It should be a no-op — literally just vibing, doing nothing. 😌

Now, the mode argument — you should test that via the phylink_mode_*() family of functions. Or, for a PCS that sets pcs->neg_mode to true, you test it against the PHYLINK_PCS_NEG_* definitions instead. Pick the right one for your setup, don't mix and match bestie. 💅

👑 SEE ALSO 👑

• 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_an_restart(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 whole page, bestie ✨ 🧚 This one lives under ./include/linux, dated October 2026 — so like, future vibes fr fr. Go configure that PCS and slay. 💀🎀