xe_force_wake_put(9)

💅 xe_force_wake_put(9)

okay so bestie, welcome to the Kernel API Manual — we're doing the Kernel API Manual thing today, and the star of the show is xe_force_wake_put. yes it's a function name, yes it's giving "let her sleep", stay with me 💤✨

🎀 NAME

xe_force_wake_put — decrements the refcount and, if that refcount hits 0, tucks the domain into bed 🛏️💖

✨ SYNOPSIS

void xe_force_wake_put (struct xe_force_wake *fw , unsigned int fw_ref );

like, that's it. that's the whole signature. no cap 🫶

🌸 ARGUMENTS

• fw — pointer to the force wake structure 🧚‍♀️ (the main character, honestly)
• fw_ref — the return of xe_force_wake_get ✨ (yes, this is a couple-y situation, they come in pairs, iykyk)

🔥 DESCRIPTION

okay so here's the tea ☕: this function reduces the reference counts for the domains inside fw_ref. simple enough, right?

but the moment the refcount for any of the specified domains reaches 0, she puts that domain to sleep 😴 and then she waits for acknowledgment that the domain is actually asleep, all within a 50 milisec timeout ⏱️. the drama. the suspense.

and if that ack times out? she warns. periodt 💀 like, that's not a silent failure, bestie, she will absolutely let you know 🙈

👑 SEE ALSO

• Kernel file ./drivers/gpu/drm/xe/xe_force_wake.c
• xe_force_wake_get(9) 💖 (the other half of this duo, go say hi)

🌈 that's the whole page, bestie — sourced straight from ./drivers/gpu/drm/xe, dated October 2026, and brought to you with love, 50 milisec of patience, and zero chill 💅💜