drm_atomic_...or_connector(9)

💅 drm_atomic_set_crtc_for_connector — set CRTC for connector

okay so this is a page from the Kernel API Manual (yes, the Kernel API Manual, we're in that part of the docs bestie, the GPU driver section) and honestly? it's a little baddie with one job and she does it 💖

---

✨ SYNOPSIS ✨

int drm_atomic_set_crtc_for_connector (struct drm_connector_state
*conn_state , struct drm_crtc *crtc );

like, yes, that's the whole signature, no cap 🫶

---

🎀 ARGUMENTS 🎀

• conn_state — the atomic state object for the connector. that's her little state era 💅
• crtc — the CRTC to use for the connector. the actual destination, the main character 👑

---

🌸 DESCRIPTION 🌸

so when you're changing the assigned CRTC for a connector, you can't just do it, babes, because you need to grab the lock and the state for the new CRTC as needed 😭 like there are steps.

this function takes care of all those details 🫶

the one thing she does not do? updating the pointer in the state object itself. nope, that part's on you, bestie. she handles the logistics, you handle the pointer, it's giving teamwork 💖

---

⭐ RETURN ⭐

• 0 — success, slay, we ate 🎉
• -EDEADLK — uh oh. when the error is EDEADLK that means the w/w mutex code has detected a deadlock, and the entire atomic sequence must be restarted 🔁 like, the whole thing, from the top, no skipping 🙈
• -ENOMEM — out of memory, tragic 💀

also: all other errors are fatal. like, genuinely, not in a cute way. periodt.

---

🦋 SEE ALSO 🦋

the girlies in her orbit 💫

• kernel file ./drivers/gpu/drm/drm_atomic_uapi.c
• overview(9)
• drm_atomic_set_mode_for_crtc(9)
• drm_atomic_set_mode_prop_for_crtc(9)
• drm_atomic_set_crtc_for_plane(9)
• drm_atomic_set_fb_for_plane(9)
• drm_atomic_set_colorop_for_plane(9)
• explicit fencing properties(9)

---

🌈 the sign-off 🌈

okay that's the whole page, ily, go set some CRTCs responsibly 💜

this little beauty comes from ./drivers/gpu/drm, and the page is dated October 2026, filed under drm_atomic_...or_connector(9) — yes the truncated title is literally part of the vibe, don't come for her 🎀