xe_bo_pin_account(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_bo_pin_account(9)

okay so bestie, welcome to the Kernel API Manual, section 9 — yes we're in the kernel docs, yes it's giving big-brain energy, and yes this page is literally just one function but she ate 💖

✨ NAME ✨

xe_bo_pin_account — pin a bo and account its pages for the shrinker 🎀

✨ SYNOPSIS ✨

void xe_bo_pin_account (struct xe_bo *bo );

✨ ARGUMENTS ✨

  • bo — the buffer object we're pinning. that's her. the main character. 👑

✨ DESCRIPTION ✨

so what this does: it pins bo via ttm_bo_pin, and then it updates the shrinker's shrinkable / purgeable page accounting so the numbers actually match reality. slay, no cap, the accounting stays honest 📊✨

⚠️ important bestie: this must be called with bo's dma-resv held. that's not optional, that's not a suggestion, that's the rules fr fr 🫶

and the good news? it's safe to call regardless of which pin path (kernel, external, framebuffer, backup object, …) is the one pinning bo. so whichever friend group did the pinning, you can still run this. iconic behaviour honestly 💅

✨ SEE ALSO ✨

okay this list is LONG, grab a snack 🍓 she's in the kernel file ./drivers/gpu/drm/xe/xe_bo.c and here's everybody she hangs out with:

and that's the whole vibe check 🦋💜 this page lives in ./drivers/gpu/drm/xe, dated October 2026 — mwah, go pin some bos responsibly, ily, bye bestie 💅✨🎀

📦 where this page comes from