drm_gem_dma_...ate_internal(9)
π drm_gem_dma_dumb_create_internal, but make it make sense
okay bestie, so this is a page straight out of the Kernel API Manual (yes, the drm_gem_dma_...ate_internal(9) girlies know exactly what I mean π) and it's about making a dumb buffer object. lowkey iconic behavior, let's get into it π«Ά
β¨ NAME β¨
drm_gem_dma_dumb_create_internal β she creates a dumb buffer object. that's it, that's the job π
π¦ SYNOPSIS π¦
int drm_gem_dma_dumb_create_internal (struct drm_file *file_priv ,
struct drm_device *drm , struct drm_mode_create_dumb *args );
no cap, that's the whole signature π
π ARGUMENTS π
file_privβ the DRM file-private structure, aka where you're making this dumb buffer for πdrmβ the DRM device itself, main character energy frargsβ the IOCTL data, the whole reason we're here πΈ
π DESCRIPTION π
so what she actually does: she aligns the pitch and size arguments to the minimum required β¨ like, the bare minimum, and she does it flawlessly.
she's an internal helper, though β not a "walk right up and use her" kind of function π. a driver is meant to wrap her, so it can account for hardware that has more specific alignment requirements. that's the whole point: the driver sugar-wraps her and makes her work for their specific vibe.
bestie, please do not use her directly as your drm_driver.dumb_create callback. like, don't. nope. it's an internal helper for a reason π
β RETURN β
0 on success, or a negative error code if it didn't slay π β that's it, that's the contract.
π SEE ALSO π
- Kernel file
./drivers/gpu/drm/drm_gem_dma_helper.c(the whole friend group lives here π§) dma helpers(9)__drm_gem_dma_create(9)drm_gem_dma_create(9)drm_gem_dma_create_with_handle(9)drm_gem_dma_free(9)drm_gem_dma_dumb_create(9)drm_gem_dma_get_unmapped_area(9)drm_gem_dma_print_info(9)drm_gem_dma_get_sg_table(9)drm_gem_dma_prime_import_sg_table(9)drm_gem_dma_vmap(9)drm_gem_dma_mmap(9)drm_gem_dma_prime_import_sg_table_vmap(9)
okay that's the tea π β this page comes to you from ./drivers/gpu/drm and it's dated October 2026, so go forth and wrap your helpers responsibly. mwah π
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms