futex_wait_requeue_pi(9)

Okay bestie, this is futex_wait_requeue_pi(9) from the Kernel API Manual — and it is literally the setup half of the requeue_pi situation. 💅✨

🎀 NAME 🎀

futex_wait_requeue_pi — block on uaddr and prepare to requeue to uaddr2

✨ SYNOPSIS ✨

int futex_wait_requeue_pi (futex_t *uaddr , futex_t
       *uaddr2 , struct timespec *timeout , int opflags );

🦋 ARGUMENTS 🦋

• uaddr — non-PI futex source. That’s the vibe.
• val — the page literally says -- undescribed -- 😭 no extra lore given.
• uaddr2 — PI futex target. Main character target energy.
• timeout — also -- undescribed --. The manpage is gatekeeping, ngl.
• opflags — yep, -- undescribed -- again. 🙈

💅 DESCRIPTION 💅

This is the first half of the requeue_pi mechanism. It shall always be paired with futex_cmp_requeue_pi — periodt, do not run it solo. 🫶

👑 SEE ALSO 👑

The futex fam and friends, fr fr:

• 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_requeue(9)
• futex_cmp_requeue(9)
• futex_cmp_requeue_pi(9)
• futex_cmpxchg(9)
• futex_dec(9)
• futex_inc(9)
• futex_set(9)

Signed, sealed, delivered: futex_wait_requeue_pi(9), from the ./tools/testing/selftests/fute... source/version, dated October 2026. Stay futexy, bestie 💖🌸