futex_unqueue_multiple(9)

🌸 NAME 🌸

futex_unqueue_multiple — Remove various futexes from their hash bucket 💅 periodt.

Okay bestie, welcome to the futex_unqueue_multiple(9) page from the Kernel API Manual ✨ she's giving kernel-helper realness and we're here for it 🫶.

🦋 SYNOPSIS 🦋

int futex_unqueue_multiple (struct futex_vector *v , int count );

🎀 ARGUMENTS 🎀

• v — the list of futexes to unqueue, aka the little roster of futexes we're pulling out 👑
• count — number of futexes in the list, so you know how many besties we're handling 🔢

💖 DESCRIPTION 💖

This is a helper that unqueues a list of futexes. And the iconic part? This can't fail — literally cannot fail, no cap 😭💅. No error-path drama, she just does the thing.

⭐ RETURN ⭐

• >=0 — index of the last futex that was awoken 🌈 the final sleepyhead to get the wake-up call, iykyk
• -1 — no futex was awoken 💀 not a single one, zero, nada

🔥 SEE ALSO 🔥

The kernel file ./kernel/futex/waitwake.c is the scene of the crime, bestie 🧚✨ — and you'll also wanna peek at futex_do_wait(9), futex_wait_multiple_setup(9), futex_sleep_multiple(9), futex_wait_multiple(9), and futex_wait_setup(9). All the related futex lore lives right there 💜.

that's the whole page, bestie! source/version vibes come from ./kernel/futex, dated October 2026, and the page is futex_unqueue_multiple(9) — mwah 💋💖