ef4_fast_pus..._descriptors(9)

💅 ef4_fast_push_rx_descriptors — like, the iconic one

okay bestie, so this is a page from the Kernel API Manual, and it's about ef4_fast_push_rx_descriptors — the function that pushes new RX descriptors quickly ✨ (yeah the name kind of ate, it tells you exactly what's happening).

---

🌸 NAME 🌸

ef4_fast_push_rx_descriptors — push new RX descriptors quickly 🎀

---

✨ SYNOPSIS ✨

void ef4_fast_push_rx_descriptors (struct ef4_rx_queue *rx_queue , bool
atomic );

like, that's the whole signature. no cap, that's it 🫶

---

🦋 ARGUMENTS 🦋

• rx_queue — the RX descriptor queue. the main character of this whole function, honestly 👑
• atomic — controls the memory allocation flags. yeah it's literally the switch that decides how the memory gets grabbed 💅

---

💖 DESCRIPTION 💖

so the vibe here is: this function aims to fill the RX descriptor queue all the way up to rx_queue->max_fill. that's the goal, that's the dream 🌈

but — and this is the important part, don't skip it — if there isn't enough atomic memory to actually do that, then a slow fill gets scheduled instead. so it's not a fail, it's just a "we'll get to it later" situation 😌

⚠️ okay so this is the caveat that matters: the caller must provide serialisation — none is used here. in practise, that means this function has to run from the NAPI handler, or be called when NAPI is disabled. do not skip this, bestie, fr fr 🚨

---

🧚 SEE ALSO 🧚

• Kernel file ./drivers/net/ethernet/sfc/falcon/rx.c — go read the source, iykyk 📖
• ef4_init_rx_buffers(9)
• ef4_filter_is_mc_recipient(9)

---

and that's the page!! mwah 💋 it lives under ./drivers/net/ethernet/sfc/falcon, dated October 2026, part of the Kernel API Manual — go off, kernel docs, you absolute icon ⭐👑