amdgpu_amdkf...uvm_unpin_bo(9)

💅 amdgpu_amdkf...uvm_unpin_bo(9)

okay so bestie, welcome to the Kernel API Manual page for amdgpu_amdkf...uvm_unpin_bo(9) — yes the title is literally abbreviated with ellipsis in the header, that's just how the kernel rolls, no cap. this is the unpin function and it's lowkey iconic. let's get into it 🫶

---

✨ NAME ✨

amdgpu_amdkfd_gpuvm_unpin_bo — unpins a BO using the following criteria. that's the whole vibe. it's giving "cleanup era." 🎀

---

🌸 SYNOPSIS 🌸

void amdgpu_amdkfd_gpuvm_unpin_bo (struct amdgpu_bo *bo );

like, it returns nothing (void) and takes exactly one thing. simple. elegant. main character energy. ✨

---

🦋 ARGUMENTS 🦋

• bo — the handle of the buffer object that's getting unpinned. that's it, that's the whole argument. one (1) boy. 💅

---

🔥 DESCRIPTION 🔥

okay so here's the tea, and it's actually important so listen up:

• it is an illegal request for USERPTR BOs, and it just gets ignored. not me showing up to a party i'm not invited to 😭
• every other BO type — that's GTT, VRAM, MMIO and DOORBELL — gets its PIN count decremented. so like, the pin counter goes down by one, periodt.

ngl this next bit matters a lot: calls to UNPIN must balance calls to PIN. every pin needs its unpin, fr fr. keep that ledger clean bestie or the vibes get cursed 💀

---

👑 SEE ALSO 👑

kernel file: ./drivers/gpu/drm/amd/amdgpu/amdgpu_amdkfd_gpuvm.c

and the friend group of related pages, all of them, no skipping:

• reuse_dmamap(9)
• amdgpu_amdkfd_reserve_mem_limit(9)
• create_dmamap_sg_bo(9)
• amdgpu_amdkfd_remove_all_eviction_fences(9)
• create_sg_table(9)
• kfd_mem_dmamap_sg_bo(9)
• kfd_mem_dmaunmap_sg_bo(9)
• reserve_bo_and_vm(9)
• reserve_bo_and_cond_vms(9)
• unreserve_bo_and_vms(9)
• amdgpu_amdkfd_gpuvm_pin_bo(9)
• amdgpu_amdkfd_map_gtt_bo_to_gart(9)

the way that amdgpu_amdkfd_gpuvm_pin_bo(9) is literally right there as the counterpart... obsessed with the symmetry 🌈

---

okay that's the page!! this one lives in ./drivers/gpu/drm/amd/amdgpu and the version date on it is October 2026, straight from the Kernel API Manual. go unpin responsibly, mwah 💖🧚⭐