dma_fence_wait_any_timeout(9)

📦 version 7.3.1, in nixpkgs unstable

💅 dma_fence_wait_any_timeout(9) — from the Kernel API Manual, bestie

okay so picture this: you're out here with a whole array of fences and you just wanna sleep until literally any one of them gets signaled, or until the timeout runs out. that's it. that's the function. no cap.

✨ NAME ✨

dma_fence_wait_any_timeout — sleep until any fence gets signaled or until timeout elapses 🌙💤

🎀 SYNOPSIS 🎀

signed long dma_fence_wait_any_timeout (struct dma_fence **fences ,
uint32_t count , bool intr , signed long timeout , uint32_t *idx );

🦋 ARGUMENTS 🦋

  • fences — array of fences to wait on. yes, an array, she's a group activity bestie 💅
  • count — number of fences to wait on. gotta tell her how many girlies are in the lineup ✨
  • intr — if true, do an interruptible wait 😴 you can be woken up early, main character energy
  • timeout — timeout value in jiffies, or MAX_SCHEDULE_TIMEOUT ⏰ the "wait basically forever" option, iykyk
  • idx — used to store the first signaled fence index, meaningful only on positive return 👑 lowkey only useful if things actually went well

🌸 DESCRIPTION 🌸

so here's what she returns, and the vibes are very different depending on how it goes:

  • -EINVAL on custom fence wait implementation 🙈 nope, not supported
  • -ERESTARTSYS if interrupted 😭 rude, but okay
  • 0 if the wait timed out 💀 nothing happened, bestie
  • the remaining timeout in jiffies on success ✨ we love a positive outcome

she does synchronous waits for the first fence in the array to be signaled. the way that this is *synchronous*… no async games here, we're waiting fr fr.

⚠️ the caller needs to hold a reference to all fences in the array, otherwise a fence might be freed before return, resulting in undefined behavior. this is the important part bestie, do NOT skip it — undefined behavior is not cute and it does NOT slay 💅🔥

see also dma_fence_wait and dma_fence_wait_timeout 🫶

🔥 SEE ALSO 🔥

Kernel file ./drivers/dma-buf/dma-fence.c, plus the whole friend group:

and that's the whole page, bestie 🎀 she lives in ./drivers/dma-buf, dated October 2026, shipped with the Kernel API Manual — go forth and wait on your fences responsibly, ily 🫶💖

📦 where this page comes from