tb_xdomain_alloc(9)

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

okay so this is tb_xdomain_alloc(9) from the Kernel API Manual, and it's literally the glow-up moment where a brand-new XDomain object gets born ✨

---

🌸 NAME 🌸

tb_xdomain_alloc — allocate a new XDomain object 💖

---

✨ SYNOPSIS ✨

struct tb_xdomain * tb_xdomain_alloc (struct tb *tb , struct device
*parent , u64 route , const uuid_t *local_uuid , const uuid_t
*remote_uuid );

---

🦋 ARGUMENTS 🦋

• tb — the domain where the XDomain belongs, yep, it lives here 🏠
• parent — the parent device, and bestie, this is specifically the switch through which the other domain is reached 🔌 (iykyk)
• route — the route string used to reach the other domain 🛣️
• local_uuid — our local domain UUID, that's us 💁‍♀️
• remote_uuid — the UUID of the other domain, and heads up, it's optional 🙈

---

💜 DESCRIPTION 💜

So what it does: it allocates a new XDomain structure and hands you back a pointer to it. Slay. 👑

But listen — and this is the important part — the object must be released by calling tb_xdomain_put. No leaving it lying around, that's not the vibe. 🫶

---

⭐ RETURN ⭐

• a pointer to struct tb_xdomain when everything's cute and works 🌈
• NULL in case of failure 😭

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/thunderbolt/xdomain.c 🧚 and all these icons:

• tb_xdomain_response(9)
• tb_xdomain_request(9)
• tb_register_protocol_handler(9)
• tb_unregister_protocol_handler(9)
• tb_register_service_driver(9)
• tb_unregister_service_driver(9)
• tb_service_properties_changed(9)
• tb_xdomain_add(9)
• tb_xdomain_remove(9)
• tb_xdomain_unregister(9)
• tb_xdomain_lane_bonding_enable(9)
• tb_xdomain_lane_bonding_disable(9)
• tb_xdomain_alloc_in_hopid(9)
• tb_xdomain_alloc_out_hopid(9)
• tb_xdomain_release_in_hopid(9)
• tb_xdomain_release_out_hopid(9)
• tb_xdomain_enable_paths(9)
• tb_xdomain_disable_paths(9)
• tb_xdomain_find_by_uuid(9)
• tb_xdomain_find_by_link_depth(9)
• tb_xdomain_find_by_route(9)
• tb_register_property_dir(9)
• tb_unregister_property_dir(9)

---

and that's the whole page, no cap 🍓

mwah 💋 — this one's brought to you from ./drivers/thunderbolt, dated October 2026, in all its tb_xdomain_alloc(9) glory. go off, king 👑