STRUCT IDPF_RX_QUEUE(9)

🌸 NAME 🌸

struct idpf_rx_queue — software structure representing a receive queue.

hii bestie 💖 this is the struct idpf_rx_queue(9) page from the Kernel API Manual, and it's literally the software structure representing a receive queue. no cap. we're gonna go through every single member together, including the anonymous unions, because we do not skip lore in this group chat 💅

✨ SYNOPSIS ✨

       struct idpf_rx_queue {
           __cacheline_group_begin_aligned(read_mostly);
           union {
             union virtchnl2_rx_desc *rx;
             struct virtchnl2_singleq_rx_buf_desc *single_buf;
             void *desc_ring;
           };
           union {
             struct {
               struct idpf_bufq_set *bufq_sets;
               struct napi_struct *napi;
               struct bpf_prog *xdp_prog;
             };
             struct {
               struct libeth_fqe *rx_buf;
               struct page_pool *pp;
               void __iomem *tail;
             };
           };
           unsigned long flags[BITS_TO_LONGS( __IDPF_Q_FLAGS_NBITS)];
           u16 idx;
           u16 desc_count;
           u32 num_xdp_txq;
           union {
             struct idpf_tx_queue **xdpsqs;
             struct {
               u32 rxdids;
               u32 truesize;
             };
           };
           const struct libeth_rx_pt *rx_ptype_lkup;
           struct xdp_rxq_info xdp_rxq;
           __cacheline_group_end_aligned(read_mostly);
           __cacheline_group_begin_aligned(read_write);
           u32 next_to_use;
           u32 next_to_clean;
           u32 next_to_alloc;
           union {
             struct libeth_xdp_buff_stash xdp;
             struct {
               struct libeth_xdp_buff *xsk;
               struct xsk_buff_pool *pool;
             };
           };
           u64 cached_phc_time;
           struct u64_stats_sync stats_sync;
           struct idpf_rx_queue_stats q_stats;
           __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;
           u16 rx_max_pkt_size;
           __cacheline_group_end_aligned(cold);
        };

💖 Members 💖

okay bestie, here's every member, including the anonymous ones — we are not skipping a single one:

• {unnamed_union} — anonymous
  • rx — universal receive descriptor array
  • single_buf — buffer descriptor array in singleq
  • desc_ring — virtual descriptor ring address
• {unnamed_union} — anonymous
  • {unnamed_struct} — anonymous
    • bufq_sets — Pointer to the array of buffer queues in splitq mode
    • napi — NAPI instance corresponding to this queue (splitq)
    • xdp_prog — attached XDP program
  • {unnamed_struct} — anonymous
    • rx_buf — See struct libeth_fqe
    • pp — Page pool pointer in singleq mode
    • tail — Tail offset. Used for both queue models single and split.
• flags — See enum idpf_queue_flags_t
• idx — For RX queue, it is used to index to total RX queue across groups and used for skb reporting.
• desc_count — Number of descriptors
• num_xdp_txq — total number of XDP Tx queues
• {unnamed_union} — anonymous
  • xdpsqs — shortcut for XDP Tx queues array
  • {unnamed_struct} — anonymous
    • rxdids — Supported RX descriptor ids
    • truesize — data buffer truesize in singleq
• rx_ptype_lkup — LUT of Rx ptypes
• xdp_rxq — XDP queue info
• next_to_use — Next descriptor to use
• next_to_clean — Next descriptor to clean
• next_to_alloc — RX buffer to allocate at
• {unnamed_union} — anonymous
  • xdp — XDP buffer with the current frame
  • {unnamed_struct} — anonymous
    • xsk — current XDP buffer in XSk mode
    • pool — XSk pool if installed
• cached_phc_time — Cached PHC time for the Rx queue
• stats_sync — See struct u64_stats_sync
• q_stats — See union idpf_rx_queue_stats
• 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
• rx_max_pkt_size — RX max packet size

and that's the whole struct, periodt 💅✨

🦋 SEE ALSO 🦋

Kernel file ./drivers/net/ethernet/intel/idpf/idpf_txrx.h plus the whole squad: 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_tx_queue(9), struct idpf_buf_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).

mwah 💋 — source/version vibes: ./drivers/net/ethernet/intel/idpf, dated October 2026, and this page is struct idpf_rx_queue(9). bye bestie, go slay those receive queues 🫶✨