ib_create_ah_from_wc(9)

📦 version 7.3.1, in nixpkgs unstable

💅 NAME 💅

okay so literally welcome to ib_create_ah_from_wc(9) — the Kernel API Manual page that's about to be your new hyperfixation. this one creates an address handle that's all tied up with the sender of the work completion you point at. bestie, it's giving "who even sent this" but make it formal. 🫶

✨ SYNOPSIS ✨

struct ib_ah * ib_create_ah_from_wc (struct ib_pd *pd , const struct
ib_wc *wc , const struct ib_grh *grh , u32 port_num );

no cap, that's the whole glow-up right there. four args, one handle, let's go 💫

🎀 ARGUMENTS 🎀

  • pd — the protection domain that's emotionally attached to this address handle. like, they come as a set. 💖
  • wc — the work completion info from a message you received. this is your "receipts" era, it's literally the receipt. 🧾
  • grh — points at the received global route header. but bestie hear me — this parameter gets completely ignored unless the work completion says the GRH is valid. so don't come at it with expectations unless wc gives you the green flag. 🚩✨
  • port_num — the outbound port number you wanna link up with the address. match made in heaven, port edition. 🛟

🌸 DESCRIPTION 🌸

so what's the address handle even for, you ask? iconic question. the address handle is what you use to reference a local or global destination in all UD QP post sends. that's the whole vibe — it's the little name-tag for where your stuff is headed. not me being obsessed with a pointer, but here we are. 👑🔥

🦋 SEE ALSO 🦋

the crossover episode, fr fr. also peep the kernel file ./include/rdma/ib_verbs.h — that's where the lore lives:

bestie reminder: grh only matters when the work completion flags the GRH as valid. otherwise it's just standing there, ignored, living its truth. 🙈

and that's the whole page, mwah 💋 this lil masterpiece comes to you from the source ./include/rdma, dated October 2026, and the manual answer is ib_create_ah_from_wc(9) every single time. slay, go build your address handles, i'm rooting for you 🍓💜✨

📦 where this page comes from