irq_domain_...ct_hierarchy(9)

📦 version 7.3.1, in nixpkgs unstable

🎀 irq_domain_disconnect_hierarchy(9) 🎀

okay bestie, welcome to the Kernel API Manual 💅 this one's a lil deep-cut from ./kernel/irq/irqdomain.c and honestly it's giving "surgical vibes only" — let's get into it ✨

✨ NAME ✨

irq_domain_disconnect_hierarchy — marks the first unused level of a hierarchy as, like, not it 🫶

✨ SYNOPSIS ✨

int irq_domain_disconnect_hierarchy (struct irq_domain *domain ,
unsigned int virq );

🌸 ARGUMENTS 🌸

  • domain — the IRQ domain whose hierarchy is getting disconnected, bestie. this is the one we're trimming ✂️
  • virq — the IRQ number where the hierarchy is gonna be trimmed. yes, that virq 💅

💖 DESCRIPTION 💖

so what it does is mark the virq level that belongs to domain as disconnected. like officially, on the record, no takebacks 📝

and here's the mood killer: it returns -EINVAL if virq doesn't have a valid irq_data pointing to domain. so if your pointers aren't pointing, it's gonna tell you 😭

the only use for this is being able to trim levels of a hierarchy that don't have any real meaning for this interrupt — the kinda levels the driver itself marks as such from its .alloc callback. so yeah, driver said "this level is fake, cut it", and this function is the scissors 🧚‍♀️

👑 SEE ALSO 👑

the whole friend group lives in the kernel file ./kernel/irq/irqdomain.c 🦋 so go say hi to:

ngl, this one's niche but iconic — trimming dead hierarchy levels is main character energy if i've ever seen it 🔥 just don't go expecting it to fix a bad irq_data, it will simply return -EINVAL and leave you on read 💀

okay that's the whole page, mwah 💋 this came out of ./kernel/irq and it's dated October 2026 — so, like, future-core of you to be reading it fr fr 🌈⭐💜

📦 where this page comes from