__shost_for_each_device(9)

💅 __shost_for_each_device (9) — Kernel API Manual, bestie edition 🎀

okay so like. welcome to the kernel API manual, specifically the page for __shost_for_each_device — and yes the double underscore is part of the name, it's giving "i'm the internal one, don't @ me" energy 💀

✨ NAME ✨

__shost_for_each_device — iterate over all devices of a host (UNLOCKED) 🔓👑

✨ SYNOPSIS ✨

__shost_for_each_device (sdev , shost );

🫶 ARGUMENTS 🫶

• sdev — the struct scsi_device you're using as a cursor, like your little finger on the page tracking where you are 📖
• shost — the struct scsi_host you're iterating over, the main character of this whole thing 👑

🌸 DESCRIPTION 🌸

So this is an iterator that hands you every device attached to shost, one at a time. Cute, right? But — and this is the important part, bestie — it does _not_ take a reference on the scsi_device. not even a little one. so the whole loop has to be protected by shost->host_lock. like, the entire thing. no cap. 🙈

⚠️ NOTE ⚠️

The only reason to use this one is because you need to access the device list in interrupt context. that's it. that's the whole vibe. otherwise you really want to use shost_for_each_device instead — it's right there, it does the reference stuff for you, it's the iconic choice 💅✨

fr fr: if you're not in interrupt context, you're just making extra work for yourself for no reason 😭

---

🦋 SEE ALSO 🦋

• Kernel file ./include/scsi/scsi_device.h
• struct scsi_vpd(9)
• shost_for_each_device(9)
• scsi_device_is_pseudo_dev(9)
• scsi_device_supports_vpd(9)

go read those next, iykyk 💜

---

mwah 💋 this page lives in ./include/scsi, going out in October 2026 — that's the date and the source, bestie, and yes i remembered them both, you're welcome 🫶✨🌈