xe_ggtt_shift_nodes(9)

💅 xe_ggtt_shift_nodes(9) — a Kernel API Manual moment 🌸

okay bestie, buckle up, this one is from the Kernel API Manual (yes, the whole manual, we're fancy now 👑) and it's genuinely such a neat little function. it's called xe_ggtt_shift_nodes, and the vibes are: the address space moved, so everybody scooch over. 🦋

---

✨ NAME ✨

xe_ggtt_shift_nodes — shift GGTT nodes so they line up with a change in the usable address range. like musical chairs but for memory mappings, no cap 💅

---

🌈 SYNOPSIS 🌈

void xe_ggtt_shift_nodes (struct xe_ggtt *ggtt , u64 new_start );

it takes a struct xe_ggtt * and a u64, and it returns void. nothing back, it just does the thing. main character energy fr fr ✨

---

🎀 ARGUMENTS 🎀

• ggtt — the xe_ggtt struct instance. this is your girl, the actual GGTT object you're operating on 🫶
• new_start — the new location of the area provisioned for the current VF. so like, where the whole party is relocating to 📦

---

💖 DESCRIPTION 💖

so here's the tea: this function makes sure that all the struct xe_ggtt_nodes get moved to the new_start base address — and it does that by changing the base offset of the GGTT itself. no dragging each node around by hand, we just change the base and everyone follows. iconic behavior honestly 💅

this function may be called multiple times during recovery, which sounds stressful but it's fine — because if new_start is unchanged from the current base, it's a noop. literally nothing happens. a little nap. zero effort. we love a function that knows when to chill 😴

🚨 heads up bestie: new_start should be a value between xe_wopcm_size and #GUC_GGTT_TOP. that's the valid window, don't go outside it, okay? 🙈

---

🦋 SEE ALSO 🦋

okay this part is a whole friend group, I'm obsessed. here's literally everyone:

• 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_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_insert_bo(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)

like, the whole squad showed up to the group chat. iykyk 🧚

---

kk that's the whole page bestie 💜 this little gem lives over in ./drivers/gpu/drm/xe and the manual's date stamp says October 2026 — so she's fresh, she's current, she slayed. go shift some nodes. periodt. 💅✨🎀