drm_plane_h...date_primary(9)

💅 drm_plane_helper_update_primary(9) 💅

okay so this is a page straight out of the Kernel API Manual (yes, the Kernel API Manual, we stan a legend), and bestie, we are talking about drm_plane_helper_update_primary. Buckle up, it's giving "vintage helper function energy" 🎀

---

✨ NAME ✨

drm_plane_helper_update_primary — the helper for updating primary planes, no cap 🦋

---

🌸 SYNOPSIS 🌸

int drm_plane_helper_update_primary (struct drm_plane *plane , struct
drm_crtc *crtc , struct drm_framebuffer *fb , int crtc_x , int crtc_y ,
unsigned int crtc_w , unsigned int crtc_h , uint32_t src_x , uint32_t
src_y , uint32_t src_w , uint32_t src_h , struct drm_modeset_acquire_ctx
*ctx );

like, look at that signature. it's long long. twelve whole parameters. main character energy honestly 👑

---

🫶 ARGUMENTS 🫶

• plane — the plane you're updating, bestie. that's the whole vibe.
• crtc — the plane's new CRTC 💖
• fb — the plane's new framebuffer, slay
• crtc_x — the x coordinate within the CRTC
• crtc_y — the y coordinate within the CRTC
• crtc_w — the width coordinate within the CRTC
• crtc_h — the height coordinate within the CRTC
• src_x — the x coordinate within the source
• src_y — the y coordinate within the source
• src_w — the width coordinate within the source
• src_h — the height coordinate within the source
• ctx — the modeset locking context 🔒 (lock girl summer)

---

🦋 DESCRIPTION 🦋

so what does it do? this helper validates the parameters you hand it and then updates the primary plane. that's it, that's the function. simple, iconic, done 💅

but here's the part where you need to listen, bestie, because this is a big deal:

this function is only useful for non-atomic modesetting. don't use it in new drivers. fr fr. not me warning you so you don't get dragged in code review 😭

---

⭐ RETURN ⭐

zero on success 🎉 — or an errno code otherwise (sad girl hours) 🙈

---

🌈 SEE ALSO 🌈

• the Kernel file ./drivers/gpu/drm/drm_plane_helper.c overview(9)
• drm_plane_helper_disable_primary(9)
• drm_plane_helper_destroy(9)

go read those too, iykyk 🔥

---

and that's the whole page, bestie! this one's from ./drivers/gpu/drm, dated October 2026 — the Kernel API Manual said periodt and signed off, and honestly? we're obsessed 🧚💜💖