drm_gem_shmem_dumb_create(9)

💅 drm_gem_shmem_dumb_create(9) — like, the shmem dumb-buffer creator, bestie

okay so real talk, this is a page from the Kernel API Manual (the drm_gem_shmem_dumb_create(9) one, yes that one) and honestly? it's kind of a bop. let's get into it ✨

---

🌸 NAME 🌸

drm_gem_shmem_dumb_create — literally creates a dumb shmem buffer object 🎀

---

🦋 SYNOPSIS 🦋

int drm_gem_shmem_dumb_create (struct drm_file *file , struct drm_device
*dev , struct drm_mode_create_dumb *args );

no cap, that's the whole signature. she's compact, she's iconic 💅

---

✨ ARGUMENTS ✨

• file — the DRM file structure you're creating the dumb buffer for. it's giving "who's this for" energy 🫶
• dev — the DRM device. main character energy fr fr 👑
• args — the IOCTL data. yes that's it, that's the whole description, we move 🏃‍♀️💨

---

🎀 DESCRIPTION 🎀

so what does she actually do? this function computes the pitch of the dumb buffer and rounds it up to an integer number of bytes per pixel. math moment, but make it slay 🔥

drivers for hardware that doesn't have any additional restrictions on the pitch can directly use this function as their drm_driver.dumb_create callback. like, plug and play bestie, no notes ✨

for hardware with additional restrictions, drivers can adjust the fields set up by userspace before calling into this function. so you get to pre-game it a lil bit before the actual call 🙈💜

---

⭐ RETURN ⭐

0 on success, or a negative error code on failure. that's it. that's the vibe check 💀 (negative = not it, bestie 😭)

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/drm_gem_shmem_helper.c overview(9)
• drm_gem_shmem_init(9)
• drm_gem_shmem_create(9)
• drm_gem_shmem_release(9)
• drm_gem_shmem_free(9)
• drm_gem_shmem_pin(9)
• drm_gem_shmem_unpin(9)
• drm_gem_shmem_create_with_handle(9)
• drm_gem_shmem_mmap(9)
• drm_gem_shmem_print_info(9)
• drm_gem_shmem_get_sg_table(9)
• drm_gem_shmem_get_pages_sgt(9)
• drm_gem_shmem_prime_import_sg_table(9)
• drm_gem_shmem_prime_import_no_map(9)

like, the whole friend group. iykyk 🧚‍♀️🍓

ngl bestie, there's no OPTIONS, no EXAMPLES, no BUGS, no AUTHOR, no COPYRIGHT section on this one — so if you were waiting for the usual suspects, they are not here. don't come for me, come for the source 🙈

---

and that's the whole page!! mwah 💋 source is ./drivers/gpu/drm, dated October 2026 — xoxo, your fav kernel bestie, periodt 💖🫶🌸