regulator_irq_helper(9)

💜 regulator_irq_helper(9) — like, the actual manual page, bestie

okay so this is a page from the Kernel API Manual, and it's about regulator_irq_helper — the function that registers your IRQ based regulator event/error notifier. yes it's a lot of words. no I'm not scared of it. let's go 🫶

---

✨ NAME ✨

regulator_irq_helper — register IRQ based regulator event/error notifier

like, it hooks your regulator errors up to an IRQ so you actually hear about them. main character behavior honestly 👑

---

🌸 SYNOPSIS 🌸

void * regulator_irq_helper (struct device *dev , const struct
regulator_irq_desc *d , int irq , int irq_flags , int common_errs , int
*per_rdev_errs , struct regulator_dev **rdev , int rdev_amount );

eight arguments. EIGHT. and every single one of them matters, so don't come for me 🔥

---

🎀 ARGUMENTS 🎀

• dev — the device providing the IRQs. like, whose IRQs are these? theirs. it's giving source of truth 💅
• d — the IRQ helper descriptor. that's the const struct regulator_irq_desc * one. it's the blueprint, the vibe documentation, the plan.
• irq — the IRQ used to inform events/errors to be notified. this is the actual interrupt line doing the talking 🦋
• irq_flags — extra IRQ flags that get OR'ed with the default IRQF_ONESHOT when requesting the (threaded) irq. so you're adding to IRQF_ONESHOT, not replacing it. noted. don't mess it up 🙈
• common_errs — errors which can be flagged by this IRQ for all rdevs. when the IRQ is re-enabled these errors will be cleared from all associated regulators. and here's the little tip: use this instead of per_rdev_errs if you use regulator_irq_map_event_simple for event mapping. iykyk 💖
• per_rdev_errs — optional error flag array describing errors specific for only some of the regulators. these errors will be or'ed with common errors. if this is given, the array should contain rdev_amount flags. can be set to NULL if there is no regulator specific error flags for this IRQ. optional means optional, bestie 🌈
• rdev — array of pointers to regulators associated with this IRQ. struct regulator_dev ** — yes, double pointer. yes, that's on purpose 💀
• rdev_amount — amount of regulators associated with this IRQ. and remember, this number doubles as the required size of per_rdev_errs. consistency queen 🎀

---

⭐ RETURN ⭐

handle to irq_helper or an ERR_PTR encoded negative error number.

so like... check it. please check it. an ERR_PTR encoded negative error number is not a handle and it will not slay for you 😭

---

🦋 SEE ALSO 🦋

• Kernel file ./drivers/regulator/irq_helpers.c — go read it, the source is right there, it's literally free 👑
• regulator_irq_helper_cancel(9)
• regulator_irq_map_event_simple(9)

---

real talk: this page lives in ./drivers/regulator, dated October 2026. that's the footer, that's the vibe, no cap 💜

periodt. now go register that notifier ✨🧚