hfi1_free_ctxt(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hfi1_free_ctxt(9) — the Kernel API Manual, bestie edition 🎀

Okay so we're in the kernel API manual today, and the star of the show is hfi1_free_ctxt(9). Buckle up, this one's a little one but she matters ✨

🌸 NAME 🌸

hfi1_free_ctxt — free context. That's it. That's the whole vibe. She frees the context 💖

✨ SYNOPSIS ✨

void hfi1_free_ctxt (struct hfi1_ctxtdata *rcd );

Returns nothing (void, so no take-backs, no receipts), takes exactly one thing, and lives rent-free in your kernel code 🫶

🎀 ARGUMENTS 🎀

  • rcd — pointer to an initialized rcd data structure. Not a maybe-initialized one, not a half-initialized one. An initialized one, bestie 💅

🦋 DESCRIPTION 🦋

Okay so here's the tea ☕ — this function is a wrapper, and she's the free function that matches hfi1_create_ctxtdata. They're a set. They come as a pair. Think of them as the two halves of a friendship bracelet, except one of them is deallocating memory 😭

When a context is done being used — and this goes for kernel or user contexts, both, no exceptions — this function gets called for the "final" put. And why is the put in quotes? Because it's the final one that matches the kref init from hfi1_create_ctxtdata. It's the closing bracket of the whole saga 🧚

The way that other users of the context work is they do a get/put sequence — a little borrow-and-return, very library book of them — to make sure that the structure isn't removed while it's still in use. So like, nobody yanks the rug out while somebody else is still standing on it. Basic manners, honestly 👑

Lowkey the whole point: this is the last put. The one that actually lets the thing go. Everyone else is just get/put-ing politely in the background 🌈

👑 SEE ALSO 👑

Kernel file ./drivers/infiniband/hw/hfi1/init.c — that's where she lives, go say hi 🏠

And the whole friend group, in the order the page gives them, fr fr:

Not me listing all of them — yes I am, because we keep every single one, that's the rule 😤💖

Sign-off time, and this is the cute part: this page comes to you from ./drivers/infiniband/hw/hfi1, dated October 2026, and she's filed under hfi1_free_ctxt(9) in the Kernel API Manual 🎀✨ Bye bestie, go put your refcounts back where you found them 💜🦋

📦 where this page comes from