xe_bo_create_locked(9)

📦 version 7.3.1, in nixpkgs unstable

👑 xe_bo_create_locked — from the Kernel API Manual, bestie 💅

okay so this is xe_bo_create_locked(9), and yes it's exactly as iconic as it sounds. dramatic name, locked BO, main character energy. let's get into it ✨

🌸 NAME 🌸

xe_bo_create_locked — literally just Create a BO. that's the whole pitch. no notes. periodt.

🎀 SYNOPSIS 🎀

struct xe_bo * xe_bo_create_locked (struct xe_device *xe , struct
       xe_tile *tile , struct xe_vm *vm , size_t size , enum ttm_bo_type type ,
       u32 flags , struct drm_exec *exec );

the way that signature goes on for a whole three lines 😭 she's got range.

🦋 ARGUMENTS 🦋

  • xe — The xe device. your fave. the whole reason we're here 🫶
  • tile — The tile to select for migration of this bo, and the tile used for GGTT binding if any. Important: only to be non-NULL for ttm_bo_type_kernel bos — so like, don't just hand it anything, iykyk.
  • vm — The local vm, or NULL for external objects. she's flexible like that.
  • size — The storage size to use for the bo. how much space she's serving.
  • type — The TTM buffer object type. classic.
  • flags — XE_BO_FLAG_ flags. slay, options.
  • exec — The drm_exec transaction to use for exhaustive eviction. she's thorough, we respect it.

💖 DESCRIPTION 💖

Create a locked xe BO with no range- nor alignment restrictions. that's it. that's the vibe. no restrictions, no drama, just a locked BO being created. obsessed 🧚

⭐ RETURN ⭐

  • The buffer object on success ✨
  • Negative error pointer on failure 😭

🌈 SEE ALSO 🌈

the Kernel file ./drivers/gpu/drm/xe/xe_bo.c (our source, our blueprint, our ancestor 💜) plus this whole group chat of neighbours — every single one, no skipping, this is a full roster:

fr fr go read at least three of these before you ping me. i'm not being mean, i'm being a good friend 🫶

and that's the page!! sourced straight out of ./drivers/gpu/drm/xe, dated October 2026, filed under xe_bo_create_locked(9) — like a little time capsule from the future, cute right? 🎀 bye bestie, go make some BOs 💅✨

📦 where this page comes from