msi_domain_first_desc(9)

📦 version 7.3.1, in nixpkgs unstable

✨ msi_domain_first_desc ✨

okay so bestie, welcome to the msi_domain_first_desc(9) glow-up — it's a Kernel API Manual page and it's literally about grabbing the first MSI descriptor of an irqdomain that's associated to a device. one descriptor. first one. main character energy only 💅

💖 NAME 💖

msi_domain_first_desc — get the first MSI descriptor of an irqdomain associated to a device 🎀

🌸 SYNOPSIS 🌸

struct msi_desc * msi_domain_first_desc (struct device *dev , unsigned
int domid , enum msi_desc_filter filter );

like, that's the whole signature, no cap 🫶

🦋 ARGUMENTS 🦋

  • dev — the device we're operating on, bestie. that's the one 🎯
  • domid — the id of the interrupt domain that should be walked. yes, walked. we're strolling through it 🚶‍♀️
  • filter — the descriptor state filter. it filters. iconic behaviour ✨

💜 DESCRIPTION 💜

okay so this is the important one and I need you to listen 😭

Must be called with the MSI descriptor mutex held, i.e. msi_lock_descs must be invoked before the call.

like, msi_lock_descs before the call. not after. not "eh, it'll probably be fine". before. 🔒 no cap, this is not optional and honestly the kernel will not be cute about it 💀

🔥 RETURN 🔥

returns a pointer to the first MSI descriptor matching the search criteria 💫

and if there's literally nothing that matches? NULL. none found. empty. the void. it's giving "nobody's home" 🙈

🌈 SEE ALSO 🌈

like, that's a whole friend group and they all showed up 🫶👑

aaaand that's the page!! this one lives in the kernel tree at ./kernel/irq and it's stamped October 2026 — so yeah, she's from the future, we stan a forward-thinking queen 👑💜✨ periodt.

📦 where this page comes from