xe_ggtt_read_pte(9)

👑 xe_ggtt_read_pte — a Kernel API Manual moment (section 9, bestie)

okay so we're in the kernel API manual, section 9, and today's main character is xe_ggtt_read_pte. she reads a PTE out of the GGTT. that's it. that's the whole vibe. and honestly? iconic. 💅

---

✨ NAME ✨

xe_ggtt_read_pte — literally just reads a PTE from the GGTT, no cap 🎀

---

🦋 SYNOPSIS 🦋

u64 xe_ggtt_read_pte (struct xe_ggtt *ggtt , u64 offset );

that's her signature. u64 in, u64 out, one struct xe_ggtt *, one u64 offset. copy it exactly, don't freestyle it, i'm begging 🫶

---

🌸 ARGUMENTS 🌸

• ggtt — the xe_ggtt in question. yes, the struct. the whole point. ✨
• offset — the offset you wanna read the mapping for. like, which one. be specific. 💖

---

🔥 DESCRIPTION 🔥

so the way that this works is: it reads a PTE from the GGTT. that's the whole job, and she does it flawlessly.

who's using it? two whole situations, and they're both valid:

• testcases — the testing girlies. they need to peek at a PTE and this is the function for it. 🧪
• display — reading out an inherited bios FB. yep, inheriting an FB from the bios and needing to actually see what's in there. display said "i'll take it from here" and here we are. 🖥️

ngl this is a short one — but short and correct ate, and that's on periodt. don't add behaviour that isn't here, i'm watching 👀

---

⭐ SEE ALSO ⭐

the whole friend group, and yes you need to know all of them, i don't make the rules 💜

• the kernel file ./drivers/gpu/drm/xe/xe_ggtt.c — where she lives 🏠
• 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_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_node_addr(9)
• xe_ggtt_node_size(9)

---

💀 reminder bestie: this page is from ./drivers/gpu/drm/xe, dated October 2026, and it's xe_ggtt_read_pte(9) — that's the source, the date, and the page name all in one cute little sign-off. screenshot it, memorize it, slay. 🌈🎀✨