ata_eh_acquire(9)

💅 ata_eh_acquire(9) 💅

okay bestie, welcome to the Kernel API Manual entry for ata_eh_acquire(9) — this one is short, iconic, and very much about ownership. 🎀

---

✨ NAME ✨

ata_eh_acquire — acquire EH ownership

🌸 SYNOPSIS 🌸

void ata_eh_acquire (struct ata_port *ap );

🎀 ARGUMENTS 🎀

• ap — the ATA port you're acquiring EH ownership for 💖

💅 DESCRIPTION 💅

Okay so ata_eh_acquire acquires EH ownership for ap. That’s literally the main character move. ✨

This is the basic exclusion mechanism for ports sharing a host. Only one port hanging off the same host can claim the ownership of EH, periodt. No cap. 🫶

🔒 LOCKING: EH context.

🔥 SEE ALSO 🔥

Kernel file: ./drivers/ata/libata-eh.c — that’s home base, iykyk. 🌈

The whole squad, all exact and all iconic: __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_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_eh_qc_retry(9).

More of the squad: 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).

And the rest, no one left behind: 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).

🫶 xoxo, your kernel bestie — source/version: ./drivers/ata; date: October 2026. mwah 💋