amdgpu_bo_unref(9)
π amdgpu_bo_unref β bestie's guide to letting go
okay so this is a page from the Kernel API Manual, and honestly it's a short one but it's iconic in its own little way. we're talking about amdgpu_bo_unref(9) β the "say bye to your buffer object" function. let's get into it β¨
πΈ NAME πΈ
amdgpu_bo_unref β unreference an &amdgpu_bo buffer object π
like, you're dropping the reference. that's the whole vibe. no cap.
π¦ SYNOPSIS π¦
void amdgpu_bo_unref (struct amdgpu_bo **bo );
it returns void, iykyk β nothing comes back, we love a function with no drama. and note that double star on bo, bestie, it's a pointer to a pointer π
π ARGUMENTS π
boβ theamdgpu_bobuffer object. that's it. that's the argument. go off π
π DESCRIPTION π
okay so here's what actually goes down: amdgpu_bo_unref unreferences the contained ttm_buffer_object and clears the pointer. so it's doing two things β dropping the ref on the ttm_buffer_object it contains, and then clearing out the pointer. tidy, clean, main character energy. π§Ήβ¨
fr fr, the description is literally two concepts: unreference the contained ttm_buffer_object, and clear the pointer. simple. slay.
π₯ SEE ALSO π₯
the kernel file lives at ./drivers/gpu/drm/amd/amdgpu/amdgpu_object.c β that's where the magic happens, go read it if you're feeling brave π
and here's the whole friend group, all the siblings and cousins, no gatekeeping:
amdgpu_object(9)amdgpu_bo_is_amdgpu_bo(9)amdgpu_bo_placement_from_domain(9)amdgpu_bo_create_reserved(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_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)
look at that list. 36 entries. we're not skipping a single one, that's not the vibe π
quick reminder bestie:amdgpu_bo_unrefis the un-ref one β if you're looking for the opposite direction, that'samdgpu_bo_ref(9)up there in the see-also. don't mix them up, I'm begging π«Ά
and that's the page!! π this gem comes from ./drivers/gpu/drm/amd/amdgpu, dated October 2026. short little manpage, big slay energy. mwah πβ¨
π¦ where this page comes from
- nixpkgs unstable: linux-manual 7.3.1
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms