futex_wait_multiple(9)

💖 futex_wait_multiple(9) 💖

okay so welcome to the Kernel API Manual page for futex_wait_multiple(9) — bestie, we are literally about to get into futex group-chat nap mode 🫶✨

---

🎀 NAME 🎀

futex_wait_multiple — prepare to wait on and enqueue several futexes, periodt 💅

---

✨ SYNOPSIS ✨

int futex_wait_multiple (struct futex_vector *vs , unsigned int count ,
struct hrtimer_sleeper *to );

---

🫶 ARGUMENTS 🫶

• vs — the list of futexes to wait on, like the little squad you're keeping an eye on 👀
• count — the number of objects, fr fr 🔢
• to — timeout before giving up and returning to userspace ⏰

---

💅 DESCRIPTION 💅

Entry point for the FUTEX_WAIT_MULTIPLE futex operation. This function sleeps on a group of futexes and returns on the first futex that is wake, or after the timeout has elapsed.

it's giving "group nap until somebody wakes up or the timer says enough" energy 😭🌸

---

👑 RETURN 👑

• >=0 — hint to the futex that was awoken 👑
• <0 — on error 💀

---

🦋 SEE ALSO 🦋

Kernel file ./kernel/futex/waitwake.c, plus the whole squad: futex_do_wait(9), futex_unqueue_multiple(9), futex_wait_multiple_setup(9), futex_sleep_multiple(9), and futex_wait_setup(9) 🦋✨

---

catch u in ./kernel/futex — October 2026 edition, page futex_wait_multiple(9) 💖🎀