ata_eh_link_set_lpm(9)

💅 ata_eh_link_set_lpm — configure SATA interface power management

okay bestie, so this one's a kernel function from the Kernel API Manual (the 9 section, obviously — we're in kernel-land now 🧚) and honestly? it's giving "let me handle the power stuff so you don't have to" energy. it lives in the kernel file ./drivers/ata/libata-eh.c and it's all about configuring SATA interface power management. slay. 💖

---

✨ SYNOPSIS ✨

int ata_eh_link_set_lpm (struct ata_link *link , enum ata_lpm_policy
policy , struct ata_device **r_failed_dev );

like yes, three args, super chill, no cap. 🫶

---

🎀 ARGUMENTS 🎀

• link — the link you wanna configure, bestie. that's the main character right there 👑
• policy — the link power management policy. this is the vibe you're setting, pick wisely 💅
• r_failed_dev — out parameter for failed device. it's how the function tells you who fumbled the bag, if anyone did 😭

---

🦋 DESCRIPTION 🦋

so what it does: Enable SATA Interface power management. periodt. 🔥

and then, specifically — this is the important bit, don't skip it — it will enable Device Interface Power Management (DIPM) for the min_power and medium_power_with_dipm policies. literally only those two, okay? those are the ones. 🌸

after that lil DIPM moment, it calls driver specific callbacks for enabling Host Initiated Power management. so it's like, "here's your DIPM, and now let me hand off to the driver-specific callback to do the HIPM part" 🤝

LOCKING: EH context. no like actually — EH context, that's the rule, do not come in here from anywhere else 🙈

---

⭐ RETURN ⭐

• 0 on success 💚
• -errno on failure 💀

that's it, that's the whole return contract, we love a simple interface.

---

🌈 SEE ALSO 🌈

okay so the source of all this is Kernel file ./drivers/ata/libata-eh.c and then there is a whole friend group of related functions, iykyk. full list, no skips, here we go:

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

---

and that's the whole page, bestie 💜 this little icon came out of ./drivers/ata, dated October 2026, and the manual name is the Kernel API Manual — so like, cite it properly and go configure some power management. mwah 🎀✨🦋