ata_dev_configure(9)

💅 ata_dev_configure(9) — Kernel API Manual, bestie edition

Okay so real talk, this one lives in the kernel API manual, section 9, and the whole page is literally about one function: ata_dev_configure. Yes it's a small page. Yes it's still iconic. ✨

---

🌸 NAME 🌸

ata_dev_configure — configure the specified ATA/ATAPI device. That's it. That's the whole job. 🎯

---

✨ SYNOPSIS ✨

int ata_dev_configure (struct ata_device *dev);

---

🎀 ARGUMENTS 🎀

• dev — the target device you're configuring. Like, the specific ATA/ATAPI device that's about to get its whole life together. 💖

---

🦋 DESCRIPTION 🦋

So you take dev and you configure it according to dev->id. That's the vibe. 🫶

Generic and low-level driver specific fixups are also applied on top of that — so it's not just a straight read of dev->id, there's extra cleanup and adjustment happening too. no cap, it's doing real work in there.

LOCKING: Kernel thread context (may sleep). So like… it's allowed to sleep, bestie. Don't come at it from an atomic context, that's not the move. 😴

---

🔥 RETURN 🔥

• 0 on success 🎉
• -errno otherwise 💀

That's the whole contract. Simple, clean, main character energy.

---

👑 SEE ALSO 👑

The friend group is huge. Literally the whole libata roster shows up. Here's everyone, and there is not a single one missing, I checked twice:

• ata_link_next(9)
• ata_dev_next(9)
• ata_dev_phys_link(9)
• ata_force_cbl(9)
• ata_force_pflags(9)
• ata_force_link_limits(9)
• ata_force_xfermask(9)
• ata_force_quirks(9)
• atapi_cmd_type(9)
• ata_set_rwcmd_protocol(9)
• ata_tf_read_block(9)
• ata_build_rw_tf(9)
• ata_pack_xfermask(9)
• ata_unpack_xfermask(9)
• ata_xfer_mask2mode(9)
• ata_xfer_mode2mask(9)
• ata_xfer_mode2shift(9)
• ata_mode_string(9)
• ata_dev_classify(9)
• ata_id_string(9)
• ata_id_c_string(9)
• ata_read_native_max_address(9)
• ata_set_max_sectors(9)
• ata_hpa_resize(9)
• ata_dump_id(9)
• ata_id_xfermask(9)
• ata_exec_internal(9)
• ata_pio_need_iordy(9)
• ata_pio_mask_no_iordy(9)
• ata_do_dev_read_id(9)
• ata_dev_read_id(9)
• ata_dev_power_set_standby(9)
• ata_dev_power_set_active(9)
• ata_read_log_page(9)
• ata_cable_40wire(9)
• ata_cable_80wire(9)
• ata_cable_unknown(9)
• ata_cable_ignore(9)
• ata_cable_sata(9)
• sata_print_link_status(9)
• ata_dev_pair(9)
• ata_timing_cycle2mode(9)
• ata_down_xfermask_limit(9)
• ata_set_mode(9)
• ata_wait_ready(9)
• ata_wait_after_reset(9)
• ata_std_prereset(9)
• ata_std_postreset(9)
• ata_dev_same_device(9)
• ata_dev_reread_id(9)
• ata_dev_revalidate(9)
• ata_is_40wire(9)
• cable_is_40wire(9)
• ata_dev_xfermask(9)
• ata_dev_set_xfermode(9)
• ata_dev_set_feature(9)
• ata_dev_init_params(9)
• atapi_check_dma(9)
• ata_std_qc_defer(9)
• ata_sg_init(9)
• ata_sg_clean(9)
• ata_sg_setup(9)
• swap_buf_le16(9)
• ata_qc_free(9)
• ata_qc_complete(9)
• ata_qc_get_active(9)
• ata_qc_issue(9)
• ata_phys_link_online(9)
• ata_phys_link_offline(9)
• ata_link_online(9)
• ata_link_offline(9)
• ata_host_suspend(9)
• ata_host_resume(9)
• ata_dev_init(9)
• ata_link_init(9)
• sata_link_init_spd(9)
• ata_port_alloc(9)
• ata_host_alloc(9)
• ata_host_alloc_pinfo(9)
• ata_finalize_port_ops(9)
• ata_host_start(9)
• ata_host_init(9)
• ata_host_register(9)
• ata_host_activate(9)
• ata_dev_free_resources(9)
• ata_port_detach(9)
• ata_host_detach(9)
• ata_pci_remove_one(9)
• ata_platform_remove_one(9)
• ata_msleep(9)
• ata_wait_register(9)

Also, the kernel file to go peep the actual source in is ./drivers/ata/libata-core.c — that's where the magic happens, iykyk. 📁

---

Sign-off time, bestie 🧚‍♀️ This page is stamped from the ./drivers/ata corner of the tree, and the version/date on it is October 2026. So it's a lil peek into the future, and honestly? Slay. 🩵