bman_acquire(9)

🎀 NAME 🎀

okay so bestie, this is bman_acquire(9) — the whole manual page is about acquiring buffer(s) from a buffer pool. yes, that's literally the name, and it's giving exactly what it says. 💅

✨ SYNOPSIS ✨

int bman_acquire (struct bman_pool *pool , struct bm_buffer *bufs , u8 num );

🌸 ARGUMENTS 🌸

• pool — the buffer pool object you're acquiring from. 🫶
• bufs — the array where the acquired buffers get stored. it's at least num big.
• num — the number of buffers desired. (bufs is at least this big.)

💖 DESCRIPTION 💖

So this bad boy issues an "Acquire" command via the portal's management command interface. The return value will be the number of buffers obtained from the pool, or a negative error code if a h/w error or pool starvation was encountered. got it? 😭

⚠️ In the latter case, the content of bufs is undefined. do not go treating that array like it's valid, bestie — that is not the vibe. 💀

🔥 SEE ALSO 🔥

• Kernel file ./include/soc/fsl/bman.h
• bman_new_pool(9)
• bman_free_pool(9)
• bman_get_bpid(9)
• bman_release(9)
• bman_is_probed(9)
• bman_portals_probed(9)

made with love from the ./include/soc/fsl corner of the kernel, October 2026 🌈✨💜