STRUCT GFAR_PRIV_RX_Q(9)

💖 struct gfar_priv_rx_q(9) 💖

okay so bestie, welcome to the Kernel API Manual, section 9 — this is the whole entire page for struct gfar_priv_rx_q, aka the per rx queue structure ✨ like, one (1) receive queue's whole personality in a single C struct. she's giving main character energy and honestly she ate 🎀

✨ SYNOPSIS ✨

struct gfar_priv_rx_q {
    struct gfar_rx_buff *rx_buff;
    struct rxbd8 *rx_bd_base;
    struct net_device *ndev;
    struct device *dev;
    u16 rx_ring_size;
    u16 qindex;
    struct gfar_priv_grp *grp;
    u16 next_to_clean;
    u16 next_to_use;
    u16 next_to_alloc;
    struct sk_buff *skb;
    struct rx_q_stats stats;
    u32 __iomem *rfbptr;
    unsigned char rxcoalescing;
    unsigned long rxic;
    dma_addr_t rx_bd_dma_base;
};

like, there she is. no cap, that's the whole struct 💅

🌸 Members 🌸

so the page spells out some of these for us, and the rest are just… vibing in the struct with no narration (iykyk). going in order, here's what the doc actually tells us:

• rx_buff — array of buffer info metadata structs 🦋 the little info cards for each buffer, basically
• rx_bd_base — first rx buffer descriptor ⭐ like, the starting point of the descriptor lineup
• ndev — back pointer to net_device 👑 a little pointer that leads back home
• dev — (it's in the struct! the page doesn't say anything else about it, so neither will I 🙈)
• rx_ring_size — Rx ring size 💀 yes the ring. the ring size. that's the whole description and I respect the brevity
• qindex — index of this queue 🔥 which queue this is, numerically
• grp — (present in the struct, no description given — she's mysterious ✨)
• next_to_clean — index of the next buffer to be cleaned 🧹 the one you're gonna clean next
• next_to_use — index of the next buffer to be alloc'd 🎀 the one that's up next to get allocated
• next_to_alloc — (again, in the struct with no write-up — cute, private, no notes 💅)
• skb — (listed in the struct, undisclosed lore 🫶)
• stats — a struct rx_q_stats, hanging out in there without a description 🌈
• rfbptr — also undescribed! it's a u32 __iomem * and that's all we get 😭
• rxcoalescing — enable/disable rx-coalescing ⭐ the on/off switch, that's it that's the job
• rxic — receive interrupt coalescing value 🔥 (the page spells it "vlaue" and honestly? iconic typo, we stan)
• rx_bd_dma_base — (in the struct, no description given — leaving us on read 😔)

real talk: if a member shows up in the struct but the Members list doesn't explain it, I'm not making up lore for it. no invented facts on this page, periodt 💖 just telling you it's there.

🦋 SEE ALSO 🦋

• Kernel file ./drivers/net/ethernet/freescale/gianfar.h struct gfar_priv_tx_q(9), struct gfar_priv_grp(9) — go read the tx queue's page and the group's page too, they're literally her besties 🌸

and that's the page!! 🎀 this little beauty lives over at ./drivers/net/ethernet/freescale, dated October 2026, and yes the header up top really does say struct gfar_priv_rx_q(9) — ty for coming to my ted talk, mwah 💜🫶