drm_gem_fb_c...e_with_dirty(9)

📦 version 7.3.1, in nixpkgs unstable

💅 drm_gem_fb_c...e_with_dirty(9) — Kernel API Manual ✨

okay bestie, sit down, because this one is from the Kernel API Manual and it's genuinely so useful 🫶

🌸 NAME 🌸

drm_gem_fb_create_with_dirty — the helper function for the &drm_mode_config_funcs.fb_create callback 💖

🦋 SYNOPSIS 🦋

struct drm_framebuffer * drm_gem_fb_create_with_dirty (struct drm_device
*dev , struct drm_file *file , const struct drm_format_info *info ,
const struct drm_mode_fb_cmd2 *mode_cmd );

like… look at that signature. main character energy fr fr 👑

🎀 ARGUMENTS 🎀

  • dev — the DRM device, obvs 🖥️
  • file — the DRM file that's holding the GEM handle(s) backing the framebuffer, iykyk
  • info — pixel format information ✨
  • mode_cmd — the metadata straight from the userspace framebuffer creation request 📨

🔥 DESCRIPTION 🔥

so this function creates a brand-new framebuffer object, described by drm_mode_fb_cmd2. and that description? it includes handles for the buffer(s) backing the framebuffer, no cap 💯

drm_atomic_helper_dirtyfb gets used as the dirty callback, which gives you framebuffer flushing through the atomic machinery ⚙️. lowkey if you don't need the dirty callback, just use drm_gem_fb_create instead — periodt.

also the function does buffer size validation, so it's looking out for you 🫶

drivers should also call drm_plane_enable_fb_damage_clips on all planes so userspace can use damage clips with the ATOMIC IOCTL too 👀 don't skip this one bestie.

drivers can use this as their drm_mode_config_funcs.fb_create callback — and the ADDFB2 IOCTL is what calls into this callback 🌈

⭐ RETURN ⭐

a pointer to a drm_framebuffer on success 🎉 or an error pointer on failure 😭 (the classic duality of man)

🧚 SEE ALSO 🧚

kernel file ./drivers/gpu/drm/drm_gem_framebuffer_helper.c plus the whole friend group:

and that's the page, bestie 💜 this little icon lives in ./drivers/gpu/drm and the version's dated October 2026 — go slay some framebuffers, ily 🎀✨

📦 where this page comes from