wait_event_state(9)

💤 wait_event_state(9) — the "just nap till it's true" page 💤

okay bestie, welcome to wait_event_state(9) from the Kernel API Manual ✨ this one's a kernel function and it's genuinely so cosy, it's giving "power nap until the vibes are correct" 🎀

---

✨ NAME ✨

wait_event_state — sleep until a condition gets true 💤🦋

---

🌸 SYNOPSIS 🌸

wait_event_state (wq_head , condition , state );

---

🎀 ARGUMENTS 🎀

• wq_head — the waitqueue to wait on. this is your little waiting room, bestie 🪑
• condition — a C expression for the event to wait for 👀
• state — the state to sleep in 😴

---

💅 DESCRIPTION 💅

The process is put to sleep (in state, obviously) until the condition evaluates to true or a signal is received — and that signal business only counts when allowed by state, okay? 🫶 The condition gets checked every single time the waitqueue wq_head is woken up. like a little vibe check on loop 🔁

⚠️ important, no cap: wake_up has to be called after changing any variable that could change the result of the wait condition. otherwise your process is just gonna snooze forever and that's not the slay we're going for 💀

The function will return -ERESTARTSYS if it was interrupted by a signal (again — when allowed by state), and 0 if condition evaluated to true 🌈

---

🔥 SEE ALSO 🔥

the whole waitqueue friend group 🫶 and yes, they're all in the kernel file ./include/linux/wait.h:

• waitqueue_active(9)
• wq_has_single_sleeper(9)
• wq_has_sleeper(9)
• wake_up_pollfree(9)
• wait_event(9)
• wait_event_freezable(9)
• wait_event_timeout(9)
• wait_event_cmd(9)
• wait_event_interruptible(9)
• wait_event_interruptible_timeout(9)
• wait_event_hrtimeout(9)
• wait_event_interruptible_hrtimeout(9)
• wait_event_idle(9)
• wait_event_idle_exclusive(9)
• wait_event_idle_timeout(9)
• wait_event_idle_exclusive_timeout(9)
• wait_event_interruptible_locked(9)
• wait_event_interruptible_locked_irq(9)
• wait_event_interruptible_exclusive_locked(9)
• wait_event_interruptible_exclusive_locked_irq(9)
• wait_event_killable(9)
• wait_event_killable_timeout(9)
• wait_event_lock_irq_cmd(9)
• wait_event_lock_irq(9)
• wait_event_interruptible_lock_irq_cmd(9)
• wait_event_interruptible_lock_irq(9)
• wait_event_interruptible_lock_irq_timeout(9)

---

that's the whole page, bestie — go take a nap until your condition is true, you've earned it 😴💜

✧･ﾟ signed, sealed, delivered from ./include/linux, dated October 2026, wait_event_state(9) ･ﾟ✧