xe_bo_restore_pinned(9)
π xe_bo_restore_pinned β bestie edition π
okay so you're looking at xe_bo_restore_pinned(9) from the Kernel API Manual, and honestly? she's a lil function with one job and she does it. let's get into it π«Ά
β¨ NAME β¨
xe_bo_restore_pinned β the girlypop that restores a pinned VRAM object π
β¨ SYNOPSIS β¨
int xe_bo_restore_pinned (struct xe_bo *bo );
that's it. that's the whole signature. no cap. π
β¨ ARGUMENTS β¨
boβ the buffer object we're moving. that's the vibe, she's the main character here π
β¨ DESCRIPTION β¨
so like, on successful completion, the object memory will be moved back to VRAM. literally just moved back. slay. β¨
and why do we even need this? because there's special handling for pinned VRAM objects during suspend-resume, and this is the little function that handles it. it's giving "i'm the responsible one in the group chat" energy fr fr π§
β¨ RETURN β¨
0on success ππ- a negative error code on failure ππ
β¨ SEE ALSO β¨
okay bestie, buckle up, this list is LONG and honestly it ate π
kernel file ./drivers/gpu/drm/xe/xe_bo.c plus:
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_evict_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)
like i said. she ate and left no crumbs ππ
ngl this one's a small page but the see-also is basically a whole friend group π don't skip it, iykyk.
and that's the whole page, bestie! π¦ this lil cutie lives in ./drivers/gpu/drm/xe, it's Kernel API Manual business, dated October 2026, and the header says xe_bo_restore_pinned(9) β periodt. ππ
π¦ 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