ata_host_alloc(9)

📦 version 7.3.1, in nixpkgs unstable

💖 ata_host_alloc(9) — like, the Kernel API Manual page you didn't know you needed 💖

okay bestie, gather round, because today we're talking about ata_host_alloc from the Kernel API Manual, and honestly? it's giving "small function, big responsibilities." 🎀

✨ NAME ✨

ata_host_alloc — allocate and init basic ATA host resources 🦋

✨ SYNOPSIS ✨

struct ata_host * ata_host_alloc (struct device *dev , int n_ports );

✨ ARGUMENTS ✨

  • dev — the generic device this host is associated with 🫶 (like, the device's main character link)
  • n_ports — the number of ATA ports associated with this host, periodt 💅

✨ DESCRIPTION ✨

So what does it do? It allocates and initializes basic ATA host resources. That's the whole vibe. ✨

The LLD calls this function to allocate a host, initializes it fully, and then attaches it using ata_host_register. No cap — that's the flow: alloc here, init it all the way, then register it. 🔥

🔒 LOCKING — read this part bestie 🔒

LOCKING: inherited from the calling layer. And yes, it may sleep 😴 — so don't go calling it from anywhere spicy, iykyk.

✨ RETURN ✨

Allocates the ATA host on success 💖 — returns NULL on failure 😭.

🌈 SEE ALSO 🌈

Kernel file ./drivers/ata/libata-core.c — and like, the whole extended friend group of ATA functions, all (9) manpages, all iconic 👑:

🌸 that's the whole page, bestie — go read it, go call ata_host_alloc, go slay 💅✨

sign-off time! this little gem lives under ./drivers/ata, and it's dated October 2026 🗓️💜 — so like, future-coded but timeless. mwah! 🫶🎀

📦 where this page comes from