DRM_IOCTL_GEM_CHANGE_HANDLE(9)

💅 DRM_IOCTL_GEM_CHANGE_HANDLE(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes, the whole manual, and yes, we're gonna get through it together 🫶 this one's short and sweet, so grab your iced coffee and let's go ✨

---

🌸 NAME 🌸

DRM_IOCTL_GEM_CHANGE_HANDLE — move an object to a different handle. that's it. that's the whole vibe. a lil glow-up for your handle 💅

---

🦋 SYNOPSIS 🦋

DRM_IOCTL_GEM_CHANGE_HANDLE

like, that's literally it. iconic minimalism. no args in the synopsis, no drama, just the name 🔥

---

🎀 DESCRIPTION 🎀

so some applications — and the manpage is calling out CRIU specifically, notable queen behavior 👑 — need their objects to have specific gem handles. like, they're not flexible about it. they need the exact handle, no substitutions, no "close enough," no cap 💯

and that's what this ioctl does: it changes the object at one gem handle to use a new gem handle. one handle in, that same object now answers to a different handle. a rebrand, if you will ✨

that's the entire description, bestie. short, sweet, ate and left no crumbs 🍓

---

💖 SEE ALSO 💖

the deep lore 🌈 — go read these if you want the full picture:

• 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)
• struct drm_gem_change_handle(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)
• struct drm_event(9)
• DRM_EVENT_VBLANK(9)
• DRM_EVENT_FLIP_COMPLETE(9)
• DRM_EVENT_CRTC_SEQUENCE(9)

like, that's a lot of links, but that's the list, so we're listing them all. we don't skip. skipping is not the vibe 🙈

---

reminder babe: this page has no options section, no return values, no errors listed. don't go looking for them, they're not here. what you see is what you get 💀

---

and that's the whole page, bestie!! 🌟 you understood it, you slayed it, you're literally the main character of the kernel docs now 👑

sign-off time 🎀 this one came from ./tools/perf/trace/beauty/incl... (yes the footer path is literally truncated with an ellipsis, that's how it shipped, we don't fix 💀) and it's dated October 2026 — so go forth, change those handles, and stan DRM_IOCTL_GEM_CHANGE_HANDLE fr fr 💜🦋✨