ata_link_next(9)

📦 version 7.3.1, in nixpkgs unstable

okay so bestie, welcome to the Kernel API Manual 🌸 this little page is all about ata_link_next(9), and honestly? it's the friend who introduces you to all the other links at the party 🎀

✨ NAME ✨

ata_link_next — link iteration helper 🦋

like, it's the go-find-the-next-one function. no cap, that's its whole job 💖

🌈 SYNOPSIS 🌈

struct ata_link * ata_link_next (struct ata_link *link , struct ata_port
*ap , enum ata_link_iter_mode mode );

(no #include gossip on this page, just the signature, and yes you're gonna pass it three things 🫶)

💜 ARGUMENTS 💜

  • link — the previous link, or NULL to start 🌱 literally: hand it NULL and it knows you're at the beginning, bestie.
  • ap — the ATA port containing links to iterate 🔥 this is the venue, the links are the guests.
  • mode — iteration mode, one of ATA_LITER_* 👑 (it's a family of values, pick your vibe)

🦋 DESCRIPTION 🦋

LOCKING: host lock or EH context. 🔒

okay and that locking note is not a suggestion, it's the whole mood — host lock or EH context, that's where you live while you're calling this. main character energy but only inside the right lock 💅

⭐ RETURN ⭐

Pointer to the next link. 🎯 that's it, that's the tea. (pointer. next link. slay.)

🧚 SEE ALSO 🧚

the entire extended friend group, in kernel file ./drivers/ata/libata-core.c — every single one, no skips, we don't do that here 💖

okay and that's the whole page!! 🍓 this one came out of the ./drivers/ata directory, dated October 2026 — mwah, kisses, go iterate some links responsibly, ily 💜🎀

📦 where this page comes from