ata_dev_acpi_handle(9)

🦋 NAME 🦋

ok so this is ata_dev_acpi_handle from the Kernel API Manual — and what it does is literally provide the acpi_handle for an ata_device. that's the whole vibe 💅

---

✨ SYNOPSIS ✨

acpi_handle ata_dev_acpi_handle (struct ata_device *dev );

(no cap, that space before the ); is in the original and we're keeping it, we don't touch the code 🫶)

---

🎀 ARGUMENTS 🎀

• dev — bestie, the acpi_handle that gets returned is gonna correspond to this device. that's it, that's the input 🌸

---

💖 DESCRIPTION 💖

So the way this works: it returns the acpi_handle for the ACPI namespace object that corresponds to the ata_device you passed into the function. iconic behavior honestly.

but listen — it returns NULL if no such object exists, OR if ACPI is disabled for this device due to consecutive errors 😭 so like, don't be surprised if you get a NULL back, it's not being shady, it's just the rules fr fr.

⚠️ both NULL cases are legit outcomes, not bugs: no corresponding ACPI namespace object, or ACPI disabled for the device because of consecutive errors. know the difference bestie 💀

---

🌈 SEE ALSO 🌈

the kernel file is ./drivers/ata/libata-acpi.c and here's the whole friend group, all of them, every single one 👑

• ata_acpi_handle_hotplug(9)
• ata_acpi_dev_manage_restart(9)
• ata_acpi_port_power_on(9)
• ata_acpi_dissociate(9)
• ata_acpi_gtm(9)
• ata_acpi_stm(9)
• ata_dev_get_GTF(9)
• ata_acpi_gtm_xfermask(9)
• ata_acpi_cbl_pata_type(9)
• ata_acpi_run_tf(9)
• ata_acpi_exec_tfs(9)
• ata_acpi_push_id(9)
• ata_acpi_on_resume(9)
• ata_acpi_set_state(9)
• ata_acpi_on_devcfg(9)
• ata_acpi_on_disable(9)

---

and that's the page!! 🦋💜 this little icon lives in ./drivers/ata, it's dated October 2026, and it's literally titled ata_dev_acpi_handle(9) — mwah, periodt 🎀✨