qman_alloc_pool_range(9)

✨ qman_alloc_pool_range(9) ✨

okay so this one lives in the Kernel API Manual and it's literally called qman_alloc_pool_range(9) — say that five times fast 💅. It's giving "short page, big responsibility," because bestie, all it does is hand you a block of pool-channel IDs. That's it. That's the whole vibe.

---

🌸 NAME 🌸

qman_alloc_pool_range — allocate a contiguous range of pool-channel IDs

Like, a whole run of them, all next to each other. No gaps, no stragglers, no chaos. We love a tidy allocation 🎀

---

🦋 SYNOPSIS 🦋

int qman_alloc_pool_range (u32 *result , u32 count );

Two params, one int coming back at you. Simple. Iconic. Understood the assignment 🫶

---

🌈 ARGUMENTS 🌈

• result — this is the output param, and the API sets it to the base pool-channel ID of the range it just handed you. So yeah, that's where the starting address of your cute little contiguous block shows up ✨
• count — how many pool-channel IDs you actually need. Like, the size of the squad you're requesting 💖

---

🔥 DESCRIPTION 🔥

It returns 0 on success, or a negative error code. That's the whole deal, no cap.

So the vibe check is: got a 0? Slay, you have your range, go build something. Got a negative number? 😭 that's a no from the kernel, and you should handle it like the responsible main character you are.

ngl this page is short but the rule still stands: negative error code means it did not work, so don't go dereferencing result like everything's fine 🙈

---

👑 SEE ALSO 👑

• Kernel file ./include/soc/fsl/qman.h
• qman_p_irqsource_add(9)
• qman_p_irqsource_remove(9)
• qman_affine_cpus(9)
• qman_affine_channel(9)
• qman_get_affine_portal(9)
• qman_start_using_portal(9)
• qman_p_poll_dqrr(9)
• qman_p_static_dequeue_add(9)
• qman_create_fq(9)
• qman_destroy_fq(9)
• qman_fq_fqid(9)
• qman_init_fq(9)
• qman_schedule_fq(9)
• qman_retire_fq(9)
• qman_oos_fq(9)
• qman_enqueue(9)
• qman_alloc_fqid_range(9)
• qman_release_fqid(9)
• qman_query_fq_np(9)
• qman_release_pool(9)
• qman_create_cgr(9)
• qman_delete_cgr(9)
• qman_delete_cgr_safe(9)
• qman_update_cgr_safe(9)
• qman_query_cgr_congested(9)
• qman_alloc_cgrid_range(9)
• qman_release_cgrid(9)
• qman_is_probed(9)
• qman_portals_probed(9)
• qman_dqrr_get_ithresh(9)
• qman_dqrr_set_ithresh(9)

---

and that's the whole page, bestie 🧚 it's from ./include/soc/fsl, dated October 2026, and it says qman_alloc_pool_range(9) one more time at the bottom just to be extra 💜 go allocate something cute, and remember: check your return value, always, periodt 💅✨