github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-11-06 21:58:01 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

scsi: core: Document the role of scsi_done()

Browse Source 
Document the role of scsi_done() and also how it deals with commands owned
by the SCSI error handler.

Signed-off-by: Bart Van Assche <bvanassche@acm.org>
Link: https://patch.msgid.link/6edb00749da7a5ce9b7752d389ad2ed5a38776e4.1792022610.git.bvanassche@acm.org
Signed-off-by: Martin K. Petersen (Oracle) <mkp@kernel.org>
This commit is contained in:
Bart Van Assche 2026-10-14 17:05:10 -07:00 committed by Martin K. Petersen (Oracle)
parent 7cd44f40fe
commit cfb7224381
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
drivers/scsi/scsi_lib.c
View File

@ -1789,6 +1789,20 @@ static void scsi_done_internal(struct scsi_cmnd *cmd, bool complete_directly)
blk_mq_complete_request(req);
}
/**
* scsi_done - Notify the SCSI mid-layer that a command has completed
* @cmd: Completed SCSI command
*
* Called by a SCSI low-level driver to notify the SCSI mid-layer that the
* command has completed. There are two cases:
*
* - The SCSI error handler does not own @cmd. In this case scsi_complete()
* decides how to complete the command based on the value of @cmd->result.
* - The SCSI error handler owns @cmd because scsi_timeout() has set
* SCMD_STATE_COMPLETE. In this case this function has no effect, @cmd->result
* is ignored and the SCSI error handler decides whether to retry or fail
* @cmd. See also scmd_eh_abort_handler() and scsi_eh_flush_done_q().
*/
void scsi_done(struct scsi_cmnd *cmd)
{
scsi_done_internal(cmd, false);