xe_ttm_bo_purge(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_ttm_bo_purge(9) 💅

okay so bestie, welcome to the Kernel API Manual — yes we're reading kernel docs for fun now, this is who we are 🎀

✨ NAME ✨

xe_ttm_bo_purge — Purge buffer object backing store 🧹

🌸 SYNOPSIS 🌸

int xe_ttm_bo_purge (struct ttm_buffer_object *ttm_bo , struct
       ttm_operation_ctx *ctx );

🦋 ARGUMENTS 🦋

  • ttm_bo — The TTM buffer object to purge. this is the one we're cleaning out, bestie 🫧
  • ctx — The TTM operation context. it's giving "the vibe check parameters" ✨

🎀 DESCRIPTION 🎀

okay so here's the tea ☕ — this function purges the backing store of a BO that's been marked as DONTNEED, and then it triggers a rebind to invalidate stale GPU mappings. literally spring cleaning for your buffer object, no cap 🧼

For fault-mode VMs, this zaps the PTEs. gone. deleted. 💀

The next GPU access will trigger a page fault and perform a NULL rebind — and that means scratch pages or clear PTEs based on VM config, iykyk. so it's not broken, it's just the design, periodt 💅

💖 RETURN 💖

  • 0 on success 🌈
  • negative error code on failure 😭

👑 SEE ALSO 👑

the whole squad, fr fr — Kernel file ./drivers/gpu/drm/xe/xe_bo.c plus:

and that's the whole page, bestie! 🌈

this lil masterpiece lives in ./drivers/gpu/drm/xe and it's dated October 2026 — so yeah, we're reading from the future, main character energy fr 💅✨🫶

📦 where this page comes from