scsi_scan_target(9)

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

Okay so picture this: you're deep in <pink>drivers/scsi</pink> land and you need to go find a target id and everything chillin' on it. That's this function. It's the little gremlin that goes snooping. Let's get into it 💖

---

✨ NAME ✨

scsi_scan_target — go scan a target id, and honestly possibly all the LUNs sitting on that target too 👀

---

✨ SYNOPSIS ✨

void scsi_scan_target (struct device *parent , unsigned int channel ,
       unsigned int id , u64 lun , enum scsi_scan_mode rescan );

Like yes it returns void, no it's not gonna hand you a result, it just does the thing and dips 🫶

---

✨ ARGUMENTS ✨

• parent — the host you're scanning. Your main character device, basically 👑
• channel — the channel you're scanning. Pick your lane bestie 🌈
• id — the target id you're scanning. The actual one we came here for 💅
• lun — either one specific LUN to scan, or SCAN_WILD_CARD if you're feeling unhinged and want the whole menu 🍓
• rescan — this one gets passed straight down to the LUN scanning routines, so it's like the vibe you're sending:
  • SCSI_SCAN_INITIAL — no rescan, fresh start, first-day-of-school energy 🎀
  • SCSI_SCAN_RESCAN — rescan the LUNs that already exist, we're going back in 🔁
  • SCSI_SCAN_MANUAL — force scanning even if… ✨

fr fr the original page just stops right there after "even if". No cap, it cliffhangs. I'm not about to invent the rest for you 😭 that's above my pay grade.

---

✨ DESCRIPTION ✨

So what it's actually doing: scanning the target id on parent, on that channel, and that id. It scans at least LUN 0 — LUN 0 is the bare minimum, the non-negotiable, the entry-level icon — and possibly all the LUNs on the target id if things go that way 🌸

The strategy, in order, because of course there's an order:

1. First it tries a REPORT LUN scan. Efficient queen. ✨
2. If that doesn't scan the target, it falls back to a sequential scan of the LUNs on the target id. Old school but it gets the job done 💪

So it's giving "try the smart way first, brute-force it second." Iconic behavior tbh.

---

✨ SEE ALSO ✨

Kernel file ./drivers/scsi/scsi_scan.c — and the whole extended friend group 💜

• scsi_complete_async_scans(9)
• scsi_unlock_floptical(9)
• scsi_alloc_sdev(9)
• scsi_target_reap_ref_release(9)
• scsi_alloc_target(9)
• scsi_target_reap(9)
• scsi_sanitize_inquiry_string(9)
• scsi_probe_lun(9)
• scsi_add_lun(9)
• scsi_inq_str(9)
• scsi_probe_and_add_lun(9)
• scsi_sequential_lun_scan(9)
• scsi_report_lun_scan(9)
• scsi_add_device(9)
• scsi_prep_async_scan(9)
• scsi_finish_async_scan(9)
• scsi_scan_host(9)
• scsi_get_pseudo_sdev(9)

---

And that's the whole page bestie!! 🦋 Coming at you live from ./drivers/scsi, dated October 2026 — so yeah, mark your calendar, this manpage is from the future 💀✨ mwah, go scan something responsibly 🎀