tb_switch_find_by_uuid(9)

📦 version 7.3.1, in nixpkgs unstable

💅 tb_switch_find_by_uuid 💅

okay bestie, welcome to the tb_switch_find_by_uuid(9) page — it lives in the Kernel API Manual, and it's honestly such a vibe. tiny little function, big main character energy. you want a switch? you got a UUID? say less, let's go 🦋

✨ NAME ✨

tb_switch_find_by_uuid — find a switch by its UUID, that's literally it, that's the whole job 🎀

🌈 SYNOPSIS 🌈

struct tb_switch * tb_switch_find_by_uuid (struct tb *tb , const uuid_t
*uuid );

like, look at her. perfect signature. no notes. 👑

🍓 ARGUMENTS 🍓

  • tb — the domain that the switch belongs to. it's the neighborhood, the switch is the house, iykyk 🏠
  • uuid — the UUID you're out here looking for. the little name tag. the fingerprint. the whole identity tbh 🔍

💖 DESCRIPTION 💖

so the returned switch has its reference count increased 😭 which means you, yes YOU, the caller, are responsible for it — you must call tb_switch_put when you're done with the switch. not just dropping it and walking away. that's a leak, and leaks are not slay. be a responsible bestie and put it back 🫶

⭐ RETURN ⭐

a pointer to struct tb_switch — iconic, we love to see it ✨

NULL if it's not found — no switch for you, sorry babe 💀

🦋 SEE ALSO 🦋

everything else living over in the kernel file ./drivers/thunderbolt/switch.c — like, the whole friend group:

like, she's got connections. she knows everyone. 💅

okay that's the whole page, mwah 💋 it came from ./drivers/thunderbolt, dated October 2026, and yes it's still tb_switch_find_by_uuid(9) — go put your switch back now, bestie 🧚💜

📦 where this page comes from