tb_port_wait_for_link_width(9)

📦 version 7.3.1, in nixpkgs unstable

okay bestie, so this is tb_port_wait_for_link_width(9) from the kernel API manual — yes, the kernel manual, we're doing big-brain hours rn 🧠✨ — and it's literally just "sit there and wait until the link gets as wide as you asked for." That's the whole vibe. Let's get into it 🎀

✨ NAME ✨

tb_port_wait_for_link_width — wait until the link reaches a specific width, no cap, just vibes and patience ⏳

🦋 SYNOPSIS 🦋

int tb_port_wait_for_link_width (struct tb_port *port , unsigned int
width , int timeout_msec );

look at that signature. chef's kiss. very demure, very mindful 👑

🌸 ARGUMENTS 🌸

  • port — the port you're waiting on 🫶 like, this is the main character of the whole call
  • width — the expected link width, which is a bitmask bestie, not just a plain number, iykyk 🎀
  • timeout_msec — timeout in ms, aka how long you're willing to stand there waiting before you give up 💀

💜 DESCRIPTION 💜

okay so here's the tea ☕ — this one should be used after both ends of the link have been bonded, or after bonding has been disabled, to wait until the link actually reaches the expected state. it's giving "we set it up, now we manifest it" energy ✨

and the fun part: you can pass it a mask of expected widths. so it's not one single width, it's a whole lil squad of acceptable widths 🌈

🔥 RETURN 🔥

the way this function is so straightforward, obsessed:

  • 0 — if the link reaches any of the specified widths. periodt, we love a success 💖
  • -ETIMEDOUT — if the link does not reach the specified width. it just didn't happen for us 😭
  • Negative errno — another error occurred. yeah, something else went sideways, no further explanation, that's the whole note 🙈

👑 SEE ALSO 👑

the kernel file ./drivers/thunderbolt/switch.c — go read it, bestie, it's the source of truth 📖 — plus this absolutely stacked friend group of related calls:

like, that's a whole friend group and every single one of them got an invite 💌

anyway that's the page 🫶 and before you go — this lil baddie lives in ./drivers/thunderbolt and it's dated October 2026, so go forth, wait for your link width, and slay 💅✨🌸

📦 where this page comes from