ahci_platform_enable_phys(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ahci_platform_enable_phys(9) — a Kernel API Manual moment

okay bestie, so this one lives in the Kernel API Manual and it's literally called ahci_platform_enable_phys — section 9, iykyk. It's giving "wake up, the PHYs are sleeping" energy and honestly? iconic. Let's get into it 🦋

✨ NAME ✨

ahci_platform_enable_phys — Enable PHYs 🎀

That's it. That's the whole name. Short, sweet, slays.

🫶 SYNOPSIS 🫶

int ahci_platform_enable_phys (struct ahci_host_priv *hpriv );

Copy it exactly, don't @ me. 💖

🌸 ARGUMENTS 🌸

  • hpriv — the host private area, and it's where the config values get stored. Think of it as your little aesthetic storage pouch for this whole operation. It's the main character here, no cap. 👑

🔥 DESCRIPTION 🔥

So here's the tea, bestie: this function enables all the PHYs it finds chillin' in hpriv->phys — if any. Like, if there are none, cool, no drama, nothing to do. 🙈

But the way that it handles failure? Honestly obsessed. If a PHY fails to be enabled, it goes back and disables all the PHYs that were already enabled, and it does it in reverse order — undoing everything in the exact opposite sequence of how it went down. Then it returns an error. Cleanup queen behavior, fr fr. 🧹✨

⭐ RETURN ⭐

  • 0 on success 🎉
  • otherwise a negative error code 💀

That's the whole vibe check: zero means we ate, negative means something went sideways.

🎀 SEE ALSO 🎀

First up, the kernel file itself, in case you wanna go read the source like the scholar you are:

  • Kernel file ./drivers/ata/libahci_platform.c

And the whole friend group of related functions, all here, all accounted for, don't skip any of them:

ngl bestie, bookmark these. The enable/disable pairs are giving matched set. 🌈

okay that's the whole page, mwah 💋 — it shipped from ./drivers/ata in October 2026, and this little manual page is literally titled ahci_platform_enable_phys(9) just so you never forget her name. bye bestie, go enable some PHYs responsibly 🧚💜🍓

📦 where this page comes from