ata_eh_analyze_ncq_error(9)

💅 ata_eh_analyze_ncq_error(9) — from the Kernel API Manual, bestie 🎀

okay so before we even start: this is a kernel API manpage, the manual name is literally ata_eh_analyze_ncq_error(9), and yes it's a function, not a command — we're in kernel-land now, bestie, act accordingly ✨

---

✨ NAME ✨

ata_eh_analyze_ncq_error — analyze NCQ error

like... it analyzes NCQ errors. that's the whole vibe. short king of a NAME section 👑

---

🌸 SYNOPSIS 🌸

void ata_eh_analyze_ncq_error (struct ata_link *link );

returns void, takes one pointer, no cap 💜

---

🦋 ARGUMENTS 🦋

• link — the ATA link you want to analyze the NCQ error for. that's the one. that's the whole argument list. it's giving minimalism 🫶

---

💖 DESCRIPTION 💖

okay so here's the tea ☕ — this function reads log page 10h, figures out which qc is the offending one (rude of it tbh), and acquires the error status TF. the way that it just handles all of that for you is honestly iconic 💅

and here's the part that makes LLDD authors sob with relief 😭 — for NCQ device errors, all LLDDs have to do is set AC_ERR_DEV in ehi->err_mask. that's it. that's the whole job. this function takes care of the rest. main character energy fr fr 👑

LOCKING: Kernel thread context (may sleep). so like, it can sleep, meaning don't you dare call it from somewhere sleepy is illegal 🙈

---

🌈 SEE ALSO 🌈

this list is LONG and we are NOT skipping a single one, periodt ⭐ — all of these live in the kernel file ./drivers/ata/libata-sata.c:

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

iykyk 🧚

---

and that's the page!! 💖 cute lil sign-off: this one comes from ./drivers/ata and it's dated October 2026, slay 🌸✨🦋