drm_atomic_...cking_commit(9)

💅 drm_atomic_nonblocking_commit(9) — the vibe check

okay so bestie, we're in the Kernel API Manual today and this one is literally the "do it but don't wait for it" commit. no cap. ✨

---

🌸 NAME 🌸

drm_atomic_nonblocking_commit — atomic nonblocking commit. she does the commit but she is not about to stand around waiting for it. main character energy only 👑

---

🎀 SYNOPSIS 🎀

int drm_atomic_nonblocking_commit (struct drm_atomic_commit *state );

---

🦋 ARGUMENTS 🦋

• state — the atomic configuration to check. that's it, that's the whole argument, she's low maintenance 💅

---

🔥 DESCRIPTION 🔥

okay so first thing, and this is highkey important: this function can return -EDEADLK if the driver needed to acquire more locks but ran into a deadlock. so if that happens, the caller has to do the usual w/w backoff dance and restart. yep, the whole dance. 💀

all the other errors though? fatal. no takebacks, no retries, that's the end of the road fr fr.

also this function will take its own reference on state. so callers should always release their reference with drm_atomic_commit_put. like, always always. don't leave her hanging 🙈

---

⭐ RETURN ⭐

0 on success, negative error code on failure. slay or don't slay, there is no in between 🫶

---

🌈 SEE ALSO 🌈

the whole group chat, in order:

• Kernel file ./drivers/gpu/drm/drm_atomic.c state lifetime(9)
• drm_crtc_commit_wait(9)
• drm_atomic_commit_default_release(9)
• drm_atomic_commit_init(9)
• drm_atomic_commit_alloc(9)
• drm_atomic_commit_default_clear(9)
• drm_atomic_commit_clear(9)
• __drm_atomic_commit_free(9)
• drm_atomic_get_crtc_state(9)
• drm_atomic_get_plane_state(9)
• drm_atomic_get_colorop_state(9)
• drm_atomic_get_old_colorop_state(9)
• drm_atomic_get_new_colorop_state(9)
• drm_atomic_plane_check(9)
• handling driver private state(9)
• drm_atomic_private_obj_init(9)
• drm_atomic_private_obj_fini(9)
• drm_atomic_get_private_obj_state(9)
• drm_atomic_get_old_private_obj_state(9)
• drm_atomic_get_new_private_obj_state(9)
• drm_atomic_get_old_connector_for_encoder(9)
• drm_atomic_get_new_connector_for_encoder(9)
• drm_atomic_get_connector_for_encoder(9)
• drm_atomic_get_old_crtc_for_encoder(9)
• drm_atomic_get_new_crtc_for_encoder(9)
• drm_atomic_get_connector_state(9)
• drm_atomic_get_bridge_state(9)
• drm_atomic_get_old_bridge_state(9)
• drm_atomic_get_new_bridge_state(9)
• drm_atomic_add_encoder_bridges(9)
• drm_atomic_add_affected_connectors(9)
• drm_atomic_add_affected_planes(9)
• drm_atomic_add_affected_colorops(9)
• drm_atomic_check_only(9)
• drm_atomic_commit(9)
• drm_atomic_print_new_state(9)
• drm_state_dump(9)

---

and that's the whole page, bestie 🍓 this lil gem lives at ./drivers/gpu/drm and the version/date stamp on it is October 2026 — iconic, ahead of her time fr. iykyk 💜🧚