hl_cq_init(9)

✨ hl_cq_init(9) ✨

okay so bestie, buckle up 💖 this one's a kernel API page from the Linux manual — we're talking habanalabs driver internals, and honestly? it's giving main character energy for such a tiny function. let's get into it 🫶

---

🌸 NAME 🌸

hl_cq_init — the main initialization function for a cq object ✨

like, the actual one. the headliner. the one that sets everything up. 💅

---

🦋 SYNOPSIS 🦋

int hl_cq_init (struct hl_device *hdev , struct hl_cq *q , u32
hw_queue_id );

three args, one int coming back at you. no cap. 🌈

---

🎀 ARGUMENTS 🎀

• hdev — pointer to the device structure 🖥️ lowkey the whole context of the thing tbh
• q — pointer to the cq structure 💫 that's the completion queue object you're bringing to life
• hw_queue_id — the H/W queue ID that this completion queue belongs to 🧚 or, plot twist: pass HL_INVALID_QUEUE if the cq is not attached to any specific queue 🙈

---

👑 DESCRIPTION 👑

so what does it actually do? two iconic things, fr fr:

1. allocates dma-able memory for the completion queue 🧠✨
2. initializes fields 🎀

and the bestie part? it returns 0 on success ⭐ that's it. that's the whole vibe check.

no drama, no undefined nonsense described here — just allocate, init, and hand you back a 0 when it slays 💜

---

🔥 SEE ALSO 🔥

like obviously you're gonna wanna know what's in the Kernel file ./drivers/accel/habanalabs/common/irq.c 💀 and also these fellow icons:

• struct hl_eqe_work(9)
• hl_cq_inc_ptr(9)
• hl_eq_inc_ptr(9)
• job_finish(9)
• cs_finish(9)
• hl_irq_handler_cq(9)
• hl_irq_user_interrupt_handler(9)
• hl_irq_user_interrupt_thread_handler(9)
• hl_irq_handler_eq(9)
• hl_irq_handler_dec_abnrm(9)
• hl_cq_fini(9)
• hl_eq_init(9)
• hl_eq_fini(9)

ikyk 👀 go read them all, they're a whole friend group 🫶

---

and that's the page, bestie!! 🌸 this lil gem comes out of ./drivers/accel/habanalabs/common, dated October 2026, and it's living in the Kernel API Manual — so next time you're deep in kernel docs at 2am, you'll know exactly where to find it 🎀💖 slay responsibly ✨