free_wq_pages(9)

💅 free_wq_pages 💅

okay so this one is from the Kernel API Manual, section 9, and it's a kernel API page — meaning it's dev-facing, iykyk. it's a short one but we're giving it main character energy anyway 🫶

---

🌸 NAME 🌸

free_wq_pages — free pages of WQ ✨

like, that's the whole thing bestie. she frees the pages. of the WQ. iconic, no notes 💅

---

✨ SYNOPSIS ✨

void free_wq_pages (struct hinic_wq *wq , struct hinic_hwif *hwif , int
num_q_pages );

literally copy that exactly, spacing and all — do not "fix" the commas, she's perfect as she is 😭

---

💖 ARGUMENTS 💖

• wq — the WQ you're freeing pages from 🎀 like, this is the one getting her pages taken
• hwif — the HW interface, and it's the thing that releases the dma addresses 🌈 (so yeah, dma addresses get released through here)
• num_q_pages — the number of pages to free, bestie. count them. don't be weird about it 🔢

---

🦋 SEE ALSO 🦋

the whole friend group, gathered for you 👑

• the kernel file ./drivers/net/ethernet/huawei/hinic/hinic_hw_wq.c — that's where she lives 🏠

and then all her besties, in order, no cap:

• queue_alloc_page(9)
• wqs_allocate_page(9)
• wqs_free_page(9)
• cmdq_allocate_page(9)
• cmdq_free_page(9)
• hinic_wqs_alloc(9)
• hinic_wqs_free(9)
• alloc_wqes_shadow(9)
• free_wqes_shadow(9)
• alloc_wq_pages(9) — the alloc counterpart, yes she's here, the duo ate 🔥
• hinic_wq_allocate(9)
• hinic_wq_free(9)
• hinic_wqs_cmdq_alloc(9)
• hinic_wqs_cmdq_free(9)
• hinic_get_wqe(9)
• hinic_return_wqe(9)
• hinic_put_wqe(9)
• hinic_read_wqe(9)
• hinic_read_wqe_direct(9)
• wqe_shadow(9)
• hinic_write_wqe(9)

all of them. every single one. we don't do "and friends" here 💀

---

lowkey reminder: this page gives you the signature and the args, that's it — no extra lore, so don't go inventing behaviour that isn't on the page 🙈

---

mwah 💋 this one's from ./drivers/net/ethernet/huawei/... and it's dated October 2026, and yes the page is literally called free_wq_pages(9) — cite her correctly bestie 🌟🎀