STRUCT LIBETH_XDP_TX_FRAME(9)

💅 `struct libeth_xdp_tx_frame` — the kernel API manual ✨

okay so bestie, welcome to the glow-up doc for struct libeth_xdp_tx_frame 🦋 this is the little struct that represents one XDP Tx element — like, one single packet-shaped unit of main character energy in the Tx ring 💖 no cap, it's giving "small struct, big job."

✨ NAME ✨

struct libeth_xdp_tx_frame — represents one XDP Tx element 🎀

🌸 SYNOPSIS 🌸

ok so the shape of it is literally this, don't touch anything, copy it exact:

struct libeth_xdp_tx_frame {
    union {
      struct {
        void *data;
        u32 len_fl;
        u32 soff;
      };
      skb_frag_t frag;
      struct {
        union {
          struct xdp_frame                *xdpf;
          dma_addr_t dma;
          struct libeth_xdp_buff          *xsk;
        };
        union {
          struct {
            u32 len;
            u32 flags;
          };
          aligned_u64 opts;
        };
      };
      struct xdp_desc                 desc;
   };
 };

like… the nesting?? the way that union inside struct inside union inside struct ate 💀 it's a whole matryoshka doll of memory layouts and honestly we stan a union that's doing the absolute most 😭

🫶 Members 🫶

let's go member by member, bestie, no skipping, i would never 🙈

{unnamed_union} — anonymous 👻 (yes it's literally anonymous, it has no name, it's the mystery icon of the struct)
{unnamed_struct} — anonymous 👻 and its struct bestie is anonymous too, iconic behavior
data — frame start pointer for XDP_TX ⭐ where the frame begins, periodt
len_fl — XDP_TX, combined flags [31:16] and len [15:0] field for speed 🔥 like, the flags live in the top bits and the length lives in the bottom bits, mashed into one field because speed matters and we love a shortcut
soff — XDP_TX, offset from data to the start of skb_shared_info 🎀 so soff = "start offset", the distance from data to where skb_shared_info begins
frag — one (non-head) frag for XDP_TX 🧚 literally one non-head frag, that's the whole vibe
{unnamed_struct} — anonymous 👻 yep, another one
{unnamed_union} — anonymous 👻 and another one, the anonymity is highkey contagious
xdpf — xdp_frame for the head frag for .ndo_xdp_xmit 👑 the head frag's xdp_frame, for when you're going through .ndo_xdp_xmit
dma — DMA address of the non-head frag for .ndo_xdp_xmit 🌈 the non-head frag's DMA address, same .ndo_xdp_xmit situation
xsk — XDP_TX for XSk, XDP buffer for any frag 💜 for XDP_TX when it's XSk, and it's the XDP buffer for any frag
{unnamed_union} — anonymous 👻 third time's the charm
{unnamed_struct} — anonymous 👻 and its anonymous struct buddy, slay
len — frag length for XSk XDP_TX and .ndo_xdp_xmit 🍓 the frag length, for XSk XDP_TX and .ndo_xdp_xmit
flags — Tx flags for the above 🦋 Tx flags for the stuff we just talked about, iykyk
opts — combined len + flags for the above for speed ⚡ combined len + flags for the above, packed together, again for speed, because nobody has time for two fields
desc — XSk xmit descriptor for direct casting ✨ the XSk xmit descriptor, there specifically so you can cast directly to it

lowkey the theme here is "pack it into one field for speed" and honestly? valid. speed is the aesthetic 💅

👑 SEE ALSO 👑

Kernel file ./include/net/libeth/xdp.h, plus this whole friend group 🌸:

and that's the whole page bestie! 🌈 this one lives in ./include/net/libeth, dated October 2026, and it's filed under struct libeth_xdp_tx_frame(9) — go forth and Tx your XDP elements with confidence, mwah 💋✨

📦 where this page comes from

nixpkgs unstable: linux-manual 7.3.1
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on 2026-11-04: a language model's rewrite of the original, under its terms