sata_link_scr_lpm(9)

💅 sata_link_scr_lpm(9) — like, the Kernel API Manual page you actually wanna read 🎀

Okay bestie, buckle up — this is sata_link_scr_lpm from the Kernel API Manual, and it's lowkey just a little SControl glow-up function. Let's get into it. ✨

---

🌸 NAME 🌸

sata_link_scr_lpm — manipulate the SControl IPM and SPM fields 💫

---

🦋 SYNOPSIS 🦋

int sata_link_scr_lpm (struct ata_link *link , enum ata_lpm_policy
policy , bool spm_wakeup );

---

🎀 ARGUMENTS 🎀

• link — the ATA link whose SControl we're about to manipulate, bestie. That's the main character here.
• policy — the LPM policy we're configuring. It's giving "set the vibe" energy.
• spm_wakeup — initiate the LPM transition to the active state. Wakey wakey. ⏰

---

💖 DESCRIPTION 💖

So what this does is manipulate the IPM field of the SControl register of link according to policy. Simple, clean, iconic.

And if policy is ATA_LPM_MAX_POWER and spm_wakeup is true, then the SPM field gets manipulated to wake up the link. No cap, that's the whole trick.

Also, before returning, this function clears PHYRDY_CHG. Yes, she cleans up after herself. 💅

LOCKING: EH context. That's the rule, don't @ me. 🔒

---

⭐ RETURN ⭐

0 on success, -errno otherwise. That's it, that's the whole return section. 🫶

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/ata/libata-sata.c, plus the whole friend group:

• sata_scr_valid(9)
• sata_scr_read(9)
• sata_scr_write(9)
• sata_scr_write_flush(9)
• ata_tf_to_fis(9)
• ata_tf_from_fis(9)
• sata_link_debounce(9)
• sata_link_resume(9)
• sata_set_spd_needed(9)
• sata_set_spd(9)
• sata_down_spd_limit(9)
• sata_link_hardreset(9)
• sata_std_hardreset(9)
• ata_qc_complete_multiple(9)
• ata_slave_link_init(9)
• sata_lpm_ignore_phy_events(9)
• ata_ncq_prio_supported(9)
• ata_ncq_prio_enabled(9)
• ata_ncq_prio_enable(9)
• ata_change_queue_depth(9)
• ata_scsi_change_queue_depth(9)
• ata_sas_sdev_configure(9)
• ata_sas_queuecmd(9)
• sata_async_notification(9)
• ata_eh_read_log_10h(9)
• ata_eh_get_ncq_success_sense(9)
• ata_eh_analyze_ncq_error(9)

---

Okay that's the page!! Straight from ./drivers/ata, dated October 2026 — so future-core of it, honestly. Go manipulate those SControl fields, bestie, you're literally gonna slay it. 🧚💜🔥