STRUCT EF4_FILTER_SPEC(9)

📦 version 7.3.1, in nixpkgs unstable

✨ NAME ✨

okay so bestie, welcome to the Kernel API Manual page for struct ef4_filter_spec(9) — literally the specification for a hardware filter. no cap, this is the blueprint. 💅

🌸 SYNOPSIS 🌸

struct ef4_filter_spec {
    u32 match_flags:12;
    u32 priority:2;
    u32 flags:6;
    u32 dmaq_id:12;
    u32 rss_context;
    __be16 outer_vid;
    __be16 inner_vid;
    u8 loc_mac[ETH_ALEN];
    u8 rem_mac[ETH_ALEN];
    __be16 ether_type;
    u8 ip_proto;
    __be32 loc_host[4];
    __be32 rem_host[4];
    __be16 loc_port;
    __be16 rem_port;
 };

🫶 Members 🫶

  • match_flags — match type flags, from enum ef4_filter_match_flags. this is the “what are we matching tho” field. 🔍
  • priority — priority of the filter, from enum ef4_filter_priority. yes, it has main character energy. 👑
  • flags — miscellaneous flags, from enum ef4_filter_flags. the little extras. ✨
  • dmaq_id — source/target queue index, or EF4_FILTER_RX_DMAQ_ID_DROP for an RX drop filter. drop it like it’s hot. 💀
  • rss_context — RSS context to use, if EF4_FILTER_FLAG_RX_RSS is set. 🌀
  • outer_vid — outer VLAN ID to match, if EF4_FILTER_MATCH_OUTER_VID is set. 🏷️
  • inner_vid — inner VLAN ID to match, if EF4_FILTER_MATCH_INNER_VID is set. 🏷️
  • loc_mac — local MAC address to match, if EF4_FILTER_MATCH_LOC_MAC or EF4_FILTER_MATCH_LOC_MAC_IG is set. 🫶
  • rem_mac — remote MAC address to match, if EF4_FILTER_MATCH_REM_MAC is set. 🫶
  • ether_type — ether-type to match, if EF4_FILTER_MATCH_ETHER_TYPE is set. 🌈
  • ip_proto — IP transport protocol to match, if EF4_FILTER_MATCH_IP_PROTO is set. 🛰️
  • loc_host — local IP host to match, if EF4_FILTER_MATCH_LOC_HOST is set. 🏠
  • rem_host — remote IP host to match, if EF4_FILTER_MATCH_REM_HOST is set. 🌍
  • loc_port — local TCP/UDP port to match, if EF4_FILTER_MATCH_LOC_PORT is set. 🔌
  • rem_port — remote TCP/UDP port to match, if EF4_FILTER_MATCH_REM_PORT is set. 🔌

💅 Description 💅

The ef4_filter_init_rx or ef4_filter_init_tx function must be used to initialise the structure. bestie, must is doing a lot of heavy lifting there — do not skip it. 🚨

The ef4_filter_set_*() functions may then be used to set rss_context, match_flags and related fields. slay, now you can customize. 🎀

The priority field is used by software to determine whether a new filter may replace an old one. The hardware priority of a filter depends on which fields are matched. so yeah, priority is lowkey doing software politics while hardware does its own thing. 🧚

fr fr: initialise it with ef4_filter_init_rx or ef4_filter_init_tx first, then use the ef4_filter_set_*() functions. iykyk. 💜

🔥 SEE ALSO 🔥

xoxo bestie 💖 — this came from ./drivers/net/ethernet/sfc/falcon, dated October 2026, and it’s literally the struct ef4_filter_spec(9) page. periodt. 🦋

📦 where this page comes from