xe_pt_stage_bind(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_pt_stage_bind — a Kernel API Manual moment 🎀

okay so bestie, welcome to the xe_pt_stage_bind(9) page from the Kernel API Manual, and honestly? it's giving "let me build you a whole tree" and I'm obsessed. sit down, grab a strawberry 🍓, we're doing page tables.

✨ NAME ✨

xe_pt_stage_bind — literally builds a disconnected page-table tree for a given address range. that's it, that's the whole vibe 🦋

🌈 SYNOPSIS 🌈

int xe_pt_stage_bind (struct xe_tile *tile , struct xe_vma *vma , struct
xe_svm_range *range , struct xe_vm_pgtable_update *entries , u32
*num_entries , bool clear_pt );

like, look at that signature. it ate. no cap 💅

🫶 ARGUMENTS 🫶

  • tile — the tile we're building for. it's the main character here 👑
  • vma — the vma, aka the thing indicating the address range.
  • range — the range, aka the other thing indicating the address range. yes both. iykyk.
  • entries — storage for the update entries, which are used for connecting the tree to the main tree at commit time. lowkey the most important lil container ever 🎀
  • num_entries — on output, this contains the number of entries used. so it goes in empty-ish and comes out with ✨knowledge✨
  • clear_pt — clear the page table entries. that's the whole job, fr fr.

💖 DESCRIPTION 💖

so here's the tea, bestie 🫖 — this function builds a disconnected page-table tree for a given address range. a whole separate tree! floating on its own! main character energy, but disconnected.

then it gets connected to the main vm tree:

  • for the gpu using xe_migrate_update_pgtables
  • for the cpu using xe_pt_commit_bind

and the way it works internally is honestly so cool 😭 — the function builds xe_vm_pgtable_update structures for already existing shared page-tables, and the non-existing shared and non-shared page-tables are built and populated directly. like, no middleman. iconic.

💀 return 0 on success, and a negative error code on error. that's the deal, periodt.

🧚 SEE ALSO 🧚

the whole friend group is listed here and they're all slaying in the kernel file ./drivers/gpu/drm/xe/xe_pt.c:

like, go read them. they're right there. i'm not gonna gatekeep 📚✨

and that's a wrap, bestie!! this whole page lives its best life under ./drivers/gpu/drm/xe, and it was dated October 2026 — yes, the future. we're ahead of the curve 💅🦋 mwah, go build some page tables, you've got this 🫶🎀

📦 where this page comes from