ahci_platform_get_resources(9)

📦 version 7.3.1, in nixpkgs unstable

👑 ahci_platform_get_resources(9) 💅

okay so this is a page straight out of the Kernel API Manual, bestie, and it's about grabbing up all the platform resources an AHCI host is gonna need. it's giving "setup era" and honestly? iconic.

✨ NAME ✨

ahci_platform_get_resources — Get platform resources 🎀

🌸 SYNOPSIS 🌸

struct ahci_host_priv * ahci_platform_get_resources (struct
platform_device *pdev , unsigned int flags );

like literally that's the whole signature, no cap 🫶

🦋 ARGUMENTS 🦋

  • pdev — the platform device you're getting resources for. it's the main character here, we're doing this all for them 💖
  • flags — a bitmap representing the resource(s) to get. bitmask vibes ✨

💜 DESCRIPTION 💜

so what this function does is: it allocates an ahci_host_priv struct, and then it goes and gets the following resources, storing a reference to each one inside that returned struct. it's like packing a little resource lunchbox 🍓

  1. mmio registers (IORESOURCE_MEM 0, mandatory) — non-negotiable, this one is not optional bestie, it's required periodt.
  2. regulator for controlling the targets power (optional) and a regulator for controlling the AHCI controller (optional) — two regulators, both optional, both living their best life 🌈
  3. all clocks specified in the devicetree node, or a single clock for non-OF platforms (optional) — so it's either the whole clock squad or just the one, depending on whether you're OF or not 🧚
  4. resets, if flags has AHCI_PLATFORM_GET_RESETS (optional) — and only if that flag is set, iykyk 👀
  5. phys (optional) — last but not least, also optional 💫
ngl the "optional" tag is doing a lot of heavy lifting on this page and we respect it 🙈

🔥 RETURN 🔥

The allocated ahci_host_priv on success — slay 💅 — otherwise an ERR_PTR value. so always check, bestie, fr fr 😭

🎀 SEE ALSO 🎀

Kernel file ./drivers/ata/libahci_platform.c — that's the source of truth, go read it 🌟

then the whole friend group, in order:

and that's the whole page!! 🫶 shoutout to the ./drivers/ata source and the October 2026 date stamp — this one was served fresh 💖✨ go get those resources, queen 👑

📦 where this page comes from