wait_event_...e_locked_irq(9)

📦 version 7.3.1, in nixpkgs unstable

💤 wait_event_...e_locked_irq(9) 💤

okay so this is the manpage for wait_event_interruptible_exclusive_locked_irq, and the manual name is Kernel API Manual — folded in near the top like a little name tag, bestie 🫶 It’s giving sleep until a condition gets true, so let’s get into it 💖

✨ NAME ✨

wait_event_interruptible_exclusive_locked_irq — sleep until a condition gets true 😴✅

🌸 SYNOPSIS 🌸

wait_event_interruptible_exclusive_locked_irq (wq , condition );

🎀 ARGUMENTS 🎀

  • wq — the waitqueue to wait on. This is the queue bestie is snoozing on 🛌
  • condition — a C expression for the event to wait for. It’s the “am I awake yet?” vibe check 👀

💅 DESCRIPTION 💅

The process is put to sleep (TASK_INTERRUPTIBLE) until the condition evaluates to true or a signal is received. The condition is checked each time the waitqueue wq is woken up. Not me checking it every single time — that’s literally the assignment 🔁

It must be called with wq.lock being held. This spinlock is unlocked while sleeping but condition testing is done while lock is held and when this macro exits the lock is held. So like… the lock comes off for the nap, but the check and the exit are lock-on. Do not fumble this, fr fr 🔒😭

The lock is locked/unlocked using spin_lock_irq/spin_unlock_irq functions which must match the way they are locked/unlocked outside of this macro. Matching energy only, no cap ⚡

The process is put on the wait queue with an WQ_FLAG_EXCLUSIVE flag set thus when other process waits process on the list if this process is awaken further processes are not considered. Exclusive main character energy, periodt 👑✨

wake_up_locked has to be called after changing any variable that could change the result of the wait condition. Change the variable → call wake_up_locked, in that order, iykyk 🔔

The function will return -ERESTARTSYS if it was interrupted by a signal and 0 if condition evaluated to true. Those are the two outcomes, bestie 💖

🌈 SEE ALSO 🌈

Kernel file ./include/linux/wait.h is in the mix, and the whole reference squad is:

That’s the whole vibe check, bestie 🫶 Source/version is ./include/linux, dated October 2026, manual wait_event_...e_locked_irq(9) — slay, go forth and lock responsibly 💜✨

📦 where this page comes from