STRUCT MXL862XX_PRIV(9)

✨ NAME ✨

struct mxl862xx_priv — the driver's own private little lore vault for an MxL862xx switch 💅 (this page lives in the Kernel API Manual, bestie, so you know it's official)

🌸 SYNOPSIS 🌸

struct mxl862xx_priv {
    struct dsa_switch *ds;
    struct mdio_device *mdiodev;
    struct work_struct crc_err_work;
    unsigned long flags;
    u16 drop_meter;
    struct mxl862xx_fw_version fw_version;
    struct mxl862xx_pcs serdes_ports[8];
    int serdes_refcount[2];
    struct mutex serdes_lock;
    struct mxl862xx_port ports[MXL862XX_MAX_PORTS];
    u16 bridges[MXL862XX_MAX_BRIDGES + 1];
    u16 evlan_ingress_size;
    u16 evlan_egress_size;
    u16 vf_block_size;
    struct delayed_work stats_work;
 };

Look at that struct. It's giving "organized chaos but make it iconic" 🎀 Every field is copy-pasted exactly as-is, no cap, don't touch a single character.

💅 Members 💅

okay so let's go through the whole roster, main character by main character 🌟

• ds — pointer to the DSA switch instance. That's the whole reason we're here fr fr 🦋
• mdiodev — the MDIO device we use to talk to the switch firmware. think of it as the group chat where the driver and the firmware actually communicate 😭
• crc_err_work — deferred work for shutting down all ports when MDIO CRC errors happen. yes, all of them. dramatic? absolutely. necessary? also yes 💀
• flags — atomic status flags, lowkey important:
  • MXL862XX_FLAG_CRC_ERR gets set before the CRC-triggered shutdown and cleared after it.
  • MXL862XX_FLAG_WORK_STOPPED gets set before cancelling stats_work, so nothing tries to reschedule during teardown. protective queen behavior 🫶
• drop_meter — index of the single shared zero-rate firmware meter used to unconditionally drop traffic (used to block flooding). one meter, one job, zero forgiveness ✨
• fw_version — the cached firmware version, populated at probe and compared with MXL862XX_FW_VER_MIN. vibe check for firmware, basically 🌈
• serdes_ports — SerDes interfaces incl. sub-interfaces in case of 10G_QXGMII or QSGMII. yes, the sub-interfaces too, we don't leave the siblings out 💜
• serdes_refcount — per-XPCS count of sub-ports enabled by phylink; pcs_disable powers an XPCS down when the count reaches zero. protected by serdes_lock. the count hitting zero is the whole plot twist 🔥
• serdes_lock — serializes the serdes_refcount transitions with the XPCS power-down, so a sibling sub-port enable cannot race a power-down to zero. literally the chaos-prevention lock, we stan 🎀
• ports — per-port state, indexed by switch port number. one entry per port, no skipping 🍓
• bridges — maps DSA bridge number → firmware bridge ID. a value of zero means no firmware bridge was allocated for that DSA bridge number. indexed by dsa_bridge.num (0 .. ds->max_num_bridges). careful with the range, bestie 👑
• evlan_ingress_size — per-port ingress Extended VLAN block size 🌸
• evlan_egress_size — per-port egress Extended VLAN block size 🌸 (yes, egress, they're different, don't mix them up)
• vf_block_size — per-port VLAN Filter block size ⭐
• stats_work — periodic work item that polls RMON hardware counters and accumulates them into 64-bit per-port stats. it just keeps showing up and doing the work, honestly relatable 😭💖

🦋 SEE ALSO 🦋

the whole friend group, no one left behind 🫶

• Kernel file ./drivers/net/dsa/mxl862xx/mxl862xx.h
• mxl862xx_fw_portmap_set_bit(9)
• mxl862xx_fw_portmap_clear_bit(9)
• mxl862xx_fw_portmap_is_empty(9)
• struct mxl862xx_vf_vid(9)
• struct mxl862xx_vf_block(9)
• struct mxl862xx_evlan_block(9)
• struct mxl862xx_port_stats(9)
• struct mxl862xx_port(9)
• struct mxl862xx_pcs(9)
• struct mxl862xx_fw_version(9)

ngl this whole page came from ./drivers/net/dsa/mxl862xx, dated October 2026 — so if you're reading this in the future, hey bestie, you're right on time 💖✨👑