scsi_io_completion(9)

🌈 scsi_io_completion(9) 🌈

✨ NAME ✨

okay bestie, welcome to the Kernel API Manual page for scsi_io_completion — literally completion processing for SCSI commands. that’s the whole vibe. 💅

---

💖 SYNOPSIS 💖

void scsi_io_completion (struct scsi_cmnd *cmd , unsigned int good_bytes
);

---

🎀 ARGUMENTS 🎀

• cmd — the command that is finished. yep, the finished one, bestie.
• good_bytes — number of processed bytes. that’s how many bytes got processed. ✨

---

🌸 DESCRIPTION 🌸

okay so here’s the plan: we will finish off the specified number of sectors. if we are done, the command block will be released and the queue function will be goosed. yes, goosed. that’s the actual energy. 🫶

if we are not done, then we have to figure out what to do next:

• a) We can call scsi_mq_requeue_cmd. The request will be unprepared and put back on the queue. Then a new command will be created for it. This should be used if we made forward progress, or if we want to switch from READ(10) to READ(6) for example.
• b) We can call scsi_io_completion_action. The request will be put back on the queue and retried using the same command as before, possibly after a delay.
• c) We can call scsi_end_request with blk_stat other than BLK_STS_OK, to fail the remainder of the request.

---

🦋 SEE ALSO 🦋

Kernel file: ./drivers/scsi/scsi_lib.c

the whole squad, in order, no cap:

• __scsi_queue_insert(9)
• scsi_queue_insert(9)
• scsi_failures_reset_retries(9)
• scsi_check_passthrough(9)
• scsi_execute_cmd(9)
• scsi_run_queue(9)
• scsi_result_to_blk_status(9)
• scsi_rq_err_bytes(9)
• scsi_alloc_sgtables(9)
• scsi_initialize_rq(9)
• scsi_alloc_request(9)
• scsi_dispatch_cmd(9)
• scsi_get_internal_cmd(9)
• scsi_put_internal_cmd(9)
• scsi_device_from_queue(9)
• scsi_block_requests(9)
• scsi_unblock_requests(9)
• scsi_mode_select(9)
• scsi_mode_sense(9)
• scsi_test_unit_ready(9)
• scsi_device_set_state(9)
• scsi_evt_emit(9)
• scsi_evt_thread(9)
• sdev_evt_send(9)
• sdev_evt_alloc(9)
• sdev_evt_send_simple(9)
• scsi_device_quiesce(9)
• scsi_device_resume(9)
• scsi_internal_device_block_nowait(9)
• scsi_device_block(9)
• scsi_internal_device_unblock_nowait(9)
• scsi_internal_device_unblock(9)
• scsi_block_targets(9)
• scsi_host_block(9)
• scsi_kmap_atomic_sg(9)
• scsi_kunmap_atomic_sg(9)
• scsi_vpd_lun_id(9)
• scsi_vpd_lun_serial(9)
• scsi_vpd_tpg_id(9)
• scsi_build_sense(9)

---

🫶 source/version: ./drivers/scsi · October 2026 · xoxo, your Unix bestie 💅