asd_abort_task(9)

💅 asd_abort_task(9) — a Kernel API Manual moment

okay bestie, welcome to the Kernel API Manual, because today we're learning about asd_abort_task. yes it's giving kernel-dev realness. stay with me 🫶

---

✨ NAME ✨

asd_abort_task — ABORT TASK TMF. that's it, that's the whole vibe. 💅

---

🦋 SYNOPSIS 🦋

int asd_abort_task (struct sas_task *task );

---

🎀 ARGUMENTS 🎀

• task — the task to be aborted. the one we're cancelling, the main character we're sending home early 😭

---

🌸 DESCRIPTION 🌸

okay so before you call ABORT TASK, you gotta do the setup first, and this part is NOT optional, no cap. you OR the task state flags with SAS_TASK_STATE_ABORTED — unless SAS_TASK_STATE_DONE is already set, okay? — and you do that under the task_state_lock IRQ spinlock. then, and only then, ABORT TASK must be called. like, must must. 🔥

this whole thing implements the ABORT TASK TMF, I_T_L_Q nexus. iconic. periodt.

so when ABORT TASK comes back, the caller of ABORT TASK checks, in this order: first task->task_state_flags, and then the return value of ABORT TASK. order matters, bestie, don't flip it 🙈

case one: the done bit is set. if the task has task state bit SAS_TASK_STATE_DONE set, then the task was completed successfully prior to it being aborted. plot twist. 💀 in this case the caller of ABORT TASK has the responsibility to call task->task_done xor free the task, depending on their framework. and the return code is TMF_RESP_FUNC_FAILED in this case. yes, even though it completed. that's just how it is. 😭

case two: the done bit is not set. else, SAS_TASK_STATE_DONE bit is not set, and:

• if the return code is TMF_RESP_FUNC_COMPLETE, then the task was aborted successfully 🎉 the caller of ABORT TASK has responsibility to call task->task_done to finish the task, xor free the task depending on their framework.
• else the ABORT TASK returned some kind of error. and this is the important part: the task was _not_ cancelled. ⚠️ nothing can be assumed. like literally nothing. the caller of ABORT TASK may wish to retry. your call, king. 👑

real talk: "nothing can be assumed" is doing SO much heavy lifting in that sentence. respect it. 🫡

---

⭐ RETURN ⭐

SAS TMF responses (see sas_task.h), plus -ENOMEM and -SAS_QUEUE_FULL. those are the possible moods this function can come back in. 🌈

---

💖 SEE ALSO 💖

• Kernel file ./drivers/scsi/aic94xx/aic94xx_tmf.c — the source, go read it, iykyk 📖
• asd_initiate_ssp_tmf(9)
• asd_query_task(9)

---

and that's the page, bestie!! 🧚 go forth and abort your tasks responsibly 💜

signed off with love from ./drivers/scsi/aic94xx, dated October 2026, page asd_abort_task(9) — mwah 🎀✨