qbman_pull_desc_set_storage(9)

📦 version 7.3.1, in nixpkgs unstable

💅 qbman_pull_desc_set_storage(9) 💅

okay bestie, welcome to the Kernel API Manual ✨ — yes that's the manual name, and yes this page lives there. today's main character is qbman_pull_desc_set_storage, and honestly? she's giving "small function, big consequences" energy. let's get into it 🎀

🌸 NAME 🌸

qbman_pull_desc_set_storage — set the pull dequeue storage 💖

✨ SYNOPSIS ✨

void qbman_pull_desc_set_storage (struct qbman_pull_desc *d , struct
dpaa2_dq *storage , dma_addr_t storage_phys , int stash );

literally that's the whole vibe. four args, no cap. 🫶

🦋 ARGUMENTS 🦋

  • d — the pull dequeue descriptor to be set. she's the one getting her storage configured, main character energy fr 😌
  • storage — the pointer of the memory to store the dequeue result 📦
  • storage_phys — the physical address of the storage memory. yep, the phys one, don't get it twisted 🧚
  • stash — to indicate whether write allocate is enabled 👀

💜 DESCRIPTION 💜

okay so here's the tea ☕ ngl this is the part you actually need.

If you don't call this function at all, or if you call it with storage as NULL, the result pull dequeues will produce results to DQRR. periodt 💅

If storage is non-NULL, though, then results are produced to that given memory location — using the DMA address which the caller provides in storage_phys 🎯 — and stash controls whether or not those writes to main-memory express a cache-warming attribute 🔥

so like... NULL = DQRR, non-NULL = your memory, and stash is the little garnish on top deciding if the writes feel cache-warm. iconic. 🌈

🫶 reminder bestie: storage_phys is your job to supply, and it's got to be the physical address. the function is trusting you on this one. 🙈

🎀 SEE ALSO 🎀

Kernel file ./drivers/soc/fsl/dpio/qbman-portal.c — go read the source, iykyk 💀

and then the whole extended friend group, no one left out:

⭐ and that's the page, bestie! this one came from the source tree at ./drivers/soc/fsl/dpio, dated October 2026 — so go forth, set that storage, and slay your dequeue results 💖🦋✨

📦 where this page comes from