sata_scr_read(9)

💅 sata_scr_read(9) — like, the Kernel API Manual bestie ✨

okay so this is a page from the Kernel API Manual, and it's all about sata_scr_read — a little function that goes and grabs an SCR register for you. tiny function, big main character energy 🫶

---

🌸 NAME 🌸

sata_scr_read — read SCR register of the specified port

✨ SYNOPSIS ✨

int sata_scr_read (struct ata_link *link , int reg , u32 *val );

🎀 ARGUMENTS 🎀

• link — the ATA link you wanna read the SCR for, bestie 🦋
• reg — which SCR you're reading (yes, you gotta pick one)
• val — the place where the read value gets stored 💾

💖 DESCRIPTION 💖

So what it does is: it reads the SCR register reg of link and drops it into *val. that's the whole vibe ✨

And like, here's the tea — this function is guaranteed to succeed if all of these are true at the same time:

• link is ap->link
• the cable type of the port is SATA
• the port implements ->scr_read

all three or it's not a promise, periodt 💅

LOCKING: None if link is ap->link. Kernel thread context otherwise. 🔒

🔥 RETURN 🔥

0 on success, negative errno on failure. that's it, that's the return 😭

ngl a negative errno is never a slay, but at least you know where you stand 💀

👑 SEE ALSO 👑

Kernel file ./drivers/ata/libata-sata.c plus this whole friend group right here:

• sata_scr_valid(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_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)

---

and that's the whole page, no cap 🧚 this little masterpiece lives in the source tree at ./drivers/ata and it's dated October 2026 — so yeah, future vibes only 💜 bye bestie, go read some registers 🦋