STRUCT MXL862XX_MAC_TABLE_QUERY(9)

👑 struct mxl862xx_mac_table_query — Kernel API Manual ✨

okay so bestie, you know how we're straight-up living in the Kernel API Manual these days? this one's a struct page, and it's genuinely iconic: struct mxl862xx_mac_table_query is your little query packet for doing a MAC table entry lookup by key. like, you hand it a MAC and a FID, and firmware goes "found it or nah". 🎀

---

🦋 NAME 🦋

struct mxl862xx_mac_table_query — MAC Table Entry key-based lookup, no cap 💅

---

🌸 SYNOPSIS 🌸

struct mxl862xx_mac_table_query {
    u8 mac[ETH_ALEN];
    __le16 fid;
    u8 found;
    __le32 port_id;
    __le16 port_map[8];
    __le16 sub_if_id;
    __le32 age_timer;
    __le16 vlan_id;
    u8 static_entry;
    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 💖

literally every field, one by one, because we do not skip. 🫶

• mac — the MAC Address to search for — that's the input bestie, you bring this one 🍓
• fid — the Filtering Identifier, also input
• found — set by firmware: 1 if the entry was found, 0 if not. firm handshake from the firmware, we love that ✨
• port_id — Bridge Port ID — output; MSB is set if it's in portmap mode 👀
• port_map — Bridge Port Map — output; only valid for static entries, so don't come for her otherwise 💀
• sub_if_id — Sub-Interface Identifier Destination
• age_timer — Aging Time ⏳
• vlan_id — STAG VLAN Id
• static_entry — Indicates if this is a Static Entry
• filter_flag — See enum mxl862xx_mac_table_filter (input+output) — she does both directions, main character energy 🌈
• igmp_controlled — IGMP controlled flag
• entry_changed — Entry changed flag
• associated_mac — Associated MAC address
• hit_status — MAC Table Hit Status Update 🔥
• tci — TCI (VLAN ID + CFI/DEI + PRI) — input 🎀
• first_bridge_port_id — First learned bridge port

---

🧚 SEE ALSO 🧚

shoutout to the kernel file that started it all: ./drivers/net/dsa/mxl862xx/mxl862xx-api.h

and the whole extended friend group, in order, because everyone ate:

• 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)
• 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)

---

ngl that's a whole friend group and every single one is invited to the group chat 💜

and that's the page bestie, go query some MAC entries, iykyk 😭✨

---

signed, sealed, delivered from ./drivers/net/dsa/mxl862xx — October 2026 — from your favorite kernel API manual, struct mxl8..._table_query(9) 🎀 bye bestie 💖