dev_pm_domain_attach_list(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dev_pm_domain_attach_list(9) — Kernel API Manual 🎀

okay so bestie, this is a page from the Kernel API Manual and it's about gluing a device to all its PM domains at once. no cap, it's lowkey iconic.

✨ NAME ✨

dev_pm_domain_attach_list — associate a device with its PM domains.

like, all of them. at once. main character energy fr.

🌸 SYNOPSIS 🌸

int dev_pm_domain_attach_list (struct device *dev , const struct
dev_pm_domain_attach_data *data , struct dev_pm_domain_list **list );

🦋 ARGUMENTS 🦋

  • dev — the device we're using to look up the PM domains for. it's the one getting attached, basically the it-girl of this whole operation 💅
  • data — the data used for attaching to the PM domains. this is where you tell the function what you want.
  • list — an out-parameter holding an allocated list of the attached PM domains. yes it's a **, yes it's giving pointer-to-pointer, that's just how it is 🫶

👑 DESCRIPTION 👑

so here's the vibe: this function helps you attach a device to its multiple PM domains. the caller — usually a driver's probe function — can hand over a list of names for the PM domains that we should try to attach the device to.

but plot twist 🎬 — the caller can also pass an empty list, and in that case the attach gets done for all of the available PM domains. slay.

⚠️ callers must ensure proper synchronization of this function with power management callbacks. no skipping this one, bestie, it's literally in the spec.

it returns the number of attached PM domains, or a negative error code if something goes wrong 😭.

and heads up — to detach the list of PM domains, the driver shall call dev_pm_domain_detach_list, typically during the remove phase. don't leave them attached, that's messy 💀

🔥 SEE ALSO 🔥

kernel file ./drivers/base/power/common.c, plus these certified bangers:

and that's the page, bestie!! 🧚‍♀️ source lives in ./drivers/base/power, dated October 2026, and the page is dev_pm_domain_attach_list(9). go forth and attach responsibly 💖✨🍓

📦 where this page comes from