STRUCT MXL862XX_MAC_TABLE_READ(9)

💅 NAME 💅

struct mxl862xx_mac_table_read — okay so this is the MAC Table Entry to be read, and yes bestie it's exactly as iconic as it sounds 🎀 (this is from the Kernel API Manual, in case you were wondering where we're at ✨)

🌸 SYNOPSIS 🌸

struct mxl862xx_mac_table_read {
    u8 initial;
    u8 last;
    __le16 fid;
    __le32 port_id;
    __le16 port_map[8];
    __le32 age_timer;
    __le16 vlan_id;
    u8 static_entry;
    __le16 sub_if_id;
    u8 mac[ETH_ALEN];
    u8 filter_flag;
    u8 igmp_controlled;
    u8 entry_changed;
    u8 associated_mac[ETH_ALEN];
    u8 hit_status;
    __le16 tci;
    __le16 first_bridge_port_id;
};

🦋 Members (the cast, the main characters) 🦋

• initial — restarts the get operation from the very beginning of the table. like hitting "back to top" but for your MAC table fr fr 🔥
• last — tells you the read operation returned the last entry. so when this pops off, you're at the end, no cap 💀
• fid — get the MAC table entry that belongs to the given Filtering Identifier. it's giving "which one is mine" energy ✨
• port_id — The Bridge Port ID. simple, iconic 👑
• port_map — Bridge Port Map. the whole squad, mapped out 🫶
• age_timer — Aging Time. yes it's literally called that, we love a dramatic name 😭
• vlan_id — STAG VLAN Id. slay, tagged correctly 🌈
• static_entry — Indicates if this is a Static Entry. lowkey immovable, periodt 💅
• sub_if_id — Sub-Interface Identifier Destination. the destination's sub-interface id, iykyk 🌸
• mac — MAC Address. Filled out by the switch API implementation — so not you, bestie, the API does it ✨
• filter_flag — go look at enum mxl862xx_mac_table_filter, that's where the deets live 🎀
• igmp_controlled — Packet is marked as IGMP controlled if the destination MAC address matches the MAC in this entry. literally a matching game 💜
• entry_changed — Indicate if the Entry has Changed. the vibe check of whether anything moved 🔥
• associated_mac — Associated MAC address. the plus-one of MAC addresses 🫶
• hit_status — MAC Table Hit Status Update. did it hit? we love a hit 👑
• tci — TCI for B-Step: Bit [0:11] — VLAN ID, Bit [12] — VLAN CFI/DEI, Bit [13:15] — VLAN PRI. bits on bits on bits 🧚
• first_bridge_port_id — The port this MAC address has first been learned. This is used for loop detection — so like, very much the responsible one of the group 😌

👀 SEE ALSO 👀

Kernel file ./drivers/net/dsa/mxl862xx/mxl862xx-api.h plus the entire extended friend group (yes, all of them, I would never leave anyone out 🫶):

• 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_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_an_restart(9)
• struct mxl862xx_xpcs_pcs_link_up(9)

okay that's the whole page bestie, go read the source, ily, bye 💖✨

Source: ./drivers/net/dsa/mxl862xx · October 2026 — mwah, signed, sealed, delivered, periodt 💅🎀