hfi1_make_ruc_header_16B(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hfi1_make_ruc_header_16B(9) — kernel API manual, but make it make sense 🎀

okay so bestie, buckle up, this one's a kernel API manual page for hfi1_make_ruc_header_16B, and honestly? it's giving "small function, big responsibilities." ✨

🌸 NAME 🌸

hfi1_make_ruc_header_16B — build a 16B header. that's it, that's the whole vibe. it builds. a header. sixteen B's worth. 💅

🦋 SYNOPSIS 🦋

void hfi1_make_ruc_header_16B (struct rvt_qp *qp , struct
ib_other_headers *ohdr , u32 bth0 , u32 bth1 , u32 bth2 , int middle ,
struct hfi1_pkt_state *ps );

no cap, that's the exact signature, don't @ me. it returns void, so it's not gonna hand you back a value — it's a "do the thing" kind of function, main character energy fr fr. 👑

🧚 ARGUMENTS 🧚

  • qp — the queue pair. iconic, essential, the whole point. 💖
  • ohdr — a pointer to the destination header memory. it's where the header actually gets written, so like… be nice to it. 🫶
  • bth0 — bth0 passed in from the RC/UC builder. yes it's literally named the same thing, yes that's how the kernel rolls. 🙈
  • bth1 — bth1 passed in from the RC/UC builder. same deal, different digit. ✨
  • bth2 — bth2 passed in from the RC/UC builder. completing the holy trinity of bth parameters ngl. 💀
  • middle — non zero implies indicates ahg "could" be used. keeping the original's exact phrasing there because that "implies indicates" is lowkey a whole mood. 😭
  • ps — the current packet state. the vibe check for the packet, basically. 🌈

⭐ DESCRIPTION ⭐

so what does this routine actually do? it builds a 16B header, and along the way it may disarm ahg under these situations:

  • packet needs a GRH
  • BECN needed
  • migration state not IB_MIG_MIGRATED

that's the tea. ☕ if any of those three things are happening, ahg gets disarmed. periodt. 🔥

bestie note: "may" is doing a lot of work in that sentence — that's the original's wording, and we respect it. don't go assuming it always disarms. 💅

👑 SEE ALSO 👑

kernel file ./drivers/infiniband/hw/hfi1/ruc.c and also these absolute legends:

go read them, they're all friends of this function 🫶✨

🎀 sign-off 🎀

this whole flirty little page lives under ./drivers/infiniband/hw/hfi1, and the source/version stamp on it says October 2026 — so yeah, future-core of it all. 💜

later bestie, go build some headers 💅💖

hfi1_make_ruc_header_16B(9) — ./drivers/infiniband/hw/hfi1 — October 2026 🌸

📦 where this page comes from