xe_ggtt_assign(9)

💅 xe_ggtt_assign(9) — the Kernel API Manual, but make it cute ✨

Okay so bestie, we're in the xe_ggtt_assign(9) page from the Kernel API Manual, and honestly? It's short, it's sweet, and it does exactly one (1) thing. Let's get into it 🎀

---

✨ NAME ✨

xe_ggtt_assign — assign a GGTT region to the VF 🫶

---

🌸 SYNOPSIS 🌸

void xe_ggtt_assign (const struct xe_ggtt_node *node , u16 vfid );

Like, that's it. That's the whole signature. No cap. 💖

---

🦋 ARGUMENTS 🦋

• node — the xe_ggtt_node you're updating, aka the main character of this function 💅
• vfid — the VF identifier, i.e. which VF we're handing this region to 👑

---

🔥 DESCRIPTION 🔥

So here's the tea: this function is what the PF driver uses to assign a GGTT region to the VF. Literally its whole job. Obsessed. ✨

And it's not just the PTE's VFID bits 11:2 getting set — the PRESENT bit 0 gets set too, because on some platforms the VFs can't modify that either 😭 like they just don't have the range, so the PF has to do it for them. Periodt. 🧚

---

🌈 SEE ALSO 🌈

• 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_insert_bo(9)
• xe_ggtt_remove_bo(9)
• xe_ggtt_largest_hole(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)

That's a whole friend group right there, iykyk 💜

---

Lowkey the entire page in one breath: PF driver goes in, sets VFID bits 11:2 and PRESENT bit 0 on the PTE, and the VF gets its GGTT region. Slay. 💀

---

Sign-off time, bestie 🎀 — this whole thing lives under ./drivers/gpu/drm/xe, and it's dated October 2026. Catch you in the next manpage, mwah 💋