xe_bo_alloc(9)

🎀 NAME 🎀

okay bestie, this is xe_bo_alloc(9) from the Kernel API Manual, and it has one very specific job: allocate storage for a struct xe_bo. That’s the whole name vibe. 💅

✨ SYNOPSIS ✨

struct xe_bo * xe_bo_alloc (void );

🌸 ARGUMENTS 🌸

• void — no arguments. literally none. empty pockets, zero receipts. 🫶

💖 DESCRIPTION 💖

So here’s the tea: this function is intended to allocate storage to be used for input to __xe_bo_create_locked, in the case a pointer to the bo to be created is needed before the call to __xe_bo_create_locked.

And if __xe_bo_create_locked ends up never to be called? Then the storage allocated with this function needs to be freed using xe_bo_free. Not optional, bestie — that’s the cleanup arc, fr fr. 🧚

🔥 RETURN 🔥

• On success, you get a pointer to an uninitialized struct xe_bo. 🫶
• On error, you get ERR_PTR(-ENOMEM). 💀

🦋 SEE ALSO 🦋

Kernel file ./drivers/gpu/drm/xe/xe_bo.c — and here’s the whole friend group, no cap:

• 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_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)

mwah 💋 that’s the page, bestie. source/version: ./drivers/gpu/drm/xe; date: October 2026; manual: xe_bo_alloc(9). periodt. 🌈