irq_domain_create_hierarchy(9)

🌸 irq_domain_create_hierarchy (9) — Kernel API Manual 🌸

okay bestie, so this is a page from the Kernel API Manual, section 9, and it's literally all about adopting a brand-new irq domain into the family tree 🧚✨

---

✨ NAME ✨

irq_domain_create_hierarchy — add an irqdomain into the hierarchy 💅 (yes, that's the whole vibe: hierarchy enrollment, no cap)

---

🦋 SYNOPSIS 🦋

struct irq_domain * irq_domain_create_hierarchy (struct irq_domain
*parent , unsigned int flags , unsigned int size , struct fwnode_handle
*fwnode , const struct irq_domain_ops *ops , void *host_data );

that's the whole function signature, character for character, don't come for me 🫶

---

🎀 ARGUMENTS 🎀

• parent — the parent irq domain you're associating with the new domain. basically the new domain's chosen family 👑
• flags — the irq domain flags associated to the domain. little labels it wears 🏷️
• size — size of the domain. see below, i promise i'm getting to it ⬇️
• fwnode — optional fwnode of the interrupt controller. optional!! very chill of it 🙈
• ops — pointer to the interrupt domain callbacks. the domain's whole personality, lowkey 💫
• host_data — controller private data pointer. its little secret stash 🍓

---

💜 DESCRIPTION 💜

so here's the tea: if size is 0, a tree domain is created. otherwise — any other size — it's a linear domain. that's it, that's the branch ✨

and if it's successful, the parent gets associated to the new domain and the domain flags are set. slay, the whole family's official now 🔥

---

⭐ RETURN ⭐

a pointer to the IRQ domain 🫶 … or NULL on failure 😭 (if you get NULL, bestie, it did not eat, check your args)

---

🌈 SEE ALSO 🌈

• Kernel file ./include/linux/irqdomain.h
• struct irq_fwspec(9)
• struct irq_fwspec_info(9)
• struct irq_domain_ops(9)
• struct irq_domain(9)
• struct irq_domain_info(9)
• irq_domain_create_linear(9)
• irq_create_mapping(9)
• irq_resolve_mapping(9)
• irq_find_mapping(9)
• irq_domain_alloc_irqs(9)

like, go read all of them, iykyk 📚💖

---

ok that's the page!! no cap, every flag and arg survived the glow-up 💅

and that's a wrap, bestie 🎀 this one lives in ./include/linux, dated October 2026, in the irq_domain_create_hierarchy(9) corner of the Kernel API Manual — mwah, go build something iconic 🦋✨