starget_for_each_device(9)

💅 starget_for_each_device — from the Kernel API Manual, bestie ✨

okay so picture this: you're in the Kernel API Manual, section 9, and today's main character is starget_for_each_device. say hi 👋

---

🌸 NAME 🌸

starget_for_each_device — the little helper that walks all the devices of a target. yes, all of them. bestie behaviour fr fr 🫶

---

✨ SYNOPSIS ✨

void starget_for_each_device (struct scsi_target *starget , void *data ,
void (*fn)(struct scsi_device *, void *) );

---

🎀 ARGUMENTS 🎀

• starget — the target whose devices we wanna iterate over. she's the one holding the whole group chat together 💅
• data — opaque stuff that gets passed to every single function call. no questions asked, it's opaque, we don't look inside 🙈
• fn — the function to call on each device. she gets called once per device, one at a time, very demure ✨

---

🦋 DESCRIPTION 🦋

So this one traverses over each device of starget — like scrolling through the timeline, one device at a time 💫

⚠️ okay this part is IMPORTANT, no cap: the devices have a reference that must be released by scsi_host_put when breaking out of the loop. if you dip out early and forget to release it, that reference is just… sitting there. not slay. 😭

---

🔥 SEE ALSO 🔥

Kernel file ./drivers/scsi/scsi.c and honestly the whole friend group:

• scsi_finish_command(9)
• scsi_change_queue_depth(9)
• scsi_track_queue_full(9)
• scsi_vpd_inquiry(9)
• scsi_get_vpd_page(9)
• scsi_get_vpd_buf(9)
• scsi_attach_vpd(9)
• scsi_report_opcode(9)
• scsi_cdl_check(9)
• scsi_cdl_enable(9)
• scsi_device_get(9)
• scsi_device_put(9)
• __starget_for_each_device(9)
• __scsi_device_lookup_by_target(9)
• scsi_device_lookup_by_target(9)
• __scsi_device_lookup(9)
• scsi_device_lookup(9)

---

okay that's the whole page, you ate that 🍓 stay hydrated, release your references, and remember: this iconic lil page lives in ./drivers/scsi, dated October 2026 — the future is now and she's serving kernel documentation 💜✨