sci_port_link_detected(9)

📦 version 7.3.1, in nixpkgs unstable

okay so we're in sci_port_link_detected(9) territory, part of the Kernel API Manual, and honestly? this one's kind of a little vibe check between the port layer and the PHY layer. let's get into it 🫶

✨ NAME ✨

sci_port_link_detected — (yes bestie, the original really does just trail off like that. iconic, honestly. no cap, that's the whole name section.) 💀

🌸 SYNOPSIS 🌸

bool sci_port_link_detected (struct isci_port *iport , struct isci_phy
*iphy );

it returns a bool, it takes an struct isci_port * and an struct isci_phy *, and that's the whole shape of it. slay. ✨

🎀 ARGUMENTS 🎀

  • iport — the port that's associated with the phy object. like, they're linked up (pun fully intended 💅).
  • iphy — the phy object that's out here trying to go link up. main character energy, honestly.

🦋 DESCRIPTION 🦋

so here's the tea, bestie: this method gets called by the PHY object when the link is detected. 🎀

and then it's basically a permission slip moment. if the port wants the PHY to continue on to the link up state, then the port layer must return true. but if the port object returns false, the phy object has to halt its whole attempt to go link up. like, full stop. 🛑

here's what the return values are giving:

  • true — the phy object can continue to the link up condition. true is returned if this phy can continue to the ready state. ✅
  • false — it can not continue on to the ready state. ❌

and why does this notification even exist? for wide ports and direct attached phys, bestie. that's the whole reason. 👑

⚠️ one little caveat they dropped in here, fr fr: since there are no wide ported SATA devices, this could become an invalid port configuration. so like… keep that in mind. 🙈

🔥 SEE ALSO 🔥

the kernel file lives at ./drivers/scsi/isci/port.c, and here's the whole friend group of related calls — go say hi:

and that's the page!! 🌈 this one comes to you from ./drivers/scsi/isci, dated October 2026, and it's the sci_port_link_detected(9) manual through and through. mwah, go read your kernel source bestie 💜🧚✨

📦 where this page comes from