kvm_pgtable_walk(9)

🦋 NAME 🦋

kvm_pgtable_walk — walk a page-table. That’s the whole name, bestie. And yes, this is the kvm_pgtable_walk(9) page from the Kernel API Manual, so you’re in the right group chat. 🫶 Page-table walker core, main character energy.

✨ SYNOPSIS ✨

int kvm_pgtable_walk (struct kvm_pgtable *pgt , u64 addr , u64 size ,
       struct kvm_pgtable_walker *walker );

🎀 ARGUMENTS 🎀

• pgt — Page-table structure initialised by kvm_pgtable_*_init.
• addr — input address for the start of the walk.
• size — size of the range to walk.
• walker — walker callback description.

💅 DESCRIPTION 💅

First vibe check: the offset of addr within a page is ignored, and size is rounded-up to the next page boundary. No cap. ✨

The walker will walk the page-table entries corresponding to the input address range specified, visiting entries according to the walker flags. Invalid entries are treated as leaf entries. The visited page table entry is reloaded after invoking the walker callback, allowing the walker to descend into a newly installed table. That’s the whole slay. 🦋

Returning a negative error code from the walker callback function will terminate the walk immediately with the same error code. Immediate immediate. 💀 No extra steps, no tiny side quest.

🌈 RETURN 🌈

0 on success, negative error code on failure. Periodt. ✅

👀 SEE ALSO 👀

• Kernel file ./arch/arm64/include/asm/kvm_pgtable.h — go read it, iykyk.
• struct kvm_pgtable_mm_ops(9)
• enum kvm_pgtable_stage2_flags(9)
• enum kvm_pgtable_prot(9)
• enum kvm_pgtable_walk_flags(9)
• struct kvm_pgtable_walker(9)
• struct kvm_pgtable(9)
• kvm_pgtable_hyp_init(9)
• kvm_pgtable_hyp_destroy(9)
• kvm_pgtable_hyp_map(9)
• kvm_pgtable_hyp_unmap(9)
• kvm_get_vtcr(9)
• kvm_pgtable_stage2_pgd_size(9)
• __kvm_pgtable_stage2_init(9)
• kvm_pgtable_stage2_destroy(9)
• kvm_pgtable_stage2_destroy_range(9)
• kvm_pgtable_stage2_destroy_pgd(9)
• kvm_pgtable_stage2_free_unlinked(9)
• kvm_pgtable_stage2_create_unlinked(9)
• kvm_pgtable_stage2_map(9)
• kvm_pgtable_stage2_annotate(9)
• kvm_pgtable_stage2_unmap(9)
• kvm_pgtable_stage2_wrprotect(9)
• kvm_pgtable_stage2_mkyoung(9)
• kvm_pgtable_stage2_test_clear_young(9)
• kvm_pgtable_stage2_relax_perms(9)
• kvm_pgtable_stage2_split(9)
• kvm_pgtable_get_leaf(9)
• kvm_pgtable_stage2_pte_prot(9)
• kvm_pgtable_hyp_pte_prot(9)
• kvm_tlb_flush_vmid_range(9)

okay that’s the page, bestie! source/version: ./arch/arm64/include/asm — date: October 2026. mwah 💋🎀