xe_bo_evict_pinned(9)
π xe_bo_evict_pinned(9) β the Kernel API Manual, bestie edition π
okay so real talk, this is a page from the Kernel API Manual (yes, the xe_bo_evict_pinned(9) one, iykyk) and it's honestly iconic. it's a little function with one job and it does it. let's get into it β¨
πΈ NAME πΈ
xe_bo_evict_pinned β evict a pinned VRAM object to system memory, no cap π«Ά
β¨ SYNOPSIS β¨
int xe_bo_evict_pinned (struct xe_bo *bo );
that's it. that's the whole signature. slay π
π¦ ARGUMENTS π¦
boβ the buffer object to move. literally just the bo that's getting relocated, that's the whole vibe π
π DESCRIPTION π
so when this call finishes successfully, the object's memory has been moved over to system memory. periodt. π
and why do we even need this? because pinned VRAM objects need special handling during suspend-resume π₯ like, they get their own little moment, and this function is it. main character energy fr fr.
π RETURN π
0on success π- a negative error code on failure π
π SEE ALSO π
ngl, this is the part where the whole friend group shows up π
β the kernel file is ./drivers/gpu/drm/xe/xe_bo.c and here's every single one of its besties:
xe_bo_has_single_placement(9)xe_bo_is_stolen_devmem(9)xe_bo_is_vm_bound(9)xe_bo_pin_account(9)xe_bo_unpin_account(9)xe_bo_is_visible_vram(9)xe_bo_move_notify(9)xe_bo_set_purgeable_shrinker(9)xe_bo_set_purgeable_state(9)xe_ttm_bo_purge(9)xe_bo_shrink(9)xe_bo_notifier_prepare_pinned(9)xe_bo_notifier_unprepare_pinned(9)xe_bo_restore_pinned(9)xe_bo_read(9)xe_bo_alloc(9)xe_bo_free(9)xe_bo_init_locked(9)xe_bo_create_locked(9)xe_bo_create_user(9)xe_bo_create_pin_range_novm(9)xe_bo_create_pin_map_at_novm(9)xe_bo_create_pin_map(9)xe_bo_create_pin_map_novm(9)xe_managed_bo_reinit_in_vram(9)xe_bo_pin_external(9)xe_bo_pin(9)xe_bo_unpin_external(9)xe_bo_validate(9)xe_bo_decompress(9)xe_bo_lock(9)xe_bo_unlock(9)xe_bo_can_migrate(9)xe_bo_migrate(9)xe_bo_evict(9)xe_bo_needs_ccs_pages(9)__xe_bo_release_dummy(9)xe_bo_put_commit(9)xe_bo_dev_init(9)xe_bo_dev_fini(9)xe_bo_dumb_create(9)
π gentle reminder bestie: read the whole list, there's like forty of them and every single one matters. don't skip. π«Ά
okay that's the page!! this one came from ./drivers/gpu/drm/xe, dated October 2026, and it's filed under xe_bo_evict_pinned(9) obvi. go forth and evict those pinned VRAM objects responsibly β¨πππ¦
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms