set_hw_ioctxt(9)

💅 set_hw_ioctxt(9) — like, the whole Kernel API Manual vibe, but make it make sense

okay so bestie, we're in the Kernel API Manual today and the main character is set_hw_ioctxt. Say it with me: set-hw-io-ctxt. It's giving "configure the firmware's IO queues" and honestly? iconic. ✨

---

✨ NAME ✨

set_hw_ioctxt — literally just sets the shape of the IO queues in FW 🎀

(fr fr, that's the whole job. shape. of. the. queues. in. the. firmware.)

---

🌸 SYNOPSIS 🌸

int set_hw_ioctxt (struct hinic_hwdev *hwdev , unsigned int sq_depth ,
       unsigned int rq_depth );

so it takes three things and hands you back an int. that's the whole vibe check. 💖

---

🦋 ARGUMENTS 🦋

• hwdev — the NIC HW device 👑 like, the hardware itself, the actual guy
• sq_depth — sq depth 💀 that's the send queue depth, bestie, that's how deep it goes
• rq_depth — rq depth 🍓 and that's the receive queue depth, same energy, other direction

---

💅 DESCRIPTION 💅

okay so here's the tea: it returns 0 for Success, and a negative value for Failure. that's it. that's the description. no cap. 😭

ngl it's a short one — but 0 = slay, negative = not slay. memorize it. 🫶

---

🌈 SEE ALSO 🌈

the kernel file is right here, go look at it if you're nosy (respectfully):

./drivers/net/ethernet/huawei/hinic/hinic_hw_dev.c

and the whole friend group, in order, no skipping, they all matter:

• parse_capability(9)
• get_capability(9)
• get_dev_cap(9)
• init_msix(9)
• disable_msix(9)
• hinic_port_msg_cmd(9)
• init_fw_ctxt(9)
• clear_io_resources(9)
• set_resources_state(9)
• get_base_qpn(9)
• hinic_hwdev_ifup(9)
• hinic_hwdev_ifdown(9)
• hinic_hwdev_cb_register(9)
• hinic_hwdev_cb_unregister(9)
• nic_mgmt_msg_handler(9)
• init_pfhwdev(9)
• free_pfhwdev(9)
• hinic_init_hwdev(9)
• hinic_free_hwdev(9)
• hinic_hwdev_num_qps(9)
• hinic_hwdev_get_sq(9)
• hinic_hwdev_get_rq(9)
• hinic_hwdev_msix_cnt_set(9)
• hinic_hwdev_msix_set(9)
• hinic_hwdev_hw_ci_addr_set(9)
• hinic_hwdev_set_msix_state(9)

twenty-six of them. yes I counted. yes I'm obsessed. 💜

---

k so that's the page!! source is ./drivers/net/ethernet/huawei/... and the date on this thing is October 2026, which is so far away it's basically a time capsule 🧚✨ anyway, set_hw_ioctxt(9), out. 💖 bye bestie!! 🎀