ata_dev_get_GTF(9)

💅 ata_dev_get_GTF (kernel API manual, bestie edition)

okay so this is ata_dev_get_GTF(9) from the Kernel API Manual — it lives in ./drivers/ata and it's dated October 2026, and yes I'm gonna tell you all about it 🎀

---

✨ NAME ✨

ata_dev_get_GTF — get the drive bootup default taskfile settings 🌸

---

🦋 SYNOPSIS 🦋

int ata_dev_get_GTF (struct ata_device *dev , struct ata_acpi_gtf **gtf );

like, that's the whole signature, no cap 💅

---

🎀 ARGUMENTS 🎀

• dev — the target ATA device, aka the drive we're doing all this for 🫶
• gtf — output parameter for the buffer that's gonna hold the _GTF taskfile arrays; you pass in the address, it hands you back the goods ✨

---

💖 DESCRIPTION 💖

So this one applies to both PATA and SATA drives — equal opportunity icon behavior, we love to see it 🌈

The _GTF method has no input parameters, periodt. What it does return is a variable number of register set values (registers hex 1F1..1F7, taskfiles). And here's the thing — that <variable number>? Not known in advance, bestie 😭 so the move is: have ACPI-CA allocate the buffer as needed and return it, then free it later. That's the whole vibe.

LOCKING: EH context. that's it, that's the note 🔥

---

⭐ RETURN ⭐

• Number of taskfiles on success 👑
• 0 if _GTF doesn't exist
• -EINVAL if _GTF is invalid 💀

---

💜 SEE ALSO 💜

Kernel file ./drivers/ata/libata-acpi.c plus literally the whole friend group:

• ata_dev_acpi_handle(9)
• 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_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!! source/version vibes: ./drivers/ata, October 2026, page ata_dev_get_GTF(9) — mwah, go read the kernel, ily 🧚💖