futex_cmp_requeue(9)

💅 futex_cmp_requeue(9) — bestie's guide to the Kernel API Manual

okay so picture this: you're deep in the futex cinematic universe (we love a franchise) and this little icon right here is the function that requeues tasks from uaddr to uaddr2. that's literally the whole vibe. move the sleepers, change the address, slay. 💖

no because this is one of many futex pages, so if you're new here, hi, welcome, the manual name is Kernel API Manual and we're gonna get through this together. 🫶

---

✨ SYNOPSIS ✨

look at her. she's serving signature realness, spacing and all:

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

returns an int, takes six things, we move. 🔥

---

🎀 ARGUMENTS 🎀

okay so the parameter list is lowkey giving "half-finished group project" because some of these are literally -- undescribed -- in the original docs. not me making excuses for the kernel, i'm just the messenger. 🙈 the facts stay exactly as written:

• uaddr — -- undescribed -- 💀 (yes, really. that's the whole entry.)
• val — -- undescribed -- 😭 (again. iconic of them tbh.)
• uaddr2 — -- undescribed -- 🫠 (three for three, no notes.)
• nr_wake — wake up to this many tasks 🌸 (a little wake-up party, capped at nr_wake guests)
• nr_requeue — requeue up to this many tasks 🦋 (same energy but they're getting moved, not woken)
• opflags — -- undescribed -- 🙃 (the fourth one. i know. i know.)

ngl bestie, if you came here for deep lore on uaddr, val, uaddr2 or opflags, the manpage is out of office. i'm not out here inventing behaviour — what you see is what the docs say, which is: nothing. periodt. ⭐

---

👑 SEE ALSO 👑

the friend group!! go read these next, they all ate:

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

that's the whole roster, no cap. 🌈

---

💌 sign-off

this page came to you from ./tools/testing/selftests/fute... (that's the source/version line, slightly truncated like a text message that got cut off mid-sentence 💀) and it's dated October 2026, which is so far in the future it's basically main character energy. 🎀

stay hydrated, read your futex(9) pages, and remember: if the docs say -- undescribed --, that's not a you problem. mwah. 💅✨🍓