drm_plane_cr...ble_property(9)

💅 drm_plane_create_zpos_immutable_property — the Kernel API Manual tea 🫖

okay so bestie, we're in the <pink>./drivers/gpu/drm</pink> section of the Kernel API Manual (October 2026 edition, iconic), and today's main character is drm_plane_create_zpos_immutable_property. yes the name is a whole mouthful, no I will not be shortening it, periodt. ✨

---

🌸 NAME 🌸

drm_plane_create_zpos_immutable_property — create immuttable zpos property 💅

not me pointing out that the original literally spells it "immuttable" — that's canon, we keep it, iykyk 😭

---

🎀 SYNOPSIS 🎀

int drm_plane_create_zpos_immutable_property (struct drm_plane *plane ,
       unsigned int zpos );

---

🦋 ARGUMENTS 🦋

• plane — drm plane. the plane in question, the literal subject of the whole function, she's that girl 🫶
• zpos — value of zpos property. like, the actual number you're setting it to 🔥

---

💖 DESCRIPTION 💖

okay so what does this function actually do? it initializes the generic immutable zpos property and enables support for it in drm core. that's the whole vibe check ✅

using this property driver lets userspace get the arrangement of the planes for blending operation, and it also notifies userspace that the hardware (or driver) does not support changing of the planes' order. read that again — immutable, bestie, no take-backsies, the order is locked in 🔒

if you're out here wanting a mutable zpos instead, go see drm_plane_create_zpos_property. that one's the flexible sibling 💜

the property exposed to userspace is called "zpos". that's it. that's the name. slay ✨

---

⭐ RETURN ⭐

• Zero on success 🎉
• negative errno on failure 😭

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/drm_blend.c
• overview(9)
• drm_plane_create_alpha_property(9)
• drm_plane_create_rotation_property(9)
• drm_rotation_simplify(9)
• drm_plane_create_zpos_property(9)
• drm_atomic_normalize_zpos(9)
• drm_plane_create_blend_mode_property(9)
• drm_crtc_attach_background_color_property(9)

like, go read them, they're all literally right there, the whole friend group 🌈

---

that's the whole page bestie!! this one came from the ./drivers/gpu/drm section, dated October 2026 — mwah, love u, go read the kernel docs 💋🧚‍♀️