drm_gem_dupl..._plane_state(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_gem_duplicate_shadow_plane_state(9) 💅

okay bestie so this is a page from the Kernel API Manual — yes it's giving big kernel energy, don't panic, we got you 🫶

✨ NAME ✨

drm_gem_duplicate_shadow_plane_state — duplicates shadow-buffered plane state, literally that's the whole vibe 🦋

🌸 SYNOPSIS 🌸

struct drm_plane_state * drm_gem_duplicate_shadow_plane_state (struct drm_plane *plane );

🎀 ARGUMENTS 🎀

  • plane — the plane. that's it, that's the argument, she's a simple icon 👑

💖 DESCRIPTION 💖

okay so here's the tea: this function is the implementation of struct drm_plane_funcs.atomic_duplicate_state for shadow-buffered planes. like, that's its whole job, that's her main character moment ✨

she assumes the existing state is of type struct drm_shadow_plane_state, and then she allocates the new state to be exactly that type too. consistent queen 💅

but — and this is the important part, ngl — the function does not duplicate existing mappings of the shadow buffers. no cap. those mappings are maintained during the atomic commit by the plane's prepare_fb and cleanup_fb helpers instead 🧚

so if you wanna see the corresponding helpers, go look at drm_gem_prepare_shadow_fb and drm_gem_cleanup_shadow_fb. iykyk 🔥

⭐ RETURN ⭐

a pointer to a new plane state on success 💖 or NULL otherwise 😭 that's it, that's the return value, no plot twists.

🌈 SEE ALSO 🌈

so many friends, we love a linked list of icons 👑

and that's the whole page bestie, go forth and duplicate those shadow-buffered plane states responsibly 🦋💜

mwah 💋 — this lil gem lives in ./drivers/gpu/drm, dated October 2026, and yes the header still says drm_gem_dupl..._plane_state(9) because some things are simply iconic and we don't touch them ✨

📦 where this page comes from