STRUCT MXL862XX_PORT_STATS(9)

💅 struct mxl862xx_port_stats(9) — the Kernel API Manual page you didn't know you needed

okay so bestie, welcome to section 9 of the Kernel API Manual, where we're talking about struct mxl862xx_port_stats and honestly? it's a whole vibe. it's the 64-bit accumulated hardware port statistics struct, and it is carrying the entire counters operation on its back. 🫶

---

✨ NAME ✨

struct mxl862xx_port_stats — 64-bit accumulated hardware port statistics. that's it, that's the girl. 💅

---

🌸 SYNOPSIS 🌸

struct mxl862xx_port_stats {
    u64 rx_packets;
    u64 tx_packets;
    u64 rx_bytes;
    u64 tx_bytes;
    u64 rx_errors;
    u64 tx_errors;
    u64 rx_dropped;
    u64 tx_dropped;
    u64 multicast;
    u64 collisions;
    u64 rx_length_errors;
    u64 rx_crc_errors;
    u64 rx_frame_errors;
    u32 prev_rx_good_pkts;
    u32 prev_tx_good_pkts;
    u64 prev_rx_good_bytes;
    u64 prev_tx_good_bytes;
    u32 prev_rx_fcserror_pkts;
    u32 prev_rx_under_size_error_pkts;
    u32 prev_rx_oversize_error_pkts;
    u32 prev_rx_align_error_pkts;
    u32 prev_tx_dropped_pkts;
    u32 prev_rx_dropped_pkts;
    u32 prev_rx_evlan_discard_pkts;
    u32 prev_mtu_exceed_discard_pkts;
    u32 prev_tx_acm_dropped_pkts;
    u32 prev_rx_multicast_pkts;
    u32 prev_tx_coll_count;
};

look at all those fields. ✨ twenty eight of them. she's thorough, she's organized, she has a prev_ section like a notes app with folders. iykyk.

---

🦋 MEMBERS 🦋

the main character counters 👑

• rx_packets — total received packets 🎀
• tx_packets — total transmitted packets 🎀
• rx_bytes — total received bytes
• tx_bytes — total transmitted bytes
• rx_errors — total receive errors. not slay, but we count them anyway 😭
• tx_errors — total transmit errors
• rx_dropped — total received packets that got dropped
• tx_dropped — total transmitted packets that got dropped
• multicast — total received multicast packets
• collisions — total transmit collisions 💀

the error girlies 🩹

• rx_length_errors — received length errors (undersize + oversize)
• rx_crc_errors — received FCS errors
• rx_frame_errors — received alignment errors

the prev_ snapshots (the receipts) 📸

so these are all previous snapshots — the raw counter value from last time we looked, so we can do the math on the delta later. literally the "before" picture.

• prev_rx_good_pkts — previous snapshot of rx good packet counter
• prev_tx_good_pkts — previous snapshot of tx good packet counter
• prev_rx_good_bytes — previous snapshot of rx good byte counter
• prev_tx_good_bytes — previous snapshot of tx good byte counter
• prev_rx_fcserror_pkts — previous snapshot of rx FCS error counter
• prev_rx_under_size_error_pkts — previous snapshot of rx undersize error counter
• prev_rx_oversize_error_pkts — previous snapshot of rx oversize error counter
• prev_rx_align_error_pkts — previous snapshot of rx alignment error counter
• prev_tx_dropped_pkts — previous snapshot of tx dropped counter
• prev_rx_dropped_pkts — previous snapshot of rx dropped counter
• prev_rx_evlan_discard_pkts — previous snapshot of extended VLAN discard counter
• prev_mtu_exceed_discard_pkts — previous snapshot of MTU exceed discard counter
• prev_tx_acm_dropped_pkts — previous snapshot of tx ACM dropped counter
• prev_rx_multicast_pkts — previous snapshot of rx multicast counter
• prev_tx_coll_count — previous snapshot of tx collision counter

---

💜 DESCRIPTION 💜

okay so here's the lore, and it's genuinely iconic:

the firmware RMON counters are 32-bit free-running (and they're 64-bit for byte counters, because bytes are extra like that 💅). this structure holds 64-bit accumulators alongside the previous raw snapshot so that deltas can be computed across polls.

and the way it handles 32-bit wrap correctly? via unsigned subtraction. no cap. that's the whole trick. the counter rolls over, you subtract, the unsigned math Just Works™, and your numbers stay correct. periodt. 👑

ngl this is the part people mess up — the wrap handling is the reason the prev_* fields exist. respect the design. 🌈

---

👀 SEE ALSO 👀

the kernel file lives at ./drivers/net/dsa/mxl862xx/mxl862xx.h — go read it, bestie, it's giving source of truth 💖

and the whole friend group:

• 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(9)
• struct mxl862xx_pcs(9)
• struct mxl862xx_fw_version(9)
• struct mxl862xx_priv(9)

---

mwah 💋 this page came to you from ./drivers/net/dsa/mxl862xx, dated October 2026, and it's a struct mxl862xx_port_stats(9) situation through and through. go forth and poll your counters, queen. 🎀✨🦋