drm_writeback_queue_job(9)

✨ drm_writeback_queue_job ✨

okay so bestie, welcome to the drm_writeback_queue_job(9) page — yes that's a real function name and yes it's from the Kernel API Manual 💅 this one's all about queuing up a writeback job so it can get signalled later. stay with me, it's actually not that deep 🫶

---

🌸 SYNOPSIS 🌸

void drm_writeback_queue_job (struct drm_writeback_connector
*wb_connector , struct drm_connector_state *conn_state );

🎀 ARGUMENTS 🎀

• wb_connector — the writeback connector you're queuing a job on. this is the main character of the operation 💖
• conn_state — the connector state that's holding the job you want to queue. the job's hiding in there, lowkey 🦋

🦋 DESCRIPTION 🦋

so this function takes the job that lives inside conn_state and adds it to the job_queue of a writeback connector. slay ✨

it takes ownership of the writeback job and sets conn_state->writeback_job to NULL — which means once this function returns, the caller literally cannot touch that job anymore. no cap. it's not yours now 🙈

drivers must make sure that, for any given writeback connector, jobs get queued in exactly the same order the hardware will complete them in (and signal them via drm_writeback_signal_completion). same order, periodt. don't get cute with it 💀

and here's the matching-set rule: for every single call to drm_writeback_queue_job there must be exactly one call to drm_writeback_signal_completion. one in, one out, that's the vibe check 👑

See also: drm_writeback_signal_completion

---

⭐ 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_signal_completion(9)

---

and that's the whole page, bestie — go queue some jobs responsibly 💜

this cutie was brought to you by the source dir ./drivers/gpu/drm, dated October 2026 — drink water, read your kernel docs, and remember: exactly one signal per queue 🍓🧚