ata_eh_qc_retry(9)

✨ NAME ✨

ata_eh_qc_retry — from the Kernel API Manual, aka ata_eh_qc_retry(9) — tells the midlayer to retry an ATA command after EH. 💖

🛠️ SYNOPSIS 🛠️

void ata_eh_qc_retry (struct ata_queued_cmd *qc );

🎀 ARGUMENTS 🎀

• qc — command to retry. That's the whole assignment, bestie. 🫶

💅 DESCRIPTION 💅

Okay so picture this: you're telling the mid and upper layers that an ATA command should be retried. This is the function for that. It's meant to be used from EH. ✨

The SCSI midlayer limits the number of retries to scmd->allowed. And scmd->allowed is incremented for commands which get retried due to unrelated failures — that's when qc->err_mask is zero. 🫶

🔗 SEE ALSO 🔗

Kernel file: ./drivers/ata/libata-eh.c — and yes, the whole friend group is here:

• __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_cmd_error_handler(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_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)

okay that's the whole page, bestie 💖 the source/version is ./drivers/ata, the date is October 2026, and this iconic little manual page is ata_eh_qc_retry(9). slay. 🎀