xe_bo_create_pin_map_novm(9)

📦 version 7.3.1, in nixpkgs unstable

💅 xe_bo_create_pin_map_novm(9) — a Kernel API Manual moment

okay so bestie, we're in the Kernel API Manual today and this one's a whole function. buckle up, it's giving "create a pinned and mapped bo" and honestly? iconic. ✨

🌸 NAME 🌸

xe_bo_create_pin_map_novm — create a pinned and mapped bo, fr fr

🦋 SYNOPSIS 🦋

struct xe_bo * xe_bo_create_pin_map_novm (struct xe_device *xe , struct
       xe_tile *tile , size_t size , enum ttm_bo_type type , u32 flags , bool
       intr );

🎀 ARGUMENTS 🎀

  • xe — the xe device. that's her. the main character. 👑
  • tile — the tile you pick for migration of this bo, and also the tile used for GGTT binding if there is any. lowkey important: this one is only to be non-NULL for ttm_bo_type_kernel bos. no cap, that's the rule. 🫶
  • size — the storage size to use for the bo. like, how much room she gets. 📏
  • type — the TTM buffer object type. yes that's literally just what the parameter is. 💀
  • flags — XE_BO_FLAG_ flags. the little flag guys. 🚩
  • intr — whether to execute any waits for backing store interruptible. so like, can we get interrupted while waiting? that's the vibe check. 😭

✨ DESCRIPTION ✨

so basically: create a pinned and mapped bo. she is external and not associated with a VM. periodt. that's the whole bit — she's out here living her life unbound to any virtual memory, iykyk. 💅

🔥 RETURN 🔥

on success you get the buffer object back, slay. 🎉 on failure you get a negative error pointer — not a NULL, a whole error pointer, so don't be out here dereferencing it, bestie. 🙈

and in particular? the function may return ERR_PTR(-EINTR) if intr was set to true on entry. so yeah, if you asked for interruptible waits, you might actually get interrupted. makes sense, still stressful. 😭

🌈 SEE ALSO 🌈

okay this list is LONG and I'm obsessed. everything below is (9), go read them if you want the full lore:

anyway that's the whole page, she ate and left no crumbs 🍓

this lil gem lives in ./drivers/gpu/drm/xe and the version stamp is October 2026, and yes the header was xe_bo_create_pin_map_novm(9) the whole time — hope that cleared the vibe check bestie 🧚💜

📦 where this page comes from