ib_create_wq(9)

💅 ib_create_wq(9) — Kernel API Manual bestie edition 💅

okay so welcome to the Kernel API Manual corner, where today’s main character is ib_create_wq. it’s giving “make a WQ and attach it to a protection domain,” and honestly? iconic. no cap. ✨

🌸 NAME 🌸

ib_create_wq — Creates a WQ associated with the specified protection domain. 💖

✨ SYNOPSIS ✨

the signature, exactly as it appears, because we do not play with code:

struct ib_wq * ib_create_wq (struct ib_pd *pd , struct ib_wq_init_attr
       *wq_attr );

🎀 ARGUMENTS 🎀

• pd — the protection domain associated with the WQ. that’s the one, bestie. 🫶
• wq_attr — a list of initial attributes required to create the WQ. If WQ creation succeeds, then the attributes are updated to the actual capabilities of the created WQ. ✨

💖 DESCRIPTION 💖

okay so wq_attr->max_wr and wq_attr->max_sge determine the requested size of the WQ, and they get set to the actual values allocated on return. that’s the glow-up. 💅

If ib_create_wq succeeds, then max_wr and max_sge will always be at least as large as the requested values. periodt — no tiny surprise downgrade. 🫶

🦋 SEE ALSO 🦋

the kernel file is ./drivers/infiniband/core/verbs.c, and the see-also friend group is:

• __ib_alloc_pd(9)
• ib_dealloc_pd_user(9)
• rdma_copy_ah_attr(9)
• rdma_replace_ah_attr(9)
• rdma_move_ah_attr(9)
• rdma_create_ah(9)
• rdma_create_user_ah(9)
• rdma_move_grh_sgid_attr(9)
• rdma_destroy_ah_attr(9)
• ib_create_srq_user(9)
• ib_create_qp_user(9)
• ib_resolve_eth_dmac(9)
• ib_modify_qp_with_udata(9)
• ib_alloc_mr(9)
• ib_alloc_mr_integrity(9)
• ib_alloc_xrcd_user(9)
• ib_dealloc_xrcd_user(9)
• ib_destroy_wq_user(9)
• ib_map_mr_sg_pi(9)
• ib_map_mr_sg(9)
• ib_sg_to_pages(9)
• ib_drain_sq(9)
• ib_drain_rq(9)
• ib_drain_qp(9)
• rdma_alloc_hw_stats_struct(9)
• rdma_free_hw_stats_struct(9)

mwah 💋 this page comes from source/version ./drivers/infiniband/core, dated October 2026, and it’s all about ib_create_wq(9). bye bestie, drink water 🌈🫶