tb_retimer_scan(9)

💅 tb_retimer_scan — the kernel API manual, bestie edition ✨

okay so this page is tb_retimer_scan(9) and it lives in the Kernel API Manual 🎀 yes we're in kernel-doc land, stay with me, it's gonna slay.

---

✨ NAME ✨

tb_retimer_scan — it literally scans for on-board retimers under a port 🦋 that's the whole vibe, no cap.

---

🌸 SYNOPSIS 🌸

int tb_retimer_scan (struct tb_port *port , bool add );

that's the signature, copy it exactly, don't be weird about it 💖

---

🎀 ARGUMENTS 🎀

• port — the USB4 port we're scanning 🔍 like, this is the spot.
• add — if it's true, we also register the retimers we find 👑 if it's false we just... look at them. respectfully. 🙈

---

🦋 DESCRIPTION 🦋

so first thing, it brings the sideband into a state where retimers can actually be accessed 💫 like it's setting the mood, getting the sideband ready for guests.

then it tries to enumerate the on-board retimers that are connected to port 🌈 that's the main character moment.

if add is set, the found retimers get registered as children of port 🫶 cute family tree, honestly.

and lowkey important: it does not scan for cable retimers for now 💀 that's just not what we're doing today. periodt.

---

🔥 RETURN 🔥

• 0 on success ⭐ slay, we ate.
• a negative errno otherwise 😭 that's the "it's giving error" case.

---

💜 SEE ALSO 💜

• Kernel file ./drivers/thunderbolt/retimer.c 🍓
• tb_retimer_nvm_read(9) — the related one, iykyk
• tb_retimer_remove_all(9) — cleanup bestie✨

---

and that's the page, no notes 💅

this beauty came out of ./drivers/thunderbolt, dated October 2026 🌸 go off, kernel docs, we love to see it 🧚‍♀️💖