drm_gem_shmem_get_sg_table(9)

💖 drm_gem_shmem_get_sg_table(9) 💖

okay bestie, this is the Kernel API Manual page for drm_gem_shmem_get_sg_table(9) — and it's giving scatter/gather table for a shmem GEM object. We're gonna go through every detail, no cap. ✨

---

🌸 NAME 🌸

drm_gem_shmem_get_sg_table — provide a scatter/gather table of pinned pages for a shmem GEM object. That's the whole name, bestie. 🎀

---

🦋 SYNOPSIS 🦋

the signature is literally this:

struct sg_table * drm_gem_shmem_get_sg_table (struct
       drm_gem_shmem_object *shmem );

---

🎀 ARGUMENTS 🎀

• shmem — a shmem GEM object. That's the one and only argument, main character energy. 👑

---

🌸 DESCRIPTION 🌸

So what does it do? This function exports a scatter/gather table that's suitable for PRIME usage, and it does that by calling the standard DMA mapping API. Yes bestie, PRIME usage + standard DMA mapping API — that's the vibe. 🔥

But lowkey important: drivers who need to acquire a scatter/gather table for objects need to call drm_gem_shmem_get_pages_sgt instead. Noted, bestie — different function for that job. 💅

---

💅 RETURN 💅

On success, you get a pointer to the scatter/gather table of pinned pages. On failure, you get an error pointer. That's the return vibe check, fr fr. 😭

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/drm_gem_shmem_helper.c and overview(9), plus these iconique entries:

• 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_dumb_create(9)
• drm_gem_shmem_mmap(9)
• drm_gem_shmem_print_info(9)
• drm_gem_shmem_get_pages_sgt(9)
• drm_gem_shmem_prime_import_sg_table(9)
• drm_gem_shmem_prime_import_no_map(9)

---

okay that's the whole page, bestie! The source/version is ./drivers/gpu/drm, the date is October 2026, and the manual is the Kernel API Manual. go off, scatter/gather table icon 💅✨