kvm_pgtable_get_leaf(9)

✨ kvm_pgtable_get_leaf(9) ✨

okay bestie, this page is from the Kernel API Manual, and it's literally about walking a page-table and grabbing the leaf entry plus its level. no cap, it's giving "tiny but important" energy 🫶💅

🌸 NAME 🌸

kvm_pgtable_get_leaf — walk a page-table and retrieve the leaf entry with its level. periodt. ✨

🦋 SYNOPSIS 🦋

int kvm_pgtable_get_leaf (struct kvm_pgtable *pgt , u64 addr , kvm_pte_t *ptep , s8 *level );

🎀 ARGUMENTS 🎀

• pgt — the page-table structure, already initialised by kvm_pgtable_*_init or a similar initialiser. 💖
• addr — the input address for the start of the walk. 📍
• ptep — pointer to storage for the retrieved PTE. 🎀
• level — pointer to storage for the level of the retrieved PTE. 🌟

🔥 DESCRIPTION 🔥

The offset of addr within a page is ignored. literally, that part doesn't matter here, bestie. 🙈

The walker will walk the page-table entries corresponding to the input address specified, retrieving the leaf corresponding to this address. Invalid entries are treated as leaf entries. yes, invalid entries count as leaf entries — that's the vibe check 💀✨

👑 RETURN 👑

0 on success, negative error code on failure. that's it, that's the whole return situation 🫶

🌈 SEE ALSO 🌈

Kernel file ./arch/arm64/include/asm/kvm_pgtable.h is the main-character spot. then we've got the whole friend group:

• 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_walk(9)
• kvm_pgtable_stage2_pte_prot(9)
• kvm_pgtable_hyp_pte_prot(9)
• kvm_tlb_flush_vmid_range(9)

okay that's the whole page, bestie 💖 this one comes from the ./arch/arm64/include/asm source/version and is dated October 2026, with the manual page being kvm_pgtable_get_leaf(9). mwah 💅✨