ata_acpi_run_tf(9)

🎀 NAME 🎀

okay so bestie, this is the ata_acpi_run_tf(9) page from the Kernel API Manual, and the whole vibe is: send taskfile registers to host controller. That’s it, that’s the function. ✨💅

🦋 SYNOPSIS 🦋

int ata_acpi_run_tf (struct ata_device *dev , const struct ata_acpi_gtf
*gtf , const struct ata_acpi_gtf *prev_gtf );

🌸 ARGUMENTS 🌸

• dev — target ATA device. 🫶
• gtf — raw ATA taskfile register set (0x1f1 - 0x1f7). 🔥
• prev_gtf — previous command. 💖

✨ DESCRIPTION ✨

okay so picture this: it outputs the ATA taskfile to the standard ATA host controller. It writes the control, feature, nsect, lbal, lbam, and lbah registers. Optionally — and yes, specifically with ATA_TFLAG_LBA48 — it writes hob_feature, hob_nsect, hob_lbal, hob_lbam, and hob_lbah. Iconic register behavior, no cap. Slay. 💅

This function waits for idle (!BUSY and !DRQ) after writing registers. If the control register has a new value, this function also waits for idle after writing control and before writing the remaining registers. The way it’s giving careful sequencing. 🦋

LOCKING: EH context. No cap, periodt. 🔒

💖 RETURN 💖

• 1 — command is executed successfully. 🎉
• 0 — ignored, rejected or filtered out. 🙈
• -errno — other errors. 😭

🌈 SEE ALSO 🌈

Kernel file ./drivers/ata/libata-acpi.c — and here’s the whole bestie squad:

• 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_dev_get_GTF(9)
• ata_acpi_gtm_xfermask(9)
• ata_acpi_cbl_pata_type(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)

This page is from source/version ./drivers/ata, dated October 2026, and it’s all about ata_acpi_run_tf(9) — bye bestie, go send those registers! 💅✨