STRUCT DRM_MODE_OBJECT(9)

✨ struct drm_mode_object(9) ✨

okay so this is from the Kernel API Manual and it's literally the blueprint for modeset objects — like the main-character base struct everyone else inherits the vibe from 💅

🎀 NAME 🎀

struct drm_mode_object — the base structure for modeset objects, no cap 🫶

🌸 SYNOPSIS 🌸

struct drm_mode_object {
    uint32_t id;
    uint32_t type;
    struct drm_object_properties *properties;
    struct kref refcount;
    void (*free_cb)(struct kref *kref);
 };

🦋 Members 🦋

• id — the userspace visible identifier, aka the name tag everyone in userspace gets to see 💖
• type — what kind of object this is, and it's gotta be one of the DRM_MODE_OBJECT_ values ⭐
• properties — the properties attached to this object, including their values. the whole package, bestie 🎀
• refcount — the reference count, for objects that have a dynamic lifetime 🔥
• free_cb — the free function callback, and heads up: this one's only set for objects with a dynamic lifetime 👑

💜 Description 💜

So this is the base structure for modeset objects that are visible to userspace. You can look objects up using drm_mode_object_find. Besides the basic uapi interface properties like id and type, it provides two services:

• It tracks attached properties and their values. This is what drm_crtc, drm_plane and drm_connector use. Properties get attached by calling drm_object_attach_property before the object is visible to userspace — timing matters, periodt ⏰✨
• For objects with dynamic lifetimes (as indicated by a non-NULL free_cb) it provides reference counting through drm_mode_object_get and drm_mode_object_put. This is used by drm_framebuffer, drm_connector and drm_property_blob. Those objects go ahead and provide specialized reference counting wrappers, because of course they do 💅

🌈 SEE ALSO 🌈

• Kernel file ./include/drm/drm_mode_object.h struct drm_object_properties(9)

and that's the whole page, bestie 🍓 tysm for reading — it lives in ./include/drm and the version stamp says October 2026, so mark your calendar 🧚💖