STRUCT DRM_GEM_CHANGE_HANDLE(9)

💅 struct drm_gem_change_handle(9) 💅

okay bestie, welcome to the <pink>Kernel API Manual</pink> ✨ — this page is literally all about struct drm_gem_change_handle(9) and it's lowkey iconic. it's short, it's sweet, it's giving "small struct, big glow-up energy" 🎀

---

🌸 NAME 🌸

struct drm_gem_change_handle — the argument struct for the &DRM_IOCTL_GEM_CHANGE_HANDLE ioctl. that's it, that's the whole vibe 🫶

---

✨ SYNOPSIS ✨

struct drm_gem_change_handle {
    __u32 handle;
    __u32 new_handle;
 };

look at her. two __u32s and a dream 😭 remember the struct definition is exactly this, spacing and all — don't go "fixing" it, bestie, that's not the assignment 💀

---

🦋 Members 🦋

• handle — the handle of a gem object. the OG, the one you currently have, the main character before the name change 👑
• new_handle — an available gem handle. this one has to be free, like an empty seat at the lunch table 🌸

---

🔥 Description 🔥

so here's the tea ☕: this ioctl changes the handle of a GEM object to the one you specified. yes, a whole rebrand. new name, same object 💅

⚠️ the new handle must be unused. no cap, that's a hard requirement — obviously don't try to hand it a handle that's already taken 🙈

on success the old handle is closed, and after that literally all further IOCTL calls should refer to the new handle only. the old one? gone. moved on. blocked. ✌️

and here's the cute part 🥰 — calls to DRM_IOCTL_PRIME_FD_TO_HANDLE will return the new handle. so everything stays consistent, no leftover confusion, we love a clean transition ✨ periodt.

---

🎀 SEE ALSO 🎀

okay this list is long and honestly kind of iconic — grab a snack 🍓, here's the whole crew:

• Kernel file ./tools/perf/trace/beauty/include/uapi/drm/drm.h
• struct drm_gem_close(9), struct drm_gem_flink(9), struct drm_gem_open(9)
• DRM_CAP_DUMB_BUFFER(9), DRM_CAP_VBLANK_HIGH_CRTC(9), DRM_CAP_DUMB_PREFERRED_DEPTH(9), DRM_CAP_DUMB_PREFER_SHADOW(9), DRM_CAP_PRIME(9), DRM_PRIME_CAP_IMPORT(9), DRM_PRIME_CAP_EXPORT(9), DRM_CAP_TIMESTAMP_MONOTONIC(9), DRM_CAP_ASYNC_PAGE_FLIP(9), DRM_CAP_CURSOR_WIDTH(9), DRM_CAP_CURSOR_HEIGHT(9), DRM_CAP_ADDFB2_MODIFIERS(9), DRM_CAP_PAGE_FLIP_TARGET(9), DRM_CAP_CRTC_IN_VBLANK_EVENT(9), DRM_CAP_SYNCOBJ(9), DRM_CAP_SYNCOBJ_TIMELINE(9), DRM_CAP_ATOMIC_ASYNC_PAGE_FLIP(9)
• DRM_CLIENT_CAP_STEREO_3D(9), DRM_CLIENT_CAP_UNIVERSAL_PLANES(9), DRM_CLIENT_CAP_ATOMIC(9), DRM_CLIENT_CAP_ASPECT_RATIO(9), DRM_CLIENT_CAP_WRITEBACK_CONNECTORS(9), DRM_CLIENT_CAP_CURSOR_PLANE_HOTSPOT(9), DRM_CLIENT_CAP_PLANE_COLOR_PIPELINE(9)
• struct drm_syncobj_eventfd(9)
• DRM_IOCTL_GEM_CLOSE(9), DRM_IOCTL_PRIME_HANDLE_TO_FD(9), DRM_IOCTL_PRIME_FD_TO_HANDLE(9), DRM_IOCTL_MODE_RMFB(9), DRM_IOCTL_MODE_CREATE_DUMB(9), DRM_IOCTL_MODE_GETFB2(9), DRM_IOCTL_SYNCOBJ_EVENTFD(9), DRM_IOCTL_MODE_CLOSEFB(9), DRM_IOCTL_SET_CLIENT_NAME(9), DRM_IOCTL_GEM_CHANGE_HANDLE(9)
• struct drm_event(9), DRM_EVENT_VBLANK(9), DRM_EVENT_FLIP_COMPLETE(9), DRM_EVENT_CRTC_SEQUENCE(9)

---

and that's the whole page, bestie 🧚💜 source path is ./tools/perf/trace/beauty/incl... and it's dated October 2026 — so go forth, change those handles, and remember: the new handle must be unused, or it's giving chaos 😭✨