tb_ctl_alloc(9)

✨ tb_ctl_alloc(9) ✨

ok so bestie, welcome to the Kernel API Manual 💖 this one's a function page — tb_ctl_alloc — and it's literally the glow-up moment where a control channel gets born 🎀

---

🌸 NAME 🌸

tb_ctl_alloc — allocate a control channel

yeah that's it, that's the whole vibe. it allocates a control channel. slay 💅

---

🦋 SYNOPSIS 🦋

struct tb_ctl * tb_ctl_alloc (struct tb_nhi *nhi , int index , int
timeout_msec , event_cb cb , void *cb_data );

look at her go 😭 five whole arguments, she's high maintenance but she's worth it.

---

💜 ARGUMENTS 💜

• nhi — Pointer to NHI. that's the NHI, and you're handing over a pointer to it. iconic.
• index — Domain number 🌈
• timeout_msec — the default timeout used with non-raw control messages ⏱️ like, raw ones do their own thing, but these babies use this.
• cb — Callback called for plug events 🔌 every hot plug event, she's there.
• cb_data — Data passed to cb 🫶 whatever you hand her here, she hands right back to your callback.

---

🧚 DESCRIPTION 🧚

So here's the whole tea, bestie: cb will be invoked once for every hot plug event. once. per. event. periodt 🔥

that's it. that's the description. no cap, that's genuinely all she wrote.

---

⭐ RETURN ⭐

Returns a pointer to struct tb_ctl 💖 — or NULL on failure 😭 (iykyk, always check your pointers, don't be that girl).

---

👑 SEE ALSO 👑

• Kernel file ./drivers/thunderbolt/ctl.c
• struct tb_ctl(9)
• tb_cfg_request_alloc(9)
• tb_cfg_request_get(9)
• tb_cfg_request_put(9)
• tb_cfg_request(9)
• tb_cfg_request_cancel(9)
• tb_cfg_request_sync(9)
• tb_ctl_free(9)
• tb_ctl_start(9)
• tb_ctl_stop(9)
• tb_cfg_ack_notification(9)
• tb_cfg_ack_plug(9)
• tb_cfg_reset(9)
• tb_cfg_read_raw(9)
• tb_cfg_write_raw(9)
• tb_cfg_get_upstream_port(9)

the whole friend group fr fr 🫶 go read them all, they're all serving.

---

💀 reminder bestie: this came out of ./drivers/thunderbolt and it's dated October 2026 — so like, write it down, cite it, or whatever it is you do with manpage dates. mwah 💋✨

ok bye ily, go allocate something 🦋💅