ata_scsi_cmd_error_handler(9)

💖 NAME 💖

okay bestie, meet ata_scsi_cmd_error_handler — the error callback for a list of commands. This page is from the Kernel API Manual, and it is so iconic for anyone deep in libata error handling. 🎀

✨ SYNOPSIS ✨

int ata_scsi_cmd_error_handler (struct Scsi_Host *host , struct ata_port *ap , struct list_head *eh_work_q );

🎀 ARGUMENTS 🎀

• host — the scsi host containing the port. 🫶
• ap — the ATA port within the host.
• eh_work_q — the list of commands to process.

🦋 DESCRIPTION 🦋

So this function processes the given list of commands and returns the finished ones to ap->eh_done_q. It is the first part of the libata error handler that processes a given list of failed commands. periodt. 💅

And the return value? It is the number of commands that timed out. no cap. ✨

🌈 SEE ALSO 🌈

Kernel file ./drivers/ata/libata-eh.c — plus the whole bestie lineup:

• __ata_ehi_push_desc(9)
• ata_ehi_push_desc(9)
• ata_ehi_clear_desc(9)
• ata_port_desc(9)
• ata_port_pbar_desc(9)
• ata_internal_cmd_timeout(9)
• ata_internal_cmd_timed_out(9)
• ata_eh_acquire(9)
• ata_eh_release(9)
• ata_scsi_error(9)
• ata_scsi_port_error_handler(9)
• ata_port_wait_eh(9)
• ata_eh_set_pending(9)
• ata_qc_schedule_eh(9)
• ata_std_sched_eh(9)
• ata_std_end_eh(9)
• ata_port_schedule_eh(9)
• ata_link_abort(9)
• ata_port_abort(9)
• __ata_port_freeze(9)
• ata_port_freeze(9)
• ata_eh_freeze_port(9)
• ata_eh_thaw_port(9)
• ata_eh_qc_complete(9)
• ata_eh_qc_retry(9)
• ata_dev_disable(9)
• ata_eh_detach_dev(9)
• ata_eh_about_to_do(9)
• ata_eh_done(9)
• ata_err_string(9)
• atapi_eh_tur(9)
• ata_eh_decide_disposition(9)
• ata_eh_request_sense(9)
• atapi_eh_request_sense(9)
• ata_eh_analyze_serror(9)
• ata_eh_analyze_tf(9)
• ata_eh_speed_down_verdict(9)
• ata_eh_speed_down(9)
• ata_eh_worth_retry(9)
• ata_eh_quiet(9)
• ata_eh_link_set_lpm(9)
• ata_eh_link_autopsy(9)
• ata_eh_autopsy(9)
• ata_get_cmd_name(9)
• ata_eh_link_report(9)
• ata_eh_report(9)
• ata_eh_set_mode(9)
• atapi_eh_clear_ua(9)
• ata_eh_maybe_retry_flush(9)
• ata_eh_recover(9)
• ata_eh_finish(9)
• ata_std_error_handler(9)
• ata_eh_handle_port_suspend(9)
• ata_eh_handle_port_resume(9)

mwah 💋 — this whole page is from the Kernel API Manual, source/version ./drivers/ata, dated October 2026, and it is all about ata_scsi_cmd_error_handler(9). go touch some kernel code, bestie 🫶✨