sata_set_spd_needed(9)

💅 sata_set_spd_needed(9) — the kernel API manual, but make it make sense

okay so bestie, welcome to sata_set_spd_needed(9) 💖 this is one of those little libata helper functions that lives in ./drivers/ata/libata-sata.c, and honestly? she's a vibe check for your SATA link speed config. let's get into it ✨

---

✨ NAME ✨

sata_set_spd_needed — literally just answers "is SATA spd configuration needed" 🎀

---

🦋 SYNOPSIS 🦋

int sata_set_spd_needed (struct ata_link *link );

---

🌸 ARGUMENTS 🌸

• link — the link in question 🫶 like, the actual struct ata_link you're curious about. main character energy, honestly.

---

🔥 DESCRIPTION 🔥

so what she does 👑 : she tests whether the spd limit sitting in SControl matches link->sata_spd_limit. that's the whole flex.

and why do we care?? because this function is used to determine whether hardreset is necessary to apply SATA spd configuration 💀 like yeah, no cap, sometimes you gotta hardreset the link just to make the new speed setting actually stick. she's the one who tells you if that's the situation.

LOCKING: inherited from caller 😭 she does not take her own locks, bestie — that's your job. you brought the locks, you hold the locks, iykyk 🔒

---

⭐ RETURN ⭐

• 1 — yep, SATA spd configuration is needed 🔥
• 0 — nope, you're good, no config needed 🌈

like, it's giving boolean. that's it. that's the whole return value 🙈

---

🧚 SEE ALSO 🧚

the kernel file ./drivers/ata/libata-sata.c says hi, and so do all her friends 💜:

• 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_link_scr_lpm(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)

go read sata_set_spd(9) next if you actually wanna set the thing — this page only tells you whether you need to 🎀

---

and that's the whole page, bestie, we ate and left no crumbs 💅 this little drop came out of ./drivers/ata back in October 2026, and it's still out here doing sata_set_spd_needed(9) things. periodt. 🌟