drm_mode_plane_set_obj_prop(9)

💅 drm_mode_plane_set_obj_prop(9)

okay bestie, welcome to the drm_mode_plane_set_obj_prop page ✨ this one's from the Kernel API Manual, and honestly? it's a little function with main character energy — it just sets a property on a plane and dips. let's get into it 🎀

---

✨ NAME ✨

drm_mode_plane_set_obj_prop — set the value of a property 🫶

🌸 SYNOPSIS 🌸

int drm_mode_plane_set_obj_prop (struct drm_plane *plane , struct
       drm_property *property , uint64_t value );

like look at that signature. three args, returns an int, no cap 🔥

🦋 ARGUMENTS 🦋

• plane — the drm plane object we're setting a property value for. this is the vibe we're editing, the main character in question 👑
• property — the property to set. which knob are we turning? this one 🎛️
• value — the value the property should be set to. the actual number going in, uint64_t and everything 💜

💖 DESCRIPTION 💖

so here's the tea: this function sets a given property on a given plane object. that's it, that's the job, and it does it slayfully ✨

the way it works — and this part is literally the important bit — it calls the driver's ->set_property callback, and it changes the software state of the property if the callback succeeds. so the driver gets first dibs, and only when the driver says "yeah we're good" does the software state actually get updated. no callback success, no state change. periodt 💅

ngl that conditional is doing a lot of heavy lifting, so don't skip over it — success of the callback is what gates the software state change, fr fr 💀

⭐ RETURN ⭐

• Zero on success 🌈
• error code on failure 😭

(yes, that's the whole return section — short and iconic)

🧚 SEE ALSO 🧚

• Kernel file ./drivers/gpu/drm/drm_plane.c — the home base of all this 🏠
• overview(9)
• standard plane properties(9)
• hotspot properties(9)
• drm_plane_create_hotspot_properties(9)
• drm_universal_plane_init(9)
• drm_plane_cleanup(9)
• drm_plane_from_index(9)
• drm_plane_force_disable(9)
• drm_plane_has_format(9)
• drm_any_plane_has_format(9)
• damage tracking(9)
• drm_plane_enable_fb_damage_clips(9)
• drm_plane_get_damage_clips_count(9)
• drm_plane_get_damage_clips(9)
• drm_plane_create_scaling_filter_property(9)
• drm_plane_add_size_hints_property(9)
• drm_plane_create_color_pipeline_property(9)

like, that's a whole friend group of plane functions and you should absolutely go meet them 🫶 iykyk 🦋

---

and that's the page!! 🎀 sign-off time: this cutie lives under ./drivers/gpu/drm, dated October 2026, and she goes by drm_mode_plane_set_obj_prop(9) — mwah 💋 go set some properties, bestie 💅✨