sci_port_remove_phy(9)

📦 version 7.3.1, in nixpkgs unstable

💅 sci_port_remove_phy(9) — from the Kernel API Manual, bestie

okay so this is a page straight out of the Kernel API Manual, and the star of the show is sci_port_remove_phy(9). she's a kernel function, she lives in ./drivers/scsi/isci, and she's here to take a phy off a port. yes that's the whole thing. no cap, that's her job. 🦋

🎀 NAME 🎀

sci_port_remove_phy — and ngl, the name line in the original is literally just empty. the manpage left it blank, so i'm leaving it blank too, but like... with love. this function removes a phy from a port. that's the vibe. ✨

🌸 SYNOPSIS 🌸

enum sci_status sci_port_remove_phy (struct isci_port *iport , struct isci_phy *iphy );

that's it, that's the whole signature. two pointers in, one enum sci_status out. iconic honestly. 🫶

🍓 ARGUMENTS 🍓

  • iport — this parameter specifies the port in which the phy will be added. 💖 (yes, the docs literally say "added" here. i'm just the messenger. copying the lore exactly as it was given to me, bestie.)
  • iphy — this parameter is the phy which is to be added to the port. ✨ (same energy. the original text says "added," and i am not about to start rewriting source material on you.)
real talk: this whole page is about removing a phy, but the argument blurbs say "added." that's not me being messy, that's the doc being the doc. i'm keeping every word. 🙈

🔥 DESCRIPTION 🔥

this method will remove the PHY from the selected PORT. periodt. 💅

this method returns an enum sci_status. and here's the breakdown:

  • SCI_SUCCESS — the phy has been removed from the port. slay. 👑
  • any other status — that's a failure to add the phy to the port.
⚠️ heads up, bestie: the failure line in the original genuinely says "failure to add the phy to the port" — in a function about removing it. i am not fixing it, i am not guessing at what it "should" say, i am just serving it to you exactly as written. facts stay facts. 🔥

🌈 SEE ALSO 🌈

the kernel file to go look at is ./drivers/scsi/isci/port.c, and then the whole friend group:

like thirteen whole functions, all in the sci_port_* / isci_port_* cinematic universe. main character energy across the board. 🧚

okay that's the page!! before i go — the source for this one is ./drivers/scsi/isci, the version stamp says October 2026, and the page title is sci_port_remove_phy(9). that's the sign-off, mwah, go read sci_port_add_phy(9) next, she's right there in SEE ALSO and she's literally the inverse of this one. 💜🎀

📦 where this page comes from