scsi_alloc_target(9)

💅 scsi_alloc_target(9) — Kernel API Manual 🎀

okay so bestie, welcome to the manual page for scsi_alloc_target 💖 this one lives in the Kernel API Manual and honestly? it's a whole vibe. it's giving "matchmaker for SCSI targets" ✨

---

✨ NAME ✨

scsi_alloc_target — allocate a new or find an existing target 🌸

like, it either finds you a target that already exists or it makes a brand new one. no cap.

---

🦋 SYNOPSIS 🦋

struct scsi_target * scsi_alloc_target (struct device *parent , int
channel , uint id );

---

🎀 ARGUMENTS 🎀

• parent — the parent of the target 🙈 full disclosure: it doesn't have to be a SCSI host, so no pressure
• channel — the target channel number ✨ if there are no channels at all, it's just zero
• id — the target id number 🫶

---

💜 DESCRIPTION 💜

okay so here's the tea ☕ if a target already exists and it hasn't already gone into STARGET_DEL state, you get that existing target back. iconic. but if it's already in STARGET_DEL? nope, bye — it allocates a shiny new target for you instead 💅

and listen, this is the important part, so pay attention bestie 👑: the target is returned with an incremented reference, which means the caller is responsible for both reaping and doing a last put. not me handing you a whole responsibility like that 😭 but fr fr, that's on you now.

🚨 reminder: incremented reference = your problem now. reap it, then do the last put. don't leave it hanging 💀

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/scsi_scan.c — plus the whole friend group 💖:

• scsi_complete_async_scans(9)
• scsi_unlock_floptical(9)
• scsi_alloc_sdev(9)
• scsi_target_reap_ref_release(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_scan_target(9)
• scsi_prep_async_scan(9)
• scsi_finish_async_scan(9)
• scsi_scan_host(9)
• scsi_get_pseudo_sdev(9)

---

and that's the page babes 🫶 shoutout to ./drivers/scsi for keeping it real, dated October 2026 ✨ mwah 💋 go forth and scsi_alloc_target responsibly 🌟