airq_iv_scan(9)

💅 airq_iv_scan — like, the Kernel API Manual page you didn't know you needed

okay so bestie. this is airq_iv_scan(9), straight out of the Kernel API Manual, and it's genuinely one of those tiny utility pages that slaps way harder than it looks. it scans interrupt vectors for non-zero bits. that's the whole vibe. let's get into it 🫶

---

✨ SYNOPSIS ✨

unsigned long airq_iv_scan (struct airq_iv *iv , unsigned long start ,
       unsigned long end );

like yes, that's the whole signature, no cap. three args, nothing extra, no notes needed 💅

---

🌸 ARGUMENTS 🌸

• iv — a pointer to the interrupt vector structure. this is the thing you're scanning, your main character, the whole point 💖
• start — the bit number where the search kicks off. where the story begins ✨
• end — the bit number where the search stops. closing credits, basically 🎀

---

🦋 DESCRIPTION 🦋

okay so this is the part where it gets cute: the function returns the bit number of the next non-zero interrupt bit. like, it actually finds the goods for you. slay.

and if the scan finishes without finding any more non-zero bits? it just gives you back -1UL. that's it. that's the whole deal. no drama, no exceptions, just a return value telling you "nope, nothing left in there bestie" 💀

ngl, -1UL is the "i looked, there's nothing" answer, so if you're checking the return value, remember that's the sentinel and not a bit number. 🙈

---

💜 SEE ALSO 💜

the Kernel file ./drivers/s390/cio/airq.c, plus the whole friend group:

• register_adapter_interrupt(9)
• unregister_adapter_interrupt(9)
• airq_iv_create(9)
• airq_iv_release(9)
• airq_iv_alloc(9)
• airq_iv_free(9)

they all hang out together in the same corner of the kernel, iykyk 🌈

---

💅 okay that's the page! this one came from ./drivers/s390/cio, dated October 2026, and it lives in the Kernel API Manual like the little icon it is. go scan some bits, bestie — you got this 🧚💖✨