qbman_swp_acquire(9)

📦 version 7.3.1, in nixpkgs unstable

💅 qbman_swp_acquire(9) 💅

okay so this is a page from the Kernel API Manual, and bestie, we're about to get into buffer acquires. stay with me, it's actually not that deep 💖

✨ NAME ✨

qbman_swp_acquire — Issue a buffer acquire command

like, you're telling the hardware "hey, hand me some buffers, thanks bestie" 🫶

🦋 SYNOPSIS 🦋

int qbman_swp_acquire (struct qbman_swp *s , u16 bpid , u64 *buffers ,
unsigned int num_buffers );

🎀 ARGUMENTS 🎀

  • s — the software portal object. this is your main character, the whole vibe check happens through it ✨
  • bpid — the buffer pool index. which pool we're pulling from, iykyk
  • buffers — a pointer pointing to the acquired buffer addresses. this is where the good stuff lands 💅
  • num_buffers — number of buffers to be acquired, and must be less than 8. no cap, that's a hard limit, don't push it 😭

🌸 DESCRIPTION 🌸

Return 0 for success, or a negative error code if the acquire command fails. that's it, that's the whole tea 🍓

lowkey important: a negative return means something went wrong, so please actually check it, bestie 🙈

👑 SEE ALSO 👑

Kernel file ./drivers/soc/fsl/dpio/qbman-portal.c, plus the whole friend group:

that's the page, bestie, go acquire some buffers responsibly 🌈

signed off from ./drivers/soc/fsl/dpio, version dating October 2026 — periodt 💜

📦 where this page comes from