drm_gem_map_dma_buf(9)

okay bestie, welcome to the Kernel API Manual ✨ this page is for drm_gem_map_dma_buf(9) — the map_dma_buf implementation for GEM, and she’s literally here to handle the scatterlist situation. 💅

🌸 NAME 🌸

drm_gem_map_dma_buf — the map_dma_buf implementation for GEM. that’s the whole name and the whole vibe. 🫶

✨ SYNOPSIS ✨

struct sg_table * drm_gem_map_dma_buf (struct dma_buf_attachment *attach
, enum dma_data_direction dir );

🎀 ARGUMENTS 🎀

• attach — the attachment whose scatterlist is to be returned. that’s the attachment we’re serving back, periodt. 💖
• dir — the direction of DMA transfer. which way the DMA vibes are flowing, bestie. 🌈

🦋 DESCRIPTION 🦋

okay so here’s the tea: the function calls drm_gem_object_funcs.get_sg_table and then maps the scatterlist. literally those two steps. ✨

it can be used as the dma_buf_ops.map_dma_buf callback. and bestie, it should be used together with drm_gem_unmap_dma_buf — no cap, they’re meant to be a pair. 🫶

⭐ RETURN ⭐

returns an sg_table containing the scatterlist to be returned; returns ERR_PTR on error. it may return -EINTR if it is interrupted by a signal. 😭 that’s the full return tea, fr fr.

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/drm_prime.c overview and lifetime rules(9)
• drm_gem_dmabuf_export(9)
• drm_gem_dmabuf_release(9)
• drm_gem_prime_fd_to_handle(9)
• drm_gem_prime_handle_to_dmabuf(9)
• drm_gem_prime_handle_to_fd(9)
• PRIME Helpers(9)
• drm_gem_map_attach(9)
• drm_gem_map_detach(9)
• drm_gem_unmap_dma_buf(9)
• drm_gem_dmabuf_vmap(9)
• drm_gem_dmabuf_vunmap(9)
• drm_gem_prime_mmap(9)
• drm_gem_dmabuf_mmap(9)
• drm_prime_pages_to_sg(9)
• drm_prime_get_contiguous_size(9)
• drm_gem_prime_export(9)
• drm_gem_is_prime_exported_dma_buf(9)
• drm_gem_prime_import_dev(9)
• drm_gem_prime_import(9)
• drm_prime_sg_to_page_array(9)
• drm_prime_sg_to_dma_addr_array(9)
• drm_prime_gem_destroy(9)

that’s it, bestie — source/version: ./drivers/gpu/drm, date: October 2026. slay 💖