ata_sff_dev_classify(9)

💅 ata_sff_dev_classify(9) — a little love letter from the Kernel API Manual

okay so bestie. this one lives in the Kernel API Manual, it's called ata_sff_dev_classify(9), and honestly? it's giving "detective who reads the room and tells you who's who." 🕵️‍♀️✨ let's get into it.

---

✨ NAME ✨

ata_sff_dev_classify — the little function that parses the returned ATA device signature and tells you what kind of creature you're looking at 🦋

---

🎀 SYNOPSIS 🎀

unsigned int ata_sff_dev_classify (struct ata_device *dev , int present
, u8 *r_err );

---

🌸 ARGUMENTS 🌸

• dev — the ATA device you're classifying. ngl it starts at zero, so keep that in mind 🫶
• present — basically "yeah this device seems to be here." vibes = present.
• r_err — the value of the error register when it all finished. the receipts, if you will 📋

---

👑 DESCRIPTION 👑

okay so picture this: an event happens — and we mean a real one, like SRST, E.D.D., or SATA COMRESET 💥 — and after that, a whole ATA/ATAPI-defined set of values gets dropped into the ATA shadow registers. those values are literally the results of device detection and diagnostics. it's giving "the universe left clues in the registers." 🔍

so what do we do? you select the ATA device, and you read the values out of the ATA shadow registers. main character behavior only.

then you parse. parse according to the Error register value, plus the spec-defined values that ata_dev_classify examines. that's the whole vibe check, no cap. 🧚

LOCKING: caller. — yeah bestie, that's on you. you're holding the lock, not us. 🔒

---

💜 RETURN 💜

it hands you back the device type, and that's one of:

• ATA_DEV_ATA
• ATA_DEV_ATAPI
• ATA_DEV_NONE

three icons, one return value. slay. 💅

---

🌈 SEE ALSO 🌈

kernel file ./drivers/ata/libata-sff.c, plus this absolutely iconic roster:

ata_sff_check_status(9), ata_sff_altstatus(9), ata_sff_irq_status(9), ata_sff_sync(9), ata_sff_pause(9), ata_sff_dma_pause(9), ata_sff_wait_ready(9), ata_sff_set_devctl(9), ata_sff_dev_select(9), ata_dev_select(9), ata_sff_irq_on(9), ata_sff_tf_load(9), ata_sff_tf_read(9), ata_sff_exec_command(9), ata_tf_to_host(9), ata_sff_data_xfer(9), ata_sff_data_xfer32(9), ata_pio_sector(9), ata_pio_sectors(9), atapi_send_cdb(9), __atapi_pio_bytes(9), atapi_pio_bytes(9), ata_hsm_ok_in_wq(9), ata_hsm_qc_complete(9), ata_sff_hsm_move(9), ata_sff_qc_issue(9), ata_sff_qc_fill_rtf(9), ata_sff_port_intr(9), ata_sff_interrupt(9), ata_sff_lost_interrupt(9), ata_sff_freeze(9), ata_sff_thaw(9), ata_sff_prereset(9), ata_devchk(9), ata_sff_wait_after_reset(9), ata_sff_softreset(9), sata_sff_hardreset(9), ata_sff_postreset(9), ata_sff_drain_fifo(9), ata_sff_error_handler(9), ata_sff_std_ports(9), ata_pci_sff_init_host(9), ata_pci_sff_prepare_host(9), ata_pci_sff_activate_host(9), ata_pci_sff_init_one(9), ata_bmdma_fill_sg(9), ata_bmdma_fill_sg_dumb(9), ata_bmdma_qc_prep(9), ata_bmdma_dumb_qc_prep(9), ata_bmdma_qc_issue(9), ata_bmdma_port_intr(9), ata_bmdma_interrupt(9), ata_bmdma_error_handler(9), ata_bmdma_post_internal_cmd(9), ata_bmdma_irq_clear(9), ata_bmdma_setup(9), ata_bmdma_start(9), ata_bmdma_stop(9), ata_bmdma_status(9), ata_bmdma_port_start(9), ata_bmdma_port_start32(9), ata_pci_bmdma_clear_simplex(9), ata_pci_bmdma_init(9), ata_pci_bmdma_prepare_host(9), ata_pci_bmdma_init_one(9), ata_sff_port_init(9)

like. that's the whole friend group. iykyk 🫶🔥

---

and that's the page!! one last thing before you go — this cutie came out of ./drivers/ata, dated October 2026, and the page itself is ata_sff_dev_classify(9). go forth and classify, bestie 💖🎀🦋⭐