STRUCT EFX_TC_STATE(9)

✨ NAME ✨

okay so welcome to the Kernel API Manual page for struct efx_tc_state(9), bestie. This struct is the control plane data for TC offload — literally the state bundle for TC offload’s control-plane side. Think of it as the group-chat admin panel for all the offload bookkeeping. 💅

🦋 SYNOPSIS 🦋

here’s the whole struct, no cap:

struct efx_tc_state {
    struct mae_caps *caps;
    struct list_head block_list;
    struct mutex mutex;
    struct rhashtable counter_ht;
    struct rhashtable counter_id_ht;
    struct rhashtable encap_ht;
    struct rhashtable mac_ht;
    struct rhashtable encap_match_ht;
    struct rhashtable match_action_ht;
    struct rhashtable lhs_rule_ht;
    struct rhashtable ct_zone_ht;
    struct rhashtable ct_ht;
    struct rhashtable neigh_ht;
    struct rhashtable recirc_ht;
    struct ida recirc_ida;
    struct efx_tc_table_ct meta_ct;
    u32 reps_mport_id, reps_mport_vport_id;
    s32 reps_filter_uc, reps_filter_mc;
    bool flush_counters;
    u32 flush_gen[EFX_TC_COUNTER_TYPE_MAX];
    u32 seen_gen[EFX_TC_COUNTER_TYPE_MAX];
    wait_queue_head_t flush_wq;
    struct {
      struct efx_tc_flow_rule pf;
      struct efx_tc_flow_rule wire;
    } dflt;
    struct {
      struct efx_tc_action_set_list pf;
      struct efx_tc_action_set_list reps;
    } facts;
    bool up;
 };

🎀 Members 🎀

every member is doing its little main-character job, so let’s give them their moment:

• caps — the MAE capabilities reported by MCDI. it’s giving “what firmware says is possible” energy. ✨
• block_list — a list of struct efx_tc_block_binding entries. 🎀
• mutex — the mutex used to serialise operations on the TC hashtables. don’t touch the hashtables without it, bestie. 💅
• counter_ht — hashtable of TC counters (FW IDs and counter values). 🍓
• counter_id_ht — hashtable mapping TC counter cookies to counters. iykyk. 🍪
• encap_ht — hashtable of TC encap actions. 🦋
• mac_ht — hashtable of MAC address entries, specifically for pedits. 🌸
• encap_match_ht — hashtable of TC encap matches. ✨
• match_action_ht — hashtable of TC match-action rules. 🔥
• lhs_rule_ht — hashtable of TC left-hand rules, aka the act ct & goto chain kind. 👑
• ct_zone_ht — hashtable of TC conntrack flowtable bindings. 🌈
• ct_ht — hashtable of TC conntrack flow entries. ⭐
• neigh_ht — hashtable of neighbour watches (struct efx_neigh_binder). 👀
• recirc_ht — hashtable of recirculation ID mappings (struct efx_tc_recirc_id). 🔁
• recirc_ida — the recirculation ID allocator. 🎟️
• meta_ct — MAE table layout for the conntrack table. 📋
• reps_mport_id — the MAE port allocated for representor RX. 📬
• reps_mport_vport_id — the vport_id for representor RX filters. 🫶
• reps_filter_uc — VNIC filter for representor unicast RX (promisc). 🦄
• reps_filter_mc — VNIC filter for representor multicast RX (allmulti). 🌟
• flush_counters — counters have been stopped, waiting for drain. not the fun kind of waiting. 😭
• flush_gen — final generation count per type array, as reported by MC_CMD_MAE_COUNTERS_STREAM_STOP. 💀
• seen_gen — most recent generation count per type, as seen by efx_tc_rx. 👁️
• flush_wq — wait queue used by efx_mae_stop_counters to wait for the MAE counters RXQ to finish draining. 🚰
• dflt — match-action rules for default switching, sitting at priority EFX_TC_PRIO_DFLT. named by ingress port. 💫
  • dflt.pf — rule for traffic ingressing from PF (egresses to wire). 🛰️
  • dflt.wire — rule for traffic ingressing from wire (egresses to PF). 🧵
• facts — fallback action-set-lists for unready rules. named by egress port. 🧚
  • facts.pf — action-set-list for unready rules on PF netdev, hence applying to traffic from wire, and egressing to PF. 🌸
  • facts.reps — action-set-list for unready rules on representors, hence applying to traffic from representees, and egressing to the reps mport. 💜
• up — have the TC datastructures been set up? the ultimate vibe check. ✅

🌈 SEE ALSO 🌈

• Kernel file ./drivers/net/ethernet/sfc/tc.h struct efx_tc_mac_pedit_action(9), struct efx_tc_action_set(9), enum efx_tc_em_pseudo_type(9) — go read those next, bestie. 🫶

signed with love from the ./drivers/net/ethernet/sfc source, October 2026 — struct efx_tc_state(9) forever, periodt 💖🎀✨