scu_link_lay...x_hard_reset(9)

💅 scu_link_layer_tx_hard_reset(9) — the kernel API manual, but make it make sense

okay so bestie, this is a page from the Kernel API Manual (yes, section 9, the ~spicy~ one) and the function is scu_link_layer_tx_hard_reset. Buckle up, it's a vibe. 🦋

---

✨ NAME ✨

scu_link_layer_tx_hard_reset — and honestly the manpage just leaves it hanging there with a lil dangling dash and no description, so like… that's all the NAME section gives us, no cap. 💀

---

🌸 SYNOPSIS 🌸

void scu_link_layer_tx_hard_reset (struct isci_phy *iphy );

that's it. that's the whole signature. it returns void, so don't go looking for a return value, bestie, there isn't one. 🎀

---

🫶 ARGUMENTS 🫶

• iphy — this is the struct isci_phy object to stop. it's giving "main character" energy, it's the one taking the hard reset. 💅

---

🔥 DESCRIPTION 🔥

okay so this is the good part. this method will transmit a hard reset request on the specified phy. literally, that's the whole job. ✨

here's the thing though, the SCU hardware is highkey demanding about it — it requires that we reset the OOB state machine and set the hard reset bit in the phy configuration register. two things. non-negotiable. the hardware said periodt. 👑

and then, because apparently that wasn't enough drama, we then must start OOB over with the hard reset bit set. so like… OOB gets a whole second act, but the bit stays set the entire time. do not skip that part, i'm begging. 😭

ngl the order matters here: reset the OOB state machine, set the hard reset bit in the phy configuration register, then restart OOB with that bit still set. that's the recipe, chef. 🍓

---

🌈 SEE ALSO 🌈

• the kernel file ./drivers/scsi/isci/phy.c
• phy_get_non_dummy_port(9)
• sci_phy_setup_transport(9)
• sci_phy_complete_link_training(9)
• scu_link_layer_stop_protocol_engine(9)
• isci_phy_control(9)

go read those too, they're all in their flop era together and they ate. 💜

---

🎀 and that's the whole page! source-file-wise it lives under ./drivers/scsi/isci, the page is dated October 2026, and the whole thing is filed as scu_link_lay...x_hard_reset(9) (yes the title is truncated in the original, we don't fix what's iconic, mwah 💋). byeee, go reset some phys responsibly! 👑