pci_request_irq(9)

📦 version 7.3.1, in nixpkgs unstable

💅 pci_request_irq(9) — the Kernel API Manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual and it's about pci_request_irq, and honestly? it's giving "let me get you an interrupt line, queen." let's go ✨

🌸 NAME 🌸

pci_request_irq — allocate an interrupt line for a PCI device

like, you're literally reserving a hotline for your PCI device to call you on. iconic behavior 💖

✨ SYNOPSIS ✨

int pci_request_irq (struct pci_dev *dev , unsigned int nr ,
       irq_handler_t handler , irq_handler_t thread_fn , void *dev_id , const
       char *fmt , ... );

no cap, that's the whole vibe right there 👑

🦋 ARGUMENTS 🦋

  • dev — the PCI device you're operating on. your main character 🫶
  • nr — device-relative interrupt vector index, and it's 0-based (so the first one is 0, not 1, do not come for me on this).
  • handler — the function that gets called when the IRQ happens. also: it's the primary handler for threaded interrupts. and listen 👀 if you pass NULL here and thread_fn != NULL, then the default primary handler gets installed for you. slay, the kernel's got you.
  • thread_fn — the function called from the IRQ handler thread. if it's NULL, no IRQ thread is created. periodt.
  • dev_id — the cookie that gets passed back to the handler function 🍪 (yes, real field name, no I'm not kidding)
  • fmt — a printf-like format string that names the handler. cute little name tag energy 🎀
  • ... — variable arguments, the usual suspects 💫

💜 DESCRIPTION 💜

so this call is out here allocating interrupt resources and enabling the interrupt line and IRQ handling. and lowkey the important bit: ⚠️ from the exact moment you make this call, handler and thread_fn may be invoked. so like... be ready. no take-backs. 😭

also all interrupts requested using this function might be shared — sharing is caring, iykyk 🤝

and the big one:

dev_id must not be NULL and must be globally unique. fr fr. non-negotiable. globally. unique. 💀

🌈 SEE ALSO 🌈

go read those next, bestie, the lore is deep 🧚‍♀️

and that's the whole page! 🎉 this little gem lives in ./drivers/pci, dated October 2026, and it's filed under pci_request_irq(9). mwah 💋 go request some IRQs responsibly, ily, bye! 🍓💖✨

📦 where this page comes from