create_sg_table(9)

✨ create_sg_table(9) ✨

okay bestie, welcome to the Kernel API Manual, section 9 — this one's a lil function that lives in the DRM/AMD world and she's honestly so real for what she does 🎀

---

💖 NAME 💖

create_sg_table — literally makes you an sg_table for a contiguous DMA addr range 🦋

---

🌸 SYNOPSIS 🌸

struct sg_table * create_sg_table (uint64_t addr , uint32_t size );

---

✨ ARGUMENTS ✨

• addr — the starting address you want it to point at, like the main character of this whole operation 👑
• size — how big the memory area is, in bytes, and yes it's exactly the area being pointed to 🍓

---

💅 DESCRIPTION 💅

so what she does is: allocates an instance of sg_table and initializes it so it points to the memory area you specified with the input params, no cap. the address that gets used to build this is assumed to be DMA mapped — if that's needed, that is 🙈

and here's the tea: DOORBELL or MMIO BOs only use one single scatterlist node</> in their sg_table, because they're physically contiguous. one node. iconic behavior, honestly 💀

---

🌈 RETURN 🌈

an initialized instance of the SG Table — or NULL 😭

---

🫶 SEE ALSO 🫶

the kernel file lives right here, bestie: ./drivers/gpu/drm/amd/amdgpu/amdgpu_amdkfd_gpuvm.c

and the whole friend group:

• reuse_dmamap(9)
• amdgpu_amdkfd_reserve_mem_limit(9)
• create_dmamap_sg_bo(9)
• amdgpu_amdkfd_remove_all_eviction_fences(9)
• kfd_mem_dmamap_sg_bo(9)
• kfd_mem_dmaunmap_sg_bo(9)
• reserve_bo_and_vm(9)
• reserve_bo_and_cond_vms(9)
• unreserve_bo_and_vms(9)
• amdgpu_amdkfd_gpuvm_pin_bo(9)
• amdgpu_amdkfd_gpuvm_unpin_bo(9)
• amdgpu_amdkfd_map_gtt_bo_to_gart(9)

---

okay that's the whole page, mwah 💋 — brought to you by ./drivers/gpu/drm/amd/amdgpu, dated October 2026, and yeah she's still create_sg_table(9) through and through. slay, go read the rest of the manpages bestie 🧚‍♀️💜