libeth_rx_alloc(9)

💖 libeth_rx_alloc(9) 💖

okay so bestie, we're in the Kernel API Manual today and this little icon is literally the moment a fresh Rx buffer gets born ✨ stay with me, it's gonna slay

---

🌸 NAME 🌸

libeth_rx_alloc — allocate a new Rx buffer 🎀 (yes that's it, that's the whole job, and she does it flawlessly)

---

✨ SYNOPSIS ✨

dma_addr_t libeth_rx_alloc (const struct libeth_fq_fp *fq , u32 i );

like, look at her. returns a dma_addr_t, takes two things, no drama 💅

---

🫶 ARGUMENTS 🫶

• fq — the fill queue you're allocating for, bestie. it's a const struct libeth_fq_fp *, so we're just looking at it, not touching 🙈
• i — the index of the buffer within the queue. a u32. that's the one you want, go get her ⭐

---

🔥 RETURN 🔥

on a successful allocation you get the DMA address back — and you pass that straight to HW for Rx, that's the whole point, iykyk 🦋

otherwise? you get DMA_MAPPING_ERROR. no buffer, no address, just sadness 💀

---

🌈 SEE ALSO 🌈

the way that these all live in the kernel file ./include/net/libeth/rx.h — obsessed, go read them all fr fr:

• struct libeth_fqe(9)
• enum libeth_fqe_type(9)
• struct libeth_fq(9)
• libeth_rx_sync_for_cpu(9)
• struct libeth_rx_csum(9)
• struct libeth_rqe_info(9)
• libeth_rx_pt_get_ip_ver(9)
• libeth_rx_pt_set_hash(9)

---

ngl the whole friend group is in that one header. mwah 💜

---

🎀 that's the page! brought to you by ./include/net/libeth, dated October 2026, and titled libeth_rx_alloc(9) — she ate and left no crumbs, periodt 💅✨🌸