drm_prime_sg_to_page_array(9)

💖 NAME 💖

okay bestie, welcome to the drm_prime_sg_to_page_array(9) page in the Kernel API Manual ✨ buckle up, we're being technical and cute about it.

drm_prime_sg_to_page_array — convert an sg table into a page array.

---

🦋 SYNOPSIS 🦋

int drm_prime_sg_to_page_array (struct sg_table *sgt , struct page
**pages , int max_entries );

---

🎀 ARGUMENTS 🎀

• sgt — scatter-gather table to convert. yes, the sg table in question 💅
• pages — array of page pointers to store the pages in.
• max_entries — size of the passed-in array.

---

🌸 DESCRIPTION 🌸

Exports an sg table into an array of pages. cute concept, but read the next bit, fr fr.

⚠️ Deprecated alert, bestie: this function is deprecated and strongly discouraged to be used. not a drill 💀

The page array is only useful for page faults, and those can corrupt fields in the struct page if they are not handled by the exporting driver. so like… the vibes are risky, handle with care 😭

---

🔥 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_map_dma_buf(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_dma_addr_array(9)
• drm_prime_gem_destroy(9)

---

peace out from drm_prime_sg_to_page_array(9) 🫶 — source ./drivers/gpu/drm, dated October 2026, in the Kernel API Manual 💅✨