xe_ggtt_insert_bo(9)

✨ xe_ggtt_insert_bo(9) ✨

okay so bestie, welcome to the xe_ggtt_insert_bo(9) page from the Kernel API Manual — this is the little kernel function that yeets a buffer object into the GGTT, and we're gonna go through it together, no cap 💅

---

🌸 NAME 🌸

xe_ggtt_insert_bo — Insert BO into GGTT 🫶

like, that's literally the whole vibe: BO goes in, GGTT holds it.

---

🎀 SYNOPSIS 🎀

int xe_ggtt_insert_bo (struct xe_ggtt *ggtt , struct xe_bo *bo , struct
drm_exec *exec );

bestie it returns an int, takes three args, and it's giving "small function, big responsibilities" energy fr fr 🌈

---

🌼 ARGUMENTS 🌼

• ggtt — the xe_ggtt where bo will be inserted 👑 this is the destination, the main character of the whole operation
• bo — the xe_bo to be inserted 🎀 that's your buffer object, the thing that's getting placed in there
• exec — The drm_exec transaction to use for exhaustive eviction. 😭 yes, "exhaustive eviction" — it's serious business, the transaction handle is doing heavy lifting here

---

💖 RETURN 💖

0 on success or a negative error code on failure. periodt. ✨

lowkey important: negative error code means something went wrong — don't just check for nonzero and vibe out, check the sign 😤

---

🦋 SEE ALSO 🦋

the whole friend group showed up, ngl, so here's the full squad list 💜

• Kernel file ./drivers/gpu/drm/xe/xe_ggtt.c Global Graphics Translation Table (GGTT)(9)
• struct xe_ggtt_node(9)
• struct xe_ggtt_pt_ops(9)
• struct xe_ggtt(9)
• xe_ggtt_start(9)
• xe_ggtt_size(9)
• xe_ggtt_alloc(9)
• xe_ggtt_init_early(9)
• xe_ggtt_node_remove(9)
• xe_ggtt_init(9)
• xe_ggtt_shift_nodes(9)
• xe_ggtt_insert_node(9)
• xe_ggtt_node_pt_size(9)
• xe_ggtt_map_bo(9)
• xe_ggtt_map_bo_unlocked(9)
• xe_ggtt_insert_node_transform(9)
• xe_ggtt_insert_bo_at(9)
• xe_ggtt_remove_bo(9)
• xe_ggtt_largest_hole(9)
• xe_ggtt_assign(9)
• xe_ggtt_node_save(9)
• xe_ggtt_node_load(9)
• xe_ggtt_dump(9)
• xe_ggtt_print_holes(9)
• xe_ggtt_encode_pte_flags(9)
• xe_ggtt_read_pte(9)
• xe_ggtt_node_addr(9)
• xe_ggtt_node_size(9)

---

and that's the page!! go insert some BOs, bestie 💅✨

this little masterpiece lives in ./drivers/gpu/drm/xe, it's dated October 2026, and it's still signed xe_ggtt_insert_bo(9) at the bottom — iconic, honestly 🎀🫶