hinic_wqs_cmdq_alloc(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 hinic_wqs_cmdq_alloc(9) — the Kernel API Manual glow-up 🌸

okay so bestie, you're in the Kernel API Manual section and this one is literally called hinic_wqs_cmdq_alloc 💅 — it's the "Allocate wqs for cmdqs" girlie, and yes she's coming in hot from the Huawei hinic driver corner of the kernel. buckle up, it's giving driver-internals main character energy 🦋

✨ NAME ✨

hinic_wqs_cmdq_alloc — Allocate wqs for cmdqs. that's it, that's the whole vibe 🎀

✨ SYNOPSIS ✨

int hinic_wqs_cmdq_alloc (struct hinic_cmdq_pages *cmdq_pages , struct
hinic_wq *wq , struct hinic_hwif *hwif , int cmdq_blocks , u16
wqebb_size , u32 wq_page_size , u16 q_depth , u16 max_wqe_size );

like, eight arguments, no cap 😭 she's high maintenance but she's iconic.

✨ ARGUMENTS ✨

  • cmdq_pages — this one's a container bestie: it will hold the pages of the cmdq. it's the output holder, not the input, okurrr 🫶
  • wq — the returned wqs. yes returned, as in you get them back from this function, slay ✨
  • hwif — HW interface. short, sweet, hardware-flavoured 🔥
  • cmdq_blocks — number of cmdq blocks/wq to allocate. count 'em 👑
  • wqebb_size — Work Queue Block Byte Size (wqebb, don't ask me to say it out loud 💀)
  • wq_page_size — the page size in the Work Queue 📄
  • q_depth — number of wqebbs in WQ. so like, how deep the queue goes, iykyk 🌀
  • max_wqe_size — maximum WQE size that will be used in the WQ. big WQE energy only 🙈

✨ DESCRIPTION ✨

so the whole entire description is literally this, and we respect the efficiency:

Return 0 - Success, negative - Failure.

that's the vibe check: 0 means we ate, negative means we did not eat 😭💀

✨ SEE ALSO ✨

Kernel file ./drivers/net/ethernet/huawei/hinic/hinic_hw_wq.c — go read the source bestie, she's right there 🧚

and the whole friend group, in order, no skipping:

like, that's the whole group chat 🫶💖

lowkey reminder: hinic_wqs_cmdq_alloc(9) also has her counterpart hinic_wqs_cmdq_free(9), so don't be out here leaking pages, periodt 💅

and that's the page, bestie 💜 this cutie came out of ./drivers/net/ethernet/huawei/... and the date on her birth certificate says October 2026 — so yeah, future icon behaviour ⭐🌈 signing off with the manual name one last time: hinic_wqs_cmdq_alloc(9) 🎀

📦 where this page comes from