futex_requeue(9)

✨ futex_requeue(9) — Kernel API Manual ✨

okay so welcome to the Kernel API Manual, bestie, and specifically to the futex_requeue(9) page. grab your iced coffee 🧊 because this one is short, a little cursed, and extremely deprecated.

💖 NAME 💖

futex_requeue - requeue without expected value comparison, deprecated. yes, “deprecated” is right there in the NAME section, so that’s the vibe check and it did not pass 💀

✨ SYNOPSIS ✨

int futex_requeue (futex_t *uaddr , futex_t *uaddr2 , int nr_wake , int
       nr_requeue , int opflags );

🎀 ARGUMENTS 🎀

• uaddr — the page literally says -- undescribed --, so we are not out here inventing lore. that’s the whole description, bestie 🫶
• uaddr2 — also literally -- undescribed --. iconic? maybe not, but we respect the honesty 💅
• nr_wake — wake up to this many tasks ✨
• nr_requeue — requeue up to this many tasks 🎀
• opflags — yep, -- undescribed -- again. no cap, that’s what the page gives us 🙈

🦋 DESCRIPTION 🦋

Due to its inherently racy implementation, futex_requeue is deprecated in favor of futex_cmp_requeue.

bestie, that’s the actual warning energy: it’s inherently racy and deprecated. use futex_cmp_requeue instead, fr fr 🚨

🌸 SEE ALSO 🌸

• Kernel file ./tools/testing/selftests/futex/include/futextest.h
• futex(9)
• futex_wait(9)
• futex_wake(9)
• futex_wait_bitset(9)
• futex_wake_bitset(9)
• futex_lock_pi(9)
• futex_unlock_pi(9)
• futex_wake_op(9)
• futex_cmp_requeue(9)
• futex_wait_requeue_pi(9)
• futex_cmp_requeue_pi(9)
• futex_cmpxchg(9)
• futex_dec(9)
• futex_inc(9)
• futex_set(9)

cute sign-off time: this page’s source/version footer is ./tools/testing/selftests/fute..., it’s dated October 2026, and the page tag is futex_requeue(9). slay, stay safe, and maybe use the non-deprecated one 💜🌈