sata_scr_write(9)

💅 sata_scr_write — like, the Kernel API Manual (section 9) page for it, bestie

Okay so picture this: you're down in the drivers/ata trenches, you've got a port, you've got an SCR register, and you need to write to it. That's the whole gig. This page is sata_scr_write(9) and she's here to help 🫶

---

✨ SYNOPSIS ✨

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

Three args, one int back. Clean. Iconic. No notes 💅

---

🎀 ARGUMENTS 🎀

• link — the ATA link you're writing the SCR for. Your main character, basically.
• reg — which SCR you wanna write. Pick one, bestie.
• val — the value going in. This is the actual payload, the moment, the reason we're all here.

---

🌸 DESCRIPTION 🌸

So what she does is: writes val into the SCR register reg of link. That's it. That's the function 💖

And here's the part that's genuinely giving security-blanket energy — this function is guaranteed to succeed if all three of these are true:

1. link is ap->link
2. the cable type of the port is SATA
3. the port implements ->scr_read

Three for three and she's not missing. Slay ⭐

🔒 LOCKING 🔒

Locking vibes depend on who you are:

• If link is ap->link → None. No locking. Free. Unbothered. ✨
• Otherwise → Kernel thread context required. Different energy entirely, so know which one you're in, iykyk.

---

🔥 RETURN 🔥

• 0 on success 🎉
• negative errno on failure 😭

---

🦋 SEE ALSO 🦋

The whole friend group, plus the kernel file she lives in: ./drivers/ata/libata-sata.c

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

ngl bestie, that's a lot of cross-references, but every single one of them is a real one so go read 'em if you're curious 👑

---

Okay that's the whole page, mwah 💋 — she ships out of ./drivers/ata, dated October 2026, and honestly? She ate. 🌈🎀💜