xe_bo_create_pin_range_novm(9)

📦 version 7.3.1, in nixpkgs unstable

👑 xe_bo_create_pin_range_novm(9) — Kernel API Manual 👑

okay so bestie, welcome to the Kernel API Manual page for xe_bo_create_pin_range_novm(9). This is where we create and pin a BO with range options, and it's giving very specific kernel energy. No cap, the signature is a whole little squad of types, so let's get into it. 💖

🌸 NAME 🌸

xe_bo_create_pin_range_novm — create and pin a BO with range options. Periodt. 🎀

✨ SYNOPSIS ✨

The whole signature, exactly as it appears, because we do not mess with code in this house:

struct xe_bo * xe_bo_create_pin_range_novm (struct xe_device *xe ,
struct xe_tile *tile , size_t size , u64 start , u64 end , enum
ttm_bo_type type , u32 flags );

💅 ARGUMENTS 💅

  • xe — the xe device. That's the main character of this call. ✨
  • tile — the tile to select for migration of this bo, and the tile used for GGTT binding if any. Only to be non-NULL for ttm_bo_type_kernel bos. iykyk.
  • size — the storage size to use for the bo. Like, how much room are we booking? simple as that.
  • start — start of fixed VRAM range or 0.
  • end — end of fixed VRAM range or ~0ULL.
  • type — the TTM buffer object type. Gotta know what kind of BO we're creating. fr fr.
  • flags — XE_BO_FLAG_ flags. Yes, those flags. 💅

🦋 DESCRIPTION 🦋

Create an Xe BO with range- and options. That's the whole vibe.

⚠️ If start and end indicate a fixed VRAM range, this must be a ttm_bo_type_kernel bo with VRAM placement only. No cap, that part is a hard requirement.

🎀 RETURN 🎀

On success, you get the buffer object. On failure, you get a negative error pointer. Slay when it works, sigh when it doesn't. 😭

🔥 SEE ALSO 🔥

Kernel file ./drivers/gpu/drm/xe/xe_bo.c is the home base, and the whole friend group is here:

Mwah 💋 This page comes from ./drivers/gpu/drm/xe — that's the source/version line, bestie — and it's dated October 2026. It's the xe_bo_create_pin_range_novm(9) manual page, and we are so done here. Bye bestie! 🎀🫶

📦 where this page comes from