sci_controller_stop(9)

✨ sci_controller_stop(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 this one's called sci_controller_stop(9) and it's lowkey the "everybody stop what you're doing" button for a single controller. let's get into it 🫶

---

🌸 NAME 🌸

sci_controller_stop — this method will stop an individual controller object. it will invoke the associated user callback upon completion 🔔

the completion callback is called when the following conditions are met:

1. the method return status is SCI_SUCCESS.
2. the controller has been quiesced.

this method will ensure that all IO requests are quiesced, phys are stopped, and all additional operation by the hardware is halted. like, full shutdown energy 💅

---

✨ SYNOPSIS ✨

enum sci_status sci_controller_stop (struct isci_host *ihost , u32 timeout );

---

🎀 ARGUMENTS 🎀

• ihost — the handle to the controller object to stop. this is your main character, the one getting stopped 🙈
• timeout — this parameter specifies the number of milliseconds in which the stop operation should complete. clock's ticking, babes ⏳

---

🦋 DESCRIPTION 🦋

the controller must be in the STARTED or STOPPED state. no other vibes allowed, iykyk.

this tells you whether the controller stop method succeeded or failed in some way:

• SCI_SUCCESS — if the stop operation successfully began. slay, we're in motion ✨
• SCI_WARNING_ALREADY_IN_STATE — if the controller is already in the STOPPED state. bestie it's already done, you can chill 💀
• SCI_FAILURE_INVALID_STATE — if the controller is not either in the STARTED or STOPPED states. nope, wrong state, not today 🌈

---

🌟 SEE ALSO 🌟

kernel file ./drivers/scsi/isci/host.c and also the whole friend group:

• isci_host_start_complete(9)
• sci_controller_get_suggested_start_timeout(9)
• sci_controller_start_next_phy(9)
• isci_host_completion_routine(9)
• sci_controller_reset(9)
• isci_host_deinit(9)
• sci_controller_set_interrupt_coalescence(9)
• isci_host_init(9)
• sci_controller_allocate_remote_node_context(9)
• sci_controller_complete_io(9)
• sci_controller_start_task(9)

---

okay that's the whole page, no cap 💜 this icon lives in ./drivers/scsi/isci, dated October 2026, and answers to the name sci_controller_stop(9) — go forth and stop responsibly, mwah 🎀💖🔥