qbman_swp_pull_mem_back(9)

💖 qbman_swp_pull_mem_back 💖

okay so bestie, welcome to the Kernel API Manual — yes we're literally reading kernel docs together, this is our bonding era 🫶. This one's a function page, qbman_swp_pull_mem_back(9), and it's short and sweet, so grab a lil snack and let's go ✨

---

🌸 NAME 🌸

qbman_swp_pull_mem_back — issue the pull dequeue command 👑

---

🎀 SYNOPSIS 🎀

int qbman_swp_pull_mem_back (struct qbman_swp *s , struct
qbman_pull_desc *d );

that's it. that's the whole signature. she's compact 💅

---

🦋 ARGUMENTS 🦋

• s — the software portal object. your main character struct, the portal itself ✨
• d — the software portal descriptor which has been configured with the set of qbman_pull_desc_set_*() calls. like, this thing has to be prepped beforehand, no cap — you don't just show up with a raw descriptor, you do the qbman_pull_desc_set_*() calls first and then you're ready 🎀

---

⭐ DESCRIPTION ⭐

Return 0 for success, and -EBUSY if the software portal is not ready to do pull dequeue 🔥

that's literally the whole description. 0 = slay, we did it. -EBUSY = the portal said "not right now bestie", she's busy, try again later 😭

ngl, that -EBUSY is not an error error, it's more of a "vibe check failed, come back in a sec" kinda situation 💀

---

💜 SEE ALSO 💜

the kernel file lives at ./drivers/soc/fsl/dpio/qbman-portal.c — that's the source, iykyk 📁

and here's the whole friend group, because this function does NOT exist in isolation, she has so many siblings 👑:

qbman_swp_init(9), qbman_swp_finish(9), qbman_swp_interrupt_read_status(9), qbman_swp_interrupt_clear_status(9), qbman_swp_interrupt_get_trigger(9), qbman_swp_interrupt_set_trigger(9), qbman_swp_interrupt_get_inhibit(9), qbman_swp_interrupt_set_inhibit(9), qbman_eq_desc_set_no_orp(9), qbman_eq_desc_set_fq(9), qbman_eq_desc_set_qd(9), qbman_swp_enqueue_direct(9), qbman_swp_enqueue_mem_back(9), qbman_swp_enqueue_multiple_direct(9), qbman_swp_enqueue_multiple_mem_back(9), qbman_swp_enqueue_multiple_desc_direct(9), qbman_swp_enqueue_multiple_desc_mem_back(9), qbman_swp_push_get(9), qbman_swp_push_set(9), qbman_pull_desc_clear(9), qbman_pull_desc_set_storage(9), qbman_pull_desc_set_numframes(9), qbman_pull_desc_set_fq(9), qbman_pull_desc_set_wq(9), qbman_pull_desc_set_channel(9), qbman_swp_pull_direct(9), qbman_swp_dqrr_next_direct(9), qbman_swp_dqrr_next_mem_back(9), qbman_swp_dqrr_consume(9), qbman_result_has_new_result(9), qbman_release_desc_clear(9), qbman_release_desc_set_bpid(9), qbman_release_desc_set_rcdi(9), qbman_swp_release_direct(9), qbman_swp_release_mem_back(9), qbman_swp_acquire(9), qbman_swp_set_irq_coalescing(9), qbman_swp_get_irq_coalescing(9)

go read those too, be thorough, that's the assignment 🍓

---

and that's the page!! mwah 💋 this little queen lives in ./drivers/soc/fsl/dpio, dated October 2026 — yes, october twenty twenty six, we're reading the future's manpage, iconic behavior fr fr 🌈✨💅