amdgpu_bo_create_kernel(9)

📦 version 7.3.1, in nixpkgs unstable

💅 amdgpu_bo_create_kernel(9)

okay so bestie, welcome to the Kernel API Manual ✨ this one's all about amdgpu_bo_create_kernel — the little helper that makes a buffer object for kernel-side use. let's get into it 🫶

🌸 NAME 🌸

amdgpu_bo_create_kernel — create BO for kernel use 👑

✨ SYNOPSIS ✨

int amdgpu_bo_create_kernel (struct amdgpu_device *adev , unsigned long
size , int align , u32 domain , struct amdgpu_bo **bo_ptr , u64
*gpu_addr , void **cpu_addr );

like, yes, that's a lot of parameters. she's high-maintenance but she delivers 💅

🎀 ARGUMENTS 🎀

  • adev — the amdgpu device object, aka the main character 🧚
  • size — how big the new BO is gonna be
  • align — the alignment for the new BO (she likes things lined up)
  • domain — where to place it 🌈
  • bo_ptr — used to initialize BOs in structures
  • gpu_addr — the GPU addr of the pinned BO
  • cpu_addr — optional CPU address mapping (optional!! key word!! 🙈)

🦋 DESCRIPTION 🦋

so basically this function allocates and pins a BO for kernel internal use. allocates and pins. both. she does it all 💖

and here's the slay part: this function is exported so that the V4L2 isp device — which lives external to the drm device — can create and access the kernel BO. it's giving "open door policy" ✨ iykyk

⭐ NOTE ⭐

okay listen up because this is important fr fr: for bo_ptr, a new BO is only created if bo_ptr points to NULL. that's the vibe check. don't come for her if you passed something else 🔥

🍓 RETURN 🍓

  • 0 on success 🎉
  • negative error code otherwise 😭

periodt.

💜 SEE ALSO 💜

the kernel file lives right here: ./drivers/gpu/drm/amd/amdgpu/amdgpu_object.c 👑

and the whole friend group:

and that's the whole page bestie 💅✨ this one came out of ./drivers/gpu/drm/amd/amdgpu, dated October 2026 — go off, kernel docs, you ate 🎀🦋💖

📦 where this page comes from