drm_atomic_commit(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_atomic_commit(9) — like, the whole Kernel API Manual moment

okay bestie, so this one lives in the Kernel API Manual and it's called drm_atomic_commit — and yes the manual name is literally just hanging out at the top, we love a consistent header. Let's get into it 🫶

✨ NAME ✨

drm_atomic_commit — commit configuration atomically. iykyk, all-or-nothing energy 🔥

🎀 SYNOPSIS 🎀

int drm_atomic_commit (struct drm_atomic_commit *state );

🌸 ARGUMENTS 🌸

  • state — the atomic configuration to check. that's the one, bestie 💅

🦋 DESCRIPTION 🦋

okay so heads up, because this part matters: this function can return -EDEADLK if the driver needed to acquire more locks but encountered a deadlock 😭. When that happens, the caller must then do the usual w/w backoff dance and restart. Not me telling you to literally do the backoff dance, it's a real thing, do it. All other errors are fatal — like, actually fatal, so don't go ignoring them 🫶

Also super important: this function will take its own reference on state. So callers should always release their reference with drm_atomic_commit_put. every time. no cap. 👑

⭐ RETURN ⭐

0 on success, negative error code on failure. that's it, that's the vibe check 💀

💖 SEE ALSO 💖

that's a lot of friends but they're all iconic, we don't skip any of them 💜

ngl if you got -EDEADLK you're not done, you're just on a lil break. backoff, restart, slay.

and that's the whole page, bestie!! 🌈 this cutie came from ./drivers/gpu/drm and it's dated October 2026, filed right back under drm_atomic_commit(9) like the main character it is. periodt. 🎀✨

📦 where this page comes from