__ata_port_freeze(9)

🦋 __ata_port_freeze(9) — Kernel API Manual 🦋

okay so bestie, welcome to the Kernel API Manual page for __ata_port_freeze(9). it's giving emergency-freeze-for-an-ATA-port energy, and honestly? iconic. 💅

🌸 NAME 🌸

__ata_port_freeze - freeze port

✨ SYNOPSIS ✨

void __ata_port_freeze (struct ata_port *ap );

🎀 ARGUMENTS 🎀

• ap — ATA port to freeze. that's the port getting frozen, no cap. 🧊

💅 DESCRIPTION 💅

This function is called when an HSM violation or some other condition disrupts normal operation of the port. HSM violation? yes. some other condition? also yes. either way, the port is not having a normal one. 😭

A frozen port is not allowed to perform any operation until the port is thawed, which usually follows a successful reset. so it's lowkey on pause until the reset goes through. ⏸️✨

The ap->ops->freeze callback can be used for freezing the port hardware-wise (e.g. mask interrupt and stop DMA engine). if you can freeze it at the hardware level, that's the move. 💅

If a port cannot be frozen hardware-wise, the interrupt handler must ack and clear interrupts unconditionally while the port is frozen. that's a hard must, bestie — no skipping it. 🫶

LOCKING: spin_lock_irqsave(host lock) — that's the locking rule, periodt. 🔒

🔥 SEE ALSO 🔥

Kernel file ./drivers/ata/libata-eh.c — and here's the whole friend group:

• __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_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 page lives in the Kernel API Manual, comes from ./drivers/ata, is dated October 2026, and answers to __ata_port_freeze(9). slay.