usb4_port_router_offline(9)

📦 version 7.3.1, in nixpkgs unstable

💅 usb4_port_router_offline(9) — Kernel API Manual, but make it make sense

okay so bestie, welcome to the Kernel API Manual ✨ we're doing usb4_port_router_offline(9) today and honestly? it's giving "small function, big responsibility" energy 👑

🌸 NAME 🌸

usb4_port_router_offline — put the USB4 port into offline mode 🫶 like, actually take it offline. retire it. send it to its room.

✨ SYNOPSIS ✨

int usb4_port_router_offline (struct tb_port *port );

that's it. one arg. one int back. lowkey elegant 💅

🎀 ARGUMENTS 🎀

  • port — the USB4 port in question 🦋 yes, the actual port. no, not a different one. that port.

💖 DESCRIPTION 💖

so basically this function puts the USB4 port into offline mode ✨ and in this mode the port does not react on hotplug events anymore — like it fully stopped checking its notifs, no cap 😭💀

and here's the part where you must pay attention bestie, because it's not a vibe suggestion: this needs to be called before retimer access is done when the USB4 links is not up 🔥 Like... before. Not after. Not "whenever u get around to it". BEFORE. periodt.

ngl this is one of those ordering things that will absolutely ruin ur whole day if u get it backwards 🙈

⭐ RETURN ⭐

  • 0 on success 🎉 slay
  • negative errno otherwise 😭 i.e. it did not slay, check ur errno

🦋 SEE ALSO 🦋

okay so the kernel file to go look at is ./drivers/thunderbolt/usb4.c 📁 and then there is a whole friend group of related functions, like genuinely the entire group chat, here they all are 👇

iykyk 💜

anyway that's the whole page bestie, go forth and take that port offline at the correct time 🧚💖

source: ./drivers/thunderbolt — dated October 2026 🎀 mwah, see u in the next manpage 👑🌸
📦 where this page comes from