STRUCT PCH_GBE_RX_RING(9)

💖 NAME 💖

struct pch_gbe_rx_ring — literally the rx ring info, bestie. that's the whole vibe check.

okay so this is from the Kernel API Manual, and it's the struct that holds all the deets about a receive ring. it's giving "backstage pass to the rx queue" energy and honestly? iconic. 🎀

---

✨ SYNOPSIS ✨

struct pch_gbe_rx_ring {
    struct pch_gbe_rx_desc *desc;
    dma_addr_t dma;
    unsigned char *rx_buff_pool;
    dma_addr_t rx_buff_pool_logic;
    unsigned int rx_buff_pool_size;
    unsigned int size;
    unsigned int count;
    unsigned int next_to_use;
    unsigned int next_to_clean;
    struct pch_gbe_buffer *buffer_info;
 };

like, that's the whole struct, no cap. every field exactly as it is — i'm not touching a single character of it because the compiler does NOT forgive 💀

---

🎀 MEMBERS 🎀

so here's the member breakdown, and yeah we're going through all of them:

• desc — pointer to the descriptor ring memory. it's the actual ring, the main character 👑
• dma — the physical address of the descriptor ring. dma said "i'll handle the address, you handle the vibes" 🦋
• size — length of descriptor ring in bytes. the ring's measurements, if you will 📏
• count — number of descriptors in the ring. how many lil descriptor besties we got in here ✨
• next_to_use — next descriptor to associate a buffer with. the "who's up next" field, lowkey the most organized thing in the whole struct 💅
• next_to_clean — next descriptor to check for DD status bit. the cleanup crew, checking the DD status bit like the responsible icon it is 🧹
• buffer_info — array of buffer information structs. plural! a whole array of them! ate 🍓

real talk though: the struct in the synopsis also has rx_buff_pool, rx_buff_pool_logic, and rx_buff_pool_size in it, but this page doesn't give any blurb for those three. so like… they're there, sitting pretty, just undocumented on this particular page. i'm not gonna make stuff up about them because that's not the move 🙈

---

🦋 SEE ALSO 🦋

Kernel file ./drivers/net/ethernet/oki-semi/pch_gbe/pch_gbe.h — go read it, it's where all the friends live:

• struct pch_gbe_mac_info(9)
• struct pch_gbe_phy_info(9)
• struct pch_gbe_rx_desc(9)
• struct pch_gbe_tx_desc(9)
• struct pch_gbe_buffer(9)
• struct pch_gbe_tx_ring(9)
• struct pch_gbe_hw_stats(9)
• struct pch_gbe_privdata(9)
• struct pch_gbe_adapter(9)

---

and that's the page!! 🌈 mwah 💜

sign-off time: this little number comes to you from the source ./drivers/net/ethernet/oki-sem... (yes it's truncated in the footer, don't come for me 😭), dated October 2026, and it's struct pch_gbe_rx_ring(9) all day every day. periodt. 💅✨