platform_get_irq_optional(9)

📦 version 7.3.1, in nixpkgs unstable

👑 platform_get_irq_optional(9) — the Kernel API Manual, bestie edition 🎀

okay so you're in the kernel API manual, section 9, and the star of the show is platform_get_irq_optional. buckle up, this one's a softie 💖

✨ NAME ✨

platform_get_irq_optional — grab an optional interrupt for a device, no drama, no yelling 🔔

🦋 SYNOPSIS 🦋

int platform_get_irq_optional (struct platform_device *dev , unsigned
int num );

yes that's the whole signature, she's short and she knows it 💅

🌸 ARGUMENTS 🌸

  • dev — the platform device in question. the main character, if you will 👑
  • num — the interrupt number index. like, which irq, bestie 🔢

💜 DESCRIPTION 💜

so this function gets an interrupt for a platform device. that's it, that's the vibe 🫶

but listen — device drivers should check the return value for errors so as to not pass a negative integer value to the request_irq APIs. like, please do the vibe check on your return value, i'm begging 😭

this is the same as platform_get_irq, except that it does not print an error message if an interrupt can not be obtained. she's quiet about it. graceful. unbothered. no cap 🤫

for example:

int irq = platform_get_irq_optional(pdev, 0);
if (irq < 0)
        return irq;

see how we check? that's the whole point. look at us being responsible ✨

🔥 RETURN 🔥

  • non-zero interrupt number on success 🎉
  • negative error number on failure 💀

that's literally it. she either slays or she hands you a negative number and you deal with it 🙈

🌈 SEE ALSO 🌈

kernel file ./drivers/base/platform.c, plus the whole friend group:

like, go read them, they're all icons too 💖

mwah 💋 — this page lives in ./drivers/base, it's dated October 2026, and it's filed under platform_get_irq_optional(9). that's the whole manual page, periodt. go get that irq, bestie 🧚💜

📦 where this page comes from