STRUCT LIBETH_SQE(9)

💅 struct libeth_sqe(9) 💅

okay bestie, buckle up — this is a page from the Kernel API Manual, and it's genuinely one of the cuter little structs in the networking corner of the kernel. it represents a Send Queue Element / Tx buffer, which is exactly what it sounds like: one entry in your Tx ring, holding everything the driver needs to send a thing and then clean up after itself. no cap. 🎀

---

✨ NAME ✨

struct libeth_sqe — represents a Send Queue Element / Tx buffer 🦋

---

🌸 SYNOPSIS 🌸

struct libeth_sqe {
    enum libeth_sqe_type            type:32;
    u32 rs_idx;
    union {
      void *raw;
      struct sk_buff                  *skb;
      struct skb_shared_info          *sinfo;
      struct xdp_frame                *xdpf;
      struct libeth_xdp_buff          *xsk;
    };
    dma_addr_t dma;
    __u32 len;
    u32 nr_frags;
    u32 packets;
    u32 bytes;
    unsigned long                   priv;
 };

like… look at her. she's got range. 😭💖

---

👑 MEMBERS 👑

• type — the type of the buffer, see the enum above (enum libeth_sqe_type, iykyk). this is the field that tells you which member of the union down there is actually the real one. main character energy fr fr. ⭐
• rs_idx — index of the last buffer from the batch this one was sent in 🌈
• {unnamed_union} — anonymous. yeah, she has no name. mysterious. iconic. 💅
  • raw — slab buffer to free via kfree 🍓
  • skb — sk_buff to consume 🌸
  • sinfo — skb shared info of an XDP_TX frame 🔥
  • xdpf — XDP frame from ::ndo_xdp_xmit ⚡
  • xsk — XSk Rx frame from XDP_TX action 🦋
• dma — DMA address to unmap 🎀
• len — length of the mapped region to unmap 💜
• nr_frags — number of frags in the frame this buffer belongs to ✨
• packets — number of physical packets sent for this frame 👑
• bytes — number of physical bytes sent for this frame 🌟
• priv — driver-private scratchpad 🙈 (the driver's own little diary entry, basically)

heads up bestie: type is the vibe check for the whole struct — it's what tells you which union member is valid. don't go reading skb when it's actually an xdpf, that's not slay behaviour. 💀

---

🔍 SEE ALSO 🔍

• Kernel file ./include/net/libeth/tx.h
• enum libeth_sqe_type(9)
• LIBETH_SQE_CHECK_PRIV(9)
• struct libeth_cq_pp(9)
• libeth_tx_complete(9)

go read those next, bestie, they're all part of the same little friend group 🫶🧚

---

and that's the page!! this one lives in ./include/net/libeth and it's dated October 2026 — so yeah, she's from the future, we stan a forward-thinking struct 💖✨🎀