wait_for_co...ible_timeout(9)

📦 version 7.3.1, in nixpkgs unstable

💅 NAME 💅

okay so bestie, welcome to wait_for_completion_interruptible_timeout — manual section 9, Kernel API Manual, the whole vibe. she waits for completion (w/(to,intr)), and yes that abbreviation is literally just her being extra. 🎀

✨ SYNOPSIS ✨

long wait_for_completion_interruptible_timeout (struct completion *x ,
       unsigned long timeout );

like, that's the whole signature. two args, one long coming back at you. 💖

🫶 ARGUMENTS 🫶

  • x — holds the state of this particular completion. she's the main character, she keeps the receipts. 👑
  • timeout — timeout value in jiffies. yes, jiffies. not seconds, not ms, jiffies. iykyk. ⏳

🌸 DESCRIPTION 🌸

so what she does is: she waits for either a completion of a specific task to be signaled, or for a specified timeout to expire. whichever comes first, she's out. it's giving "i'll wait but not forever" energy. 💅

and the key thing — she is interruptible. so if a signal shows up, she's not gonna just stand there. she dips. 🦋

the timeout is in jiffies. fr fr, jiffies. don't @ me with milliseconds. 🌈

⭐ RETURN ⭐

here's the vibe check on what she hands back, and there are exactly three moods:

  • -ERESTARTSYS — if interrupted. someone signaled, she's out. 😭
  • 0 — if timed out. she waited the whole time and nothing happened. 💀
  • positive — if completed! at least 1, or the number of jiffies left till timeout. so like, a positive number means we ate. 🔥
ngl, the positive return being "jiffies left till timeout" is such a cute little bonus detail, don't sleep on it. ✨

🧚 SEE ALSO 🧚

kernel file ./kernel/sched/completion.c — that's where the magic lives, bestie:

like she has a whole friend group and every single one of them is iconic in her own way. go say hi. 🫶🌸

and that's the page, pookies — brought to you from ./kernel/sched, dated October 2026, and filed under wait_for_co...ible_timeout(9) because even the header got truncated and honestly? relatable. 💜🎀🦋

📦 where this page comes from