hsi_put_controller(9)

📦 version 7.3.1, in nixpkgs unstable

💅 hsi_put_controller(9) — like, the HSI controller freer-upper, bestie

okay so this is a page from the Kernel API Manual (section 9, kernel-space realness ✨) and it's about hsi_put_controller — the little function whose whole entire job is to let an HSI controller go 🌸

🎀 NAME 🎀

hsi_put_controller — free an HSI controller, that's it, that's the whole vibe 💖

✨ SYNOPSIS ✨

void hsi_put_controller (struct hsi_controller *hsi );

yeah that's the whole signature, no cap — returns void, takes one pointer, done 👑

🦋 ARGUMENTS 🦋

  • hsi — pointer to the HSI controller that's about to get freed 🫶

like, this is the thing you're yeeting. nothing else. just the pointer to the struct hsi_controller you wanna free 💅

🌈 DESCRIPTION 🌈

okay bestie, listen, this one comes with rules and you need to actually follow them, i'm so serious 😭

HSI controller drivers should only use this function if they need to free their allocated hsi_controller structures before a successful call to hsi_register_controller.

🚨 and "other use is not allowed" — that's not me being dramatic, that is literally what the page says. so like, don't get creative with it. this is a very specific little window of allowed usage and you're either in it or you're not 💀

so tl;dr: pre-registration cleanup only. after hsi_register_controller succeeds? nope, not your moment, not your function 🧚

👑 SEE ALSO 👑

the kernel file we're living in is literally ./drivers/hsi/hsi_core.c, and here's the whole friend group of related calls — go read them, they're iconic:

🍓 and that's the page!! stay in your pre-registration lane and everything will be cute 💜

mwah 💋 — this cutie lives in ./drivers/hsi, dated October 2026, and it's filed under hsi_put_controller(9). see u in the man pages bestie!! 🎀✨

📦 where this page comes from