amdgpu_vm_pt_free_root(9)

📦 version 7.3.1, in nixpkgs unstable

💅 amdgpu_vm_pt_free_root(9)

okay so bestie, welcome to the Kernel API Manual entry for amdgpu_vm_pt_free_root(9) — yes that's the whole title, yes it's a mouthful, no we're not shortening it. this is the page that tells you how to free a root PD. let's get into it ✨

✨ NAME ✨

amdgpu_vm_pt_free_root — free root PD 🎀

like, the actual function name and its whole personality in three words. short, sweet, and slightly ominous.

🦋 SYNOPSIS 🦋

void amdgpu_vm_pt_free_root (struct amdgpu_device *adev , struct
amdgpu_vm *vm );

that's it, that's the whole signature. returns void, so no little return value to check, no "did it work" moment — it just does the thing. 🫶

🌸 ARGUMENTS 🌸

two arguments, both shiny, both required, no defaults, no vibes-based guessing:

  • adev — the amdgpu device structure. your device, your icon. the main character of the hardware world 👑
  • vm — the amdgpu vm structure. the VM in question, living its best life until you call this on it 💜

🔥 DESCRIPTION 🔥

here's the tea: this frees the root page directory and everything below it.

not me emphasizing "everything below it" — but yeah, that's the important bit. the root PD goes, and the whole tree hanging off it goes with it. one call, whole subtree, gone. it's giving cleanup with commitment 💅

treat this as a real teardown, bestie. it's not a "free just the top one and see what happens" situation — the root page directory and everything descending from it all get freed. so make sure nothing else is still holding on to that stuff, fr fr 😭

⭐ SEE ALSO ⭐

the whole friend group, and yes i'm listing every single one because they're all iconic and we don't do partial credit here:

all of these are your study buddies for this corner of the AMDGPU VM code. do not skip them, they will show up on the vibe check 🌈

that's the whole page, bestie, you ate it 🍓 this legend came from ./drivers/gpu/drm/amd/amdgpu and it's dated October 2026 — periodt 💖🧚

📦 where this page comes from