shutdown_device(9)

💅 shutdown_device(9) — like, the "everybody chill" button

okay bestie, welcome to the kernel API manual 🎀 this one's shutdown_device(9), and it's genuinely one of the more chill pages in here — short, sweet, and it does exactly what it says on the tin. no cap.

---

✨ NAME ✨

shutdown_device — shut down a device 🫶

like... that's it. that's the whole name. iconic behaviour honestly.

---

🌸 SYNOPSIS 🌸

void shutdown_device (struct hfi1_devdata *dd );

no return value, so don't go looking for one — she gives you nothing back except a quieter device 💜

---

🦋 ARGUMENTS 🦋

• dd — the hfi1_ib device. that's the one you're telling to go to sleep 🌙

---

⭐ DESCRIPTION ⭐

so here's the vibe 👑 you call this when you're about to unload the driver, and you need the device to please stop making noise. also called when the device gets administratively disabled — same energy, different reason.

🚨 important bestie detail: it does not free any data structures. zero. none. it's not a cleanup function, it's a "quiet down" function. do not conflate them, i am begging 🙈

and because nothing actually gets torn down, everything it does has to be set up again by hfi1_init(dd, 1). so if you're planning to keep using this device afterwards, that call is not optional — it's the whole bit 🔥

---

💖 SEE ALSO 💖

go read the kernel file ./drivers/infiniband/hw/hfi1/init.c — that's where the actual lore lives 📖 and while you're in the neighborhood, these fine functions are all linked up:

• hfi1_rcd_free(9)
• hfi1_rcd_put(9)
• hfi1_rcd_get(9)
• allocate_rcd_index(9)
• hfi1_rcd_get_by_index_safe(9)
• hfi1_rcd_get_by_index(9)
• hfi1_free_ctxt(9)
• init_after_reset(9)
• create_workqueues(9)
• destroy_workqueues(9)
• enable_general_intr(9)
• hfi1_init(9)
• hfi1_free_ctxtdata(9)
• hfi1_free_devdata(9)
• hfi1_alloc_devdata(9)
• hfi1_create_rcvhdrq(9)
• hfi1_setup_eagerbufs(9)

---

and that's the whole page, bestie 💅 signed off from ./drivers/infiniband/hw/hfi1, dated October 2026, and we are out — mwah 🎀✨🦋