xe_bo_notif...epare_pinned(9)
π xe_bo_notifier_prepare_pinned β Kernel API Manual π
okay so bestie, welcome to the Kernel API Manual entry for xe_bo_notifier_prepare_pinned β¨ (the header up top truncates it as xe_bo_notif...epare_pinned(9) which is honestly giving "my name got cut off in the group chat preview" π but we know her full name now).
πΈ NAME πΈ
xe_bo_notifier_prepare_pinned β get a pinned VRAM object ready to be backed up in system memory π«Ά
β¨ SYNOPSIS β¨
int xe_bo_notifier_prepare_pinned (struct xe_bo *bo );
literally one argument, one int, no drama π
π¦ ARGUMENTS π¦
boβ the buffer object we're prepping. that's her. the main character of this function π
π DESCRIPTION π
so here's the vibe: if this call succeeds, the object's backup pages get allocated, periodt β¨ Expectation is that you're calling this from the PM notifier, before suspend/hibernation kicks in π΄ β like packing your bag the night before, not while the car's already pulling out of the driveway ππ¨
π₯ RETURN π₯
0on success π- a negative error code on failure π (no cap, check it)
π SEE ALSO π
the whole friend group, in the kernel file ./drivers/gpu/drm/xe/xe_bo.c:
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_unprepare_pinned(9)xe_bo_evict_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)
and that's the whole thing, bestie β you ate π β¨
this legend lives in ./drivers/gpu/drm/xe, dated October 2026, and yes the page still signs off as xe_bo_notif...epare_pinned(9) because she refuses to change her display name ππ«Ά
π¦ 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