STRUCT IDPF_BUF_QUEUE(9)

💖 struct idpf_buf_queue 💖

okay so bestie, welcome to the Kernel API Manual, section 9 — this is the struct idpf_buf_queue(9) page, and it's literally the software structure representing a buffer queue. no cap, that's the whole NAME vibe. 🫶

---

🌸 NAME 🌸

struct idpf_buf_queue — the software structure representing a buffer queue, bestie. iconic behavior honestly 💅

---

✨ SYNOPSIS ✨

here's the struct in all its glory — copied exactly, don't come for me:

       struct idpf_buf_queue {
           __cacheline_group_begin_aligned(read_mostly);
           struct virtchnl2_splitq_rx_buf_desc *split_buf;
           union {
             struct {
               struct libeth_fqe *buf;
               struct page_pool *pp;
             };
             struct {
               struct libeth_xdp_buff **xsk_buf;
               struct xsk_buff_pool *pool;
             };
           };
           struct libeth_fqe *hdr_buf;
           struct page_pool *hdr_pp;
           void __iomem *tail;
           unsigned long flags[BITS_TO_LONGS( __IDPF_Q_FLAGS_NBITS)];
           u32 desc_count;
           u32 thresh;
           __cacheline_group_end_aligned(read_mostly);
           __cacheline_group_begin_aligned(read_write);
           u32 next_to_use;
           u32 next_to_clean;
           u32 next_to_alloc;
           u32 pending;
           u32 hdr_truesize;
           u32 truesize;
           __cacheline_group_end_aligned(read_write);
           __cacheline_group_begin_aligned(cold);
           u32 q_id;
           u32 size;
           dma_addr_t dma;
           struct idpf_q_vector *q_vector;
           u16 rx_buffer_low_watermark;
           u16 rx_hbuf_size;
           u16 rx_buf_size;
           __cacheline_group_end_aligned(cold);
        };

you can clock the cacheline groups in there — read_mostly, read_write, and cold — the magic is all in the block, don't skip it 👀

---

💅 MEMBERS 💅

okay now the member-by-member breakdown, because we're thorough and we ate:

• split_buf — buffer descriptor array. yes bestie, the descriptor array itself 🍓
• {unnamed_union} — anonymous. it's giving mysterious, iykyk.
• {unnamed_struct} — anonymous.
• buf — libeth_fqe for data buffers.
• pp — page_pool for data buffers.
• {unnamed_struct} — anonymous. yes, another one, we stay anonymous 💀
• xsk_buf — xdp_buff for XSk Rx buffers.
• pool — xsk_buff_pool on XSk queues.
• hdr_buf — libeth_fqe for header buffers.
• hdr_pp — page_pool for header buffers.
• tail — Tail offset.
• flags — See enum idpf_queue_flags_t.
• desc_count — Number of descriptors.
• thresh — refill threshold in XSk.
• next_to_use — Next descriptor to use.
• next_to_clean — Next descriptor to clean.
• next_to_alloc — RX buffer to allocate at.
• pending — number of buffers to refill (Xsk).
• hdr_truesize — truesize for buffer headers.
• truesize — truesize for data buffers.
• q_id — Queue id.
• size — Length of descriptor ring in bytes.
• dma — Physical address of ring.
• q_vector — Backreference to associated vector.
• rx_buffer_low_watermark — RX buffer low watermark.
• rx_hbuf_size — Header buffer size.
• rx_buf_size — Buffer size.

---

🔥 SEE ALSO 🔥

Kernel file: ./drivers/net/ethernet/intel/idpf/idpf_txrx.h

the whole bestie squad of references, all present and accounted for:

• struct idpf_tx_offload_params(9)
• struct idpf_tx_splitq_params(9)
• enum idpf_queue_flags_t(9)
• struct idpf_vec_regs(9)
• struct idpf_intr_reg(9)
• struct idpf_q_vector(9)
• struct idpf_rx_queue(9)
• struct idpf_tx_queue(9)
• struct idpf_compl_queue(9)
• struct idpf_sw_queue(9)
• struct idpf_rxq_set(9)
• struct idpf_bufq_set(9)
• struct idpf_rxq_group(9)
• struct idpf_txq_group(9)
• idpf_size_to_txd_count(9)
• idpf_tx_singleq_build_ctob(9)
• idpf_tx_splitq_build_desc(9)
• idpf_vport_intr_set_wb_on_itr(9)
• idpf_tx_splitq_get_free_bufs(9)

---

okay that's the whole vibe, bestie 💖 this page comes from the kernel source tree at ./drivers/net/ethernet/intel/idpf, dated October 2026, and it's the manual page for struct idpf_buf_queue(9). slay ✨