target_submit_cmd(9)

📦 version 7.3.1, in nixpkgs unstable

💖 target_submit_cmd — NAME 💖

okay so bestie, welcome to the Kernel API Manual ✨ this one is all about target_submit_cmd — it looks up an unpacked LUN and submits an uninitialized se_cmd. that's the whole vibe 💅

🦋 SYNOPSIS 🦋

void target_submit_cmd (struct se_cmd *se_cmd , struct se_session *se_sess , unsigned char *cdb , unsigned char *sense , u64 unpacked_lun , u32 data_length , int task_attr , int data_dir , int flags );

like, yes, that is a lot of arguments. she's an icon, she's high-maintenance, we love her 💜

🌸 ARGUMENTS 🌸

  • se_cmd — the command descriptor you're submitting. the main character of this whole situation 👑
  • se_sess — the associated se_sess for the endpoint. her plus-one 🫶
  • cdb — pointer to the SCSI CDB
  • sense — pointer to the SCSI sense buffer
  • unpacked_lun — the unpacked LUN to reference for struct se_lun
  • data_length — the fabric's expected data transfer length
  • task_attr — the SAM task attribute
  • data_dir — the DMA data direction
  • flags — flags for command submission, straight from target_sc_flags_tables

ngl that's a full roster but every single one is doing her job okay 😭

✨ DESCRIPTION ✨

Task tags are supported — but only if the caller has set se_cmd->tag. no tag, no tag support, that's the rule 💅

This may only be called from process context, and it also currently assumes internal allocation of the fabric payload buffer by target-core. so like, don't come at her from interrupt context, she's not built for that energy 🙈

It also assumes internal target core SGL memory allocation.

⚠️ okay this next part is important, so listen up bestie: this function must only be used by drivers that do their own sync during shutdown and that do not use target_stop_session. and if there's a failure? this function will call into the fabric driver's queue_status with a CHECK_CONDITION. literally it will snitch to queue_status, that's the whole move 💀

🎀 SEE ALSO 🎀

Kernel file ./drivers/target/target_core_transport.c

like a whole friend group fr fr 🌈

✨ and that's the page! ✨ this one lives in ./drivers/target, dated October 2026, and honestly? she ate. go read the kernel source bestie, ily, bye 💖🦋🎀

📦 where this page comes from