STRUCT MXL862XX_XPCS_AN_RESTART(9)

okay bestie, welcome to the Kernel API Manual 💖 — this is the page for struct mxl862xx_xpcs_an_restart, aka the tiny struct with a very specific job: asking firmware to restart auto-negotiation on one sub-port. it’s giving “small but booked and busy” energy, and we’re gonna read it together 💅

🎀 NAME 🎀

struct mxl862xx_xpcs_an_restart — AN restart parameters ✨

✨ SYNOPSIS ✨

struct mxl862xx_xpcs_an_restart {
    __le16 mode;
    __le16 result;
 };

🧩 Members 🧩

• mode — packed input parameters, see MXL862XX_XPCS_ANR_*. port_id is the XPCS port index (0-3); interface is the PCS interface mode (MXL862XX_XPCS_IF_*); usx_lane_mode is the USX lane mode (MXL862XX_XPCS_USX_*); usx_subport (0-3) selects the lane whose AN is restarted for QSGMII and QUSXGMII and is ignored by single-lane modes.
• result — firmware result. 0 on success, <0 on error.

💫 Description 💫

Restarts auto-negotiation on a single sub-port of the XPCS. The SERDES must already be configured.

⚠️ bestie, this is not a from-scratch setup moment: the SERDES must already be configured before this call makes sense. no cap.

👀 SEE ALSO 👀

Kernel file: ./drivers/net/dsa/mxl862xx/mxl862xx-api.h — go peek at the source, bestie 😌. Also these API icons are linked:

• struct mdio_relay_data(9)
• struct mxl862xx_register_mod(9)
• enum mxl862xx_mac_table_filter(9)
• struct mxl862xx_mac_table_add(9)
• struct mxl862xx_mac_table_remove(9)
• struct mxl862xx_mac_table_read(9)
• struct mxl862xx_mac_table_query(9)
• enum mxl862xx_mac_clear_type(9)
• struct mxl862xx_mac_table_clear(9)
• enum mxl862xx_age_timer(9)
• struct mxl862xx_bridge_alloc(9)
• enum mxl862xx_bridge_config_mask(9)
• enum mxl862xx_bridge_port_egress_meter(9)
• struct mxl862xx_qos_meter_cfg(9)
• enum mxl862xx_bridge_forward_mode(9)
• struct mxl862xx_bridge_config(9)
• struct mxl862xx_bridge_port_alloc(9)
• enum mxl862xx_bridge_port_config_mask(9)
• enum mxl862xx_color_marking_mode(9)
• enum mxl862xx_color_remarking_mode(9)
• enum mxl862xx_pmapper_mapping_mode(9)
• struct mxl862xx_pmapper(9)
• struct mxl862xx_bridge_port_config(9)
• struct mxl862xx_cfg(9)
• enum mxl862xx_extended_vlan_filter_type(9)
• enum mxl862xx_extended_vlan_filter_tpid(9)
• enum mxl862xx_extended_vlan_filter_dei(9)
• enum mxl862xx_extended_vlan_treatment_remove_tag(9)
• enum mxl862xx_extended_vlan_treatment_priority(9)
• enum mxl862xx_extended_vlan_treatment_vid(9)
• enum mxl862xx_extended_vlan_treatment_tpid(9)
• enum mxl862xx_extended_vlan_treatment_dei(9)
• enum mxl862xx_extended_vlan_4_tpid_mode(9)
• enum mxl862xx_extended_vlan_filter_ethertype(9)
• struct mxl862xx_extendedvlan_filter_vlan(9)
• struct mxl862xx_extendedvlan_filter(9)
• struct mxl862xx_extendedvlan_treatment_vlan(9)
• struct mxl862xx_extendedvlan_treatment(9)
• struct mxl862xx_extendedvlan_alloc(9)
• struct mxl862xx_extendedvlan_config(9)
• enum mxl862xx_vlan_filter_tci_mask(9)
• struct mxl862xx_vlanfilter_alloc(9)
• struct mxl862xx_vlanfilter_config(9)
• enum mxl862xx_ss_sp_tag_mask(9)
• enum mxl862xx_ss_sp_tag_rx(9)
• enum mxl862xx_ss_sp_tag_tx(9)
• enum mxl862xx_ss_sp_tag_rx_pen(9)
• struct mxl862xx_ss_sp_tag(9)
• enum mxl862xx_logical_port_mode(9)
• struct mxl862xx_ctp_port_assignment(9)
• enum mxl862xx_stp_port_state(9)
• struct mxl862xx_stp_port_cfg(9)
• struct mxl862xx_sys_fw_image_version(9)
• enum mxl862xx_port_type(9)
• enum mxl862xx_rmon_port_type(9)
• struct mxl862xx_rmon_port_cnt(9)
• union mxl862xx_xpcs_an_word(9)
• enum mxl862xx_xpcs_loopback_mode(9)
• struct mxl862xx_xpcs_pcs_cfg(9)
• struct mxl862xx_xpcs_pcs_state(9)
• struct mxl862xx_xpcs_pcs_disable(9)
• struct mxl862xx_xpcs_pcs_link_up(9)

xoxo, your Kernel API Manual bestie 💖 — source ./drivers/net/dsa/mxl862xx, dated October 2026, for the struct mxl8...s_an_restart(9) page. byeee 🦋✨