amdgpu_bo_create_reserved(9)

💅 amdgpu_bo_create_reserved(9) — like, the whole glow-up

okay so bestie, welcome to the Kernel API Manual, section 9, where we talk about amdgpu_bo_create_reserved. it's giving "kernel-internal buffer object, but make it reserved." no cap, this one's a baddie ✨

---

🌸 NAME 🌸

amdgpu_bo_create_reserved — create a reserved BO for kernel use 🎀

---

✨ SYNOPSIS ✨

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

like, that's the whole signature. she's long but she's iconic 💅

---

🫶 ARGUMENTS 🫶

• adev — the amdgpu device object. the main character, honestly 👑
• size — how big your new BO should be 🍓
• align — the alignment for the new BO. yes it matters, don't skip it 🙈
• domain — where to place it. location, location, location 🦋
• bo_ptr — used to initialize BOs in structures 🔥
• gpu_addr — the GPU addr of the pinned BO. pinned = she's staying put ⭐
• cpu_addr — optional CPU address mapping. optional bestie, key word optional 💜

---

🧚 DESCRIPTION 🧚

so what does she actually do? she allocates and pins a BO for kernel internal use, then hands it back to you still reserved. that's the whole vibe. allocated, pinned, reserved, done. periodt 💀

---

💀 NOTE 💀

real talk for a sec: for bo_ptr, the new BO is only created if bo_ptr points to NULL. like, if it's not NULL, nothing gets made. iykyk 🙈

---

🌈 RETURN 🌈

• 0 on success 🎉
• a negative error code otherwise 😭 (she said "no" and she meant it)

---

🔥 SEE ALSO 🔥

kernel file ./drivers/gpu/drm/amd/amdgpu/amdgpu_object.c 💖

and the whole friend group, fr fr:

amdgpu_object(9), amdgpu_bo_is_amdgpu_bo(9), amdgpu_bo_placement_from_domain(9), amdgpu_bo_create_kernel(9), amdgpu_bo_create_isp_user(9), amdgpu_bo_create_kernel_at(9), amdgpu_bo_free_kernel(9), amdgpu_bo_free_isp_user(9), amdgpu_bo_create(9), amdgpu_bo_create_user(9), amdgpu_bo_create_vm(9), amdgpu_bo_kmap(9), amdgpu_bo_kptr(9), amdgpu_bo_kunmap(9), amdgpu_bo_ref(9), amdgpu_bo_unref(9), amdgpu_bo_pin(9), amdgpu_bo_unpin(9), amdgpu_bo_init(9), amdgpu_bo_fini(9), amdgpu_bo_set_tiling_flags(9), amdgpu_bo_get_tiling_flags(9), amdgpu_bo_set_metadata(9), amdgpu_bo_get_metadata(9), amdgpu_bo_move_notify(9), amdgpu_bo_release_notify(9), amdgpu_bo_fault_reserve_notify(9), amdgpu_bo_fence(9), amdgpu_bo_sync_wait_resv(9), amdgpu_bo_sync_wait(9), amdgpu_bo_gpu_offset(9), amdgpu_bo_fb_aper_addr(9), amdgpu_bo_gpu_offset_no_check(9), amdgpu_bo_mem_stats_placement(9), amdgpu_bo_get_preferred_domain(9), amdgpu_bo_print_info(9)

---

okay that's the whole page!! 🎀 she lives in ./drivers/gpu/drm/amd/amdgpu, she's dated October 2026, and she's serving Kernel API Manual energy from the amdgpu_bo_create_reserved(9) page. mwah 💋✨