xe_bo_unpin_external(9)

💅 xe_bo_unpin_external(9) 💅

okay so this page is from the Kernel API Manual, and it’s lowkey a bop: xe_bo_unpin_external(9) is the call that unpins an external BO. periodt.

✨ NAME ✨

xe_bo_unpin_external — unpin an external BO.

🦋 SYNOPSIS 🦋

void xe_bo_unpin_external (struct xe_bo *bo );

that’s the whole signature, no cap.

🎀 ARGUMENTS 🎀

• bo — buffer object to be unpinned. the main character, fr fr.

🔥 DESCRIPTION 🔥

This unpins an external BO — meaning not tied to a VM and can be exported via dma-buf / prime FD. it’s giving external-BO energy, ngl.

Compared to xe_bo_unpin, this is a unique call: it has its own set of asserts and code to ensure evict / restore on suspend / resume. iykyk — that’s the special sauce.

The return deets: 0 for success, negative error code otherwise. slay.

🌈 SEE ALSO 🌈

Kernel file: ./drivers/gpu/drm/xe/xe_bo.c — plus the whole icon crew: 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_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_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).

Signing off from source/version ./drivers/gpu/drm/xe, dated October 2026 — stay iconic, bestie 💖✨💅