drm_writeba...l_completion(9)

💖 drm_writeback_signal_completion(9) — Kernel API Manual 💖

okay so bestie, buckle up, because this one is from the Kernel API Manual and it's literally the "hey the hardware is done, tell everyone" function 🎀

---

✨ NAME ✨

drm_writeback_signal_completion — signal the completion of a writeback job 🦋

like, the little bell you ring when the writeback job is officially done, no cap.

---

🌸 SYNOPSIS 🌸

void drm_writeback_signal_completion (struct drm_writeback_connector
*wb_connector , int status );

that's the whole vibe. void return, cutie — no coming back, no receipts. 💅

---

🧚 ARGUMENTS 🧚

• wb_connector — the writeback connector whose job is complete 👑 like, this is the connector, the main character, the one who just finished.
• status — the status code you're setting in the writeback out_fence. 0 means success 💚 (yes, zero is the good one here, iconic behaviour).

---

🔥 DESCRIPTION 🔥

so drivers, listen up: you call this to signal the completion of a writeback job you queued earlier. it should be called ASAP after the hardware has finished writing — like, the instant, don't be shy — and it may be called from interrupt context 😭 (yes, from interrupt context, that's not a typo, that's just how it lives).

it is the driver's responsibility to make sure that, for a given connector, the hardware completes writeback jobs in the same order as they are queued. 👑 order matters, periodt. no queue-jumping, no chaos, keep it in line.

💀 real talk warning: unless the driver is holding its own reference to the framebuffer, it must not be accessed after calling this function. like, do not touch it after. it's gone. respect the boundary 🫶

See also: drm_writeback_queue_job ✨ (the queuing half of the story, iykyk)

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_writeback.c overview(9)
• drm_writeback_connector_init(9)
• __drm_writeback_connector_init(9)
• drm_writeback_connector_init_with_encoder(9)
• drm_writeback_connector_cleanup(9)
• drmm_writeback_connector_init(9)
• drm_writeback_queue_job(9)

go read all of them, bestie, they're all linked, it's giving a whole ecosystem 🌸⭐

---

💜 mwah, that's the page 💜 from ./drivers/gpu/drm, dated October 2026, in the Kernel API Manual — slay, bye 🎀💅