tb_xdomain_find_by_uuid(9)

✨ tb_xdomain_find_by_uuid — find an XDomain by UUID ✨

Okay bestie, so this is a page from the Kernel API Manual (section 9, the kernel API one 💅) and it's all about hunting down an XDomain using its UUID. Let's get into it 🎀

---

🌸 SYNOPSIS 🌸

struct tb_xdomain * tb_xdomain_find_by_uuid (struct tb *tb , const
uuid_t *uuid );

---

🦋 ARGUMENTS 🦋

• tb — the domain where the XDomain belongs to, like its home base 🏠
• uuid — the UUID we're looking for, the whole point of the mission 🔍

---

💖 DESCRIPTION 💖

So basically it finds the XDomain by walking through the Thunderbolt topology below tb. Literally just strolling through the tree, no big deal 🌈

The returned XDomain has its reference count increased, so when you're done with the object you have to call tb_xdomain_put — no cap, don't forget or it just sits there holding a reference forever 😭

It'll find all the XDomains, including the ones that haven't been added to the bus yet (handshake is still in progress, it's giving "almost there" energy 🧚).

The caller needs to hold tb->lock. Yes, seriously. Hold it. 🔒

---

⭐ RETURN ⭐

Pointer to struct tb_xdomain, or NULL if not found. That's it, that's the whole vibe 🙈

---

💜 SEE ALSO 💜

Kernel file ./drivers/thunderbolt/xdomain.c plus the whole friend group 👑

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_alloc(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_link_depth(9), tb_xdomain_find_by_route(9), tb_register_property_dir(9), tb_unregister_property_dir(9)

---

💅 that's the page, mwah 💅

Cute lil sign-off: this one lives in ./drivers/thunderbolt, dated October 2026, and it's the tb_xdomain_find_by_uuid(9) page from the Kernel API Manual. Go find your UUID bestie 🫶🌸