STRUCT TB_NHI_OPS(9)

💖 struct tb_nhi_ops(9) 💖

okay so bestie, welcome to the Kernel API Manual entry for struct tb_nhi_ops — and yes, that (9) means it's a kernel-internals girlie, section 9, we're deep in the guts of the thing. this is the NHI-specific optional operations struct, and honestly? it's giving "plugin board of function pointers" and i'm obsessed. ✨

---

🌸 NAME 🌸

struct tb_nhi_ops — NHI specific optional operations 💅

---

🎀 SYNOPSIS 🎀

here's the whole struct, bestie, copied exactly so you can vibe-check every single member pointer:

struct tb_nhi_ops {
    int (*init)(struct tb_nhi *nhi);
    int (*suspend_noirq)(struct tb_nhi *nhi, bool wakeup);
    int (*resume_noirq)(struct tb_nhi *nhi);
    int (*runtime_suspend)(struct tb_nhi *nhi);
    int (*runtime_resume)(struct tb_nhi *nhi);
    void (*shutdown)(struct tb_nhi *nhi);
    void (*pre_nvm_auth)(struct tb_nhi *nhi);
    void (*post_nvm_auth)(struct tb_nhi *nhi);
    int (*request_ring_irq)(struct tb_ring *ring, bool no_suspend);
    void (*release_ring_irq)(struct tb_ring *ring);
    bool (*is_present)(struct tb_nhi *nhi);
    int (*init_interrupts)(struct tb_nhi *nhi);
};

twelve function pointers. twelve. she's thorough and we respect it 🫶

---

🦋 Members 🦋

okay let's go through them one by one, no skipping, no cap:

• init — NHI specific initialization. the little "hey wake up, get ready" moment for the NHI. 🌅
• suspend_noirq — NHI specific suspend_noirq hook. takes the nhi and a wakeup bool, because context matters, obviously.
• resume_noirq — NHI specific resume_noirq hook. the comeback era. 💫
• runtime_suspend — NHI specific runtime_suspend hook. nap time, but make it runtime.
• runtime_resume — NHI specific runtime_resume hook. nap's over, back to main character energy. 👑
• shutdown — NHI specific shutdown. returns void — she just leaves, no notes. 💀
• pre_nvm_auth — hook to run before Thunderbolt 3 NVM authentication. the pre-game. ✨
• post_nvm_auth — hook to run after Thunderbolt 3 NVM authentication. the after-party. 🎉
• request_ring_irq — NHI specific interrupt retrieval hook. grabs an irq for a struct tb_ring *ring, and there's a bool no_suspend in there too, so mind that. 🔥
• release_ring_irq — NHI specific interrupt release hook. gives the irq back for that struct tb_ring *ring, very "borrowed your hoodie, returning it washed" of her. 🧚
• is_present — Whether the device is currently present on the parent bus. returns bool, so it's a simple yes/no, iykyk. 🦋
• init_interrupts — NHI specific interrupt initialization hook. last one and she ate. 💅

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/thunderbolt/nhi.h — go read it, bestie, that's where the real lore lives 📖

---

fr fr, this is a struct of optional hooks — every member here is a function pointer the NHI can supply, so don't go assuming any of them are mandatory. the manpage doesn't say they're all populated and neither will i 🙈

---

and that's the page! brought to you by the fine folks in ./drivers/thunderbolt, dated October 2026 — mwah, love u, go read nhi.h 💜🎀