amdgpu_vm_pt_first_dfs(9)

okay bestie, welcome to amdgpu_vm_pt_first_dfs(9) — the Kernel API Manual entry for the function that kicks off a deep first search. yes, deep first. we respect the original wording here 💅✨

💖 NAME 💖

amdgpu_vm_pt_first_dfs — start a deep first search. that's the name and the mission, periodt. 🫶

✨ SYNOPSIS ✨

here's the signature, copied exactly so nobody comes for me:

void amdgpu_vm_pt_first_dfs (struct amdgpu_device *adev , struct amdgpu_vm *vm , struct amdgpu_vm_pt_cursor *start , struct amdgpu_vm_pt_cursor *cursor );

it returns void, so there's no return value to obsess over. iconic behavior, honestly 🎀

🎀 ARGUMENTS 🎀

• adev — the amdgpu_device structure. literally right there in the signature, bestie 🦋
• vm — the amdgpu_vm structure. yes, that one 💜
• start — an optional cursor to start with. optional! so don't panic 🌸
• cursor — the state to initialize. it's giving "set me up so the traversal can begin" ✨

🦋 DESCRIPTION 🦋

okay so this function starts a deep first traversal of the PD/PT tree. that's the whole description, and it ate. no cap. the PD/PT tree is the main character here, and this function is the one opening the curtain 🔥👑

🌈 SEE ALSO 🌈

the kernel file is ./drivers/gpu/drm/amd/amdgpu/amdgpu_vm_pt.c, and here's the full see-also friend group — every single one, no skips:

• Kernel file: ./drivers/gpu/drm/amd/amdgpu/amdgpu_vm_pt.c
• amdgpu_vm_pt_level_shift(9)
• amdgpu_vm_pt_num_entries(9)
• amdgpu_vm_pt_entries_mask(9)
• amdgpu_vm_pt_size(9)
• amdgpu_vm_pt_parent(9)
• amdgpu_vm_pt_start(9)
• amdgpu_vm_pt_descendant(9)
• amdgpu_vm_pt_sibling(9)
• amdgpu_vm_pt_ancestor(9)
• amdgpu_vm_pt_next(9)
• amdgpu_vm_pt_continue_dfs(9)
• amdgpu_vm_pt_next_dfs(9)
• amdgpu_vm_pt_clear(9)
• amdgpu_vm_pt_create(9)
• amdgpu_vm_pt_alloc(9)
• amdgpu_vm_pt_free(9)
• amdgpu_vm_pt_free_list(9)
• amdgpu_vm_pt_add_list(9)
• amdgpu_vm_pt_free_root(9)
• amdgpu_vm_pde_update(9)
• amdgpu_vm_pte_update_noretry_flags(9)
• amdgpu_vm_pte_fragment(9)
• amdgpu_vm_ptes_update(9)
• amdgpu_vm_pt_map_tables(9)

signing off from ./drivers/gpu/drm/amd/amdgpu, October 2026, for amdgpu_vm_pt_first_dfs(9) — stay slay, stay curious, and hydrate before you traverse 💜🎀🫶