msi_domain_insert_msi_desc(9)

🌸 NAME 🌸

okay so bestie, welcome to msi_domain_insert_msi_desc(9) from the Kernel API Manual — this is literally the page for allocating and initializing a MSI descriptor and inserting it at @init_desc->msi_index. iconic little kernel moment, no cap 💅

✨ SYNOPSIS ✨

int msi_domain_insert_msi_desc (struct device *dev , unsigned int domid
, struct msi_desc *init_desc );

💅 ARGUMENTS 💅

• dev — pointer to the device for which the descriptor is allocated. main character device energy, honestly 🫶
• domid — the id of the interrupt domain to which the desriptor is added (spelling straight from the page, bestie 😭).
• init_desc — pointer to an MSI descriptor to initialize the new descriptor. it's giving template vibes ✨

🎀 RETURN 🎀

0 on success, or an appropriate failure code. fr fr, that's the whole return story 💖

🦋 SEE ALSO 🦋

Kernel file: ./kernel/irq/msi.c — yes bestie, that's the source file it points at.

• struct msi_device_data(9)
• struct msi_ctrl(9)
• msi_alloc_desc(9)
• msi_domain_free_msi_descs_range(9)
• msi_domain_add_simple_msi_descs(9)
• msi_setup_device_data(9)
• __msi_lock_descs(9)
• __msi_unlock_descs(9)
• msi_domain_first_desc(9)
• msi_next_desc(9)
• msi_domain_get_virq(9)
• msi_device_populate_sysfs(9)
• msi_device_destroy_sysfs(9)
• msi_domain_set_affinity(9)
• msi_create_irq_domain(9)
• msi_create_parent_irq_domain(9)
• msi_parent_init_dev_msi_info(9)
• msi_create_device_irq_domain(9)
• msi_remove_device_irq_domain(9)
• msi_match_device_irq_domain(9)
• msi_domain_alloc_irqs_range_locked(9)
• msi_domain_alloc_irqs_range(9)
• msi_domain_alloc_irqs_all_locked(9)
• msi_domain_alloc_irq_at(9)
• msi_device_domain_alloc_wired(9)
• msi_domain_free_irqs_range_locked(9)
• msi_domain_free_irqs_range(9)
• msi_domain_free_irqs_all_locked(9)
• msi_domain_free_irqs_all(9)
• msi_device_domain_free_wired(9)
• msi_get_domain_info(9)
• msi_device_has_isolated_msi(9)

muah 💋 — source/version ./kernel/irq, date October 2026, and the page is msi_domain_insert_msi_desc(9). that's the footer, bestie, and we ate 🫶✨