iscsi_session_setup(9)

💅 iscsi_session_setup(9) — the Kernel API Manual glow-up ✨

okay so bestie, welcome to iscsi_session_setup(9) 💖 this is one of those kernel API manual pages, and honestly? it's giving "quietly holds everything together" main character energy 🎀 let's get into it.

---

✨ NAME ✨

iscsi_session_setup — create iscsi cls session and host and session 🦋

like yes, all three of those things. it's an overachiever, we love that for it 💅

---

🌸 SYNOPSIS 🌸

struct iscsi_cls_session * iscsi_session_setup (struct iscsi_transport
*iscsit , struct Scsi_Host *shost , uint16_t cmds_max , int dd_size ,
int cmd_task_size , uint32_t initial_cmdsn , unsigned int id );

seven whole arguments, no cap 😭 it's thorough and i respect it.

---

🎀 ARGUMENTS 🎀

• iscsit — the iscsi transport template 🌈 think of it as the blueprint vibe
• shost — the scsi host, the home base for all this 🏠
• cmds_max — how many commands the session can queue 🔥
• dd_size — private driver data size, and it gets added to the session allocation size 🧚
• cmd_task_size — LLD task private data size 💜
• initial_cmdsn — the initial CmdSN ⭐
• id — target ID to add to this session 👑

---

🦋 DESCRIPTION 🦋

so here's the tea ☕ — this one can be used by software iscsi_transports that allocate a session per scsi host. periodt.

and listen, callers should set cmds_max to the largest total number (mgmt + scsi) of tasks they support 👑 because the iscsi layer reserves ISCSI_MGMT_CMDS_MAX tasks for nop handling and login/logout requests. so yeah, don't lowkey forget those, fr fr 💀

bestie please actually set cmds_max to the largest total (mgmt + scsi) number of tasks you support — those management tasks are already spoken for 💖

---

💫 SEE ALSO 💫

Kernel file ./drivers/scsi/libiscsi.c, plus this whole friend group right here 🫶:

• iscsi_prep_data_out_pdu(9)
• iscsi_check_tmf_restrictions(9)
• iscsi_prep_scsi_cmd_pdu(9)
• iscsi_free_task(9)
• __iscsi_put_task(9)
• iscsi_complete_task(9)
• iscsi_complete_scsi_task(9)
• iscsi_alloc_mgmt_task(9)
• iscsi_send_mgmt_task(9)
• iscsi_scsi_cmd_rsp(9)
• iscsi_data_in_rsp(9)
• iscsi_nop_out_rsp(9)
• iscsi_itt_to_task(9)
• __iscsi_complete_pdu(9)
• iscsi_itt_to_ctask(9)
• iscsi_requeue_task(9)
• iscsi_data_xmit(9)
• iscsi_suspend_queue(9)
• iscsi_suspend_tx(9)
• iscsi_suspend_rx(9)
• iscsi_conn_unbind(9)
• iscsi_eh_session_reset(9)
• iscsi_eh_target_reset(9)
• iscsi_eh_recover_target(9)
• iscsi_host_add(9)
• iscsi_host_alloc(9)
• iscsi_host_remove(9)
• iscsi_session_free(9)
• iscsi_session_teardown(9)
• iscsi_conn_setup(9)
• iscsi_conn_teardown(9)

like, the whole squad shows up 😭 obsessed.

---

mwah 💋 that's the whole page — brought to you by ./drivers/scsi, dated October 2026, in iscsi_session_setup(9). slay, go build something iconic ✨💅