of_irq_parse_one(9)

📦 version 7.3.1, in nixpkgs unstable

💅 of_irq_parse_one(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ — yeah, that's the manual we're in, and no, it's not the sexy one, but it is the one that makes interrupts work, so it's kinda main character energy by default. let's get into it 🫶

✨ NAME ✨

of_irq_parse_one — literally resolves an interrupt for a device 🔥

like, that's the whole job. that's it. that's the vibe check. 💅

🌸 SYNOPSIS 🌸

int of_irq_parse_one (struct device_node *device , int index , struct
of_phandle_args *out_irq );

okay so she takes three things and gives you back an int, periodt. 💖

🎀 ARGUMENTS 🎀

  • device — the device whose interrupt is to be resolved 🧚 super self-explanatory, she's the one we're getting the interrupt for.
  • index — index of the interrupt to resolve 🔢 yes bestie, there can be more than one, so you gotta say which one. no skipping digits here.
  • out_irq — structure of_phandle_args filled by this function 🍓 this bad boy gets filled in by the function, so she's an out-param. she goes in empty-ish and comes out iconic.

🦋 DESCRIPTION 🦋

so the way this works is genuinely so satisfying: this function resolves an interrupt for a node by walking the interrupt tree, finding which interrupt controller node it is attached to, and returning the interrupt specifier that can be used to retrieve a Linux IRQ number. ✨

like she literally climbs the tree 💅 finding the controller, grabbing the specifier, handing it to you like "here bestie, this is what you need to get your Linux IRQ number." iykyk. 🌈

💀 NOTE 💀

⚠️ refcount of node out_irq->np is increased by 1 on success. ⚠️

not me reminding you again: that's +1 on success, so you better be dropping that reference later or you're gonna have a bad time. no cap, this is the part people forget. 😭🫶

👑 SEE ALSO 👑

the whole friend group, fr fr 💜:

like, the entire squad showed up. we love a supportive friend group. 🌸💅

⭐ cute lil sign-off ⭐

this page comes to you straight from ./drivers/of 📁, dated October 2026 📅, and it's all about of_irq_parse_one(9) — go forth and resolve those interrupts, bestie. 💖🏆 you got this. mwah. 🎀

📦 where this page comes from