xe_pt_covers(9)

💅 xe_pt_covers(9) — the kernel API manual, bestie edition

okay so real talk, this is a page from the Kernel API Manual and honestly? it's a little icon and you're gonna get along great. let's go 🎀

---

✨ NAME ✨

xe_pt_covers — tells you whether the address range covers an entire entry at @level 🦋

like, the whole entry. not most of it. not a cute little sliver of it. the whole thing. periodt.

---

🌸 SYNOPSIS 🌸

bool xe_pt_covers (u64 addr , u64 end , unsigned int level , const
struct xe_pt_walk *walk );

it hands you back a bool, no cap. 💖

---

🫶 ARGUMENTS 🫶

• addr — where the range starts. the beginning. the origin story. ⭐
• end — end of range + 1 (yes bestie, plus one, that's the whole bit, don't come for me) 😭
• level — the page table level. which floor of the building we're on. 🏢
• walk — page table walk info. the lore. the context. the receipts. 💅

---

🔥 DESCRIPTION 🔥

so this function is a little helper — a helper bestie, it's giving supportive side character energy — and what it does is help you figure out whether a leaf page table entry can be inserted at this level. 🌈

that's it. that's the whole vibe. it's just here to answer the question so you don't have to. 👑

---

👑 RETURN 👑

it returns whether the range you gave it covers exactly an entry at this level. exactly. not approximately. we do not do approximately here. 💀✨

---

💜 SEE ALSO 💜

• Kernel file ./drivers/gpu/drm/xe/xe_pt_walk.h
• struct xe_ptw(9)
• struct xe_pt_walk(9)
• xe_pt_entry_fn(9)
• struct xe_pt_walk_ops(9)
• xe_pt_num_entries(9)
• xe_pt_offset(9)

go read them, iykyk 🧚🍓

---

ngl if you're poking around page table walks you should fr fr read the whole header file, it's lowkey iconic 🦋

---

okay that's the page!! this masterpiece lives over in ./drivers/gpu/drm/xe and it was dated October 2026 — so yeah, ahead of its time, main character energy, we love to see it 🌸💖 slay, bye! 👋