pci_msi_map_rid_ctlr_node(9)

🌸 NAME 🌸

okay so this is pci_msi_map_rid_ctlr_node(9) from the Kernel API Manual — and bestie, it’s literally the function that gets the MSI controller fwnode_handle and the MSI requester id (RID). 💅✨

✨ SYNOPSIS ✨

u32 pci_msi_map_rid_ctlr_node (struct irq_domain *domain , struct
       pci_dev *pdev , struct fwnode_handle **node );

🎀 ARGUMENTS 🎀

• domain — the interrupt domain, aka the vibe zone for interrupts 🦋
• pdev — the PCI device, the main character here 👑
• node — pointer to store the MSI controller fwnode_handle; it’s where the result goes 🎀

🦋 DESCRIPTION 🦋

So here’s the tea: use the firmware data to find the MSI controller fwnode_handle for pdev. If it’s found, map the RID and initialize node with it. 🌈

Big warning bestie: node value must be set to NULL on entry. Like, actually mandatory — no cap. 💀💅

⭐ RETURN ⭐

The RID. That’s it, that’s the return value. ✨

🔥 SEE ALSO 🔥

Kernel file ./drivers/pci/msi/irqdomain.c — plus these icons, iykyk:

• pci_msi_domain_write_msg(9)
• pci_setup_msi_device_domain(9)
• pci_setup_msix_device_domain(9)
• pci_msi_domain_supports(9)
• pci_msi_domain_get_msi_rid(9)
• pci_msi_get_device_domain(9)

okay bye bestie 🫶 — source/version is ./drivers/pci/msi, date is October 2026, and yes this iconic page is still pci_msi_map_rid_ctlr_node(9) 💖✨