kvm_pgtable_stage2_split(9)

🎀 kvm_pgtable_stage2_split(9) — a Kernel API Manual moment 🎀

okay bestie, welcome to the Kernel API Manual page for kvm_pgtable_stage2_split. this one is lowkey iconic: it takes big huge-page ranges and tries to split them into little leaf PTEs that point at PAGE_SIZE guest pages. no cap, it’s giving page-table surgery 💅✨

---

🌸 NAME 🌸

kvm_pgtable_stage2_split — Split a range of huge pages into leaf PTEs pointing to PAGE_SIZE guest pages.

---

✨ SYNOPSIS ✨

int kvm_pgtable_stage2_split (struct kvm_pgtable *pgt , u64 addr , u64 size , struct kvm_mmu_memory_cache *mc );

---

🦋 ARGUMENTS 🦋

• pgt — Page-table structure initialised by kvm_pgtable_stage2_init.
• addr — Intermediate physical address from which to split.
• size — Size of the range.
• mc — Cache of pre-allocated and zeroed memory from which to allocate page-table pages.

---

💜 DESCRIPTION 💜

The function tries to split any level 1 or 2 entry that overlaps with the input range (given by addr and size).

like, it’s literally looking at the range you handed it and going “okay bestie, which of these bigger entries can we break down?” 🫶

---

🔥 RETURN 🔥

0 on success, negative error code on failure. Note that kvm_pgtable_stage2_split is best effort: it tries to break as many blocks in the input range as allowed by mc_capacity.

so yeah, it’s not out here promising perfection — it’s best effort, periodt. 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./arch/arm64/include/asm/kvm_pgtable.h 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_walk(9)
• kvm_pgtable_get_leaf(9)
• kvm_pgtable_stage2_pte_prot(9)
• kvm_pgtable_hyp_pte_prot(9)
• kvm_tlb_flush_vmid_range(9)

---

bye bestie 💖 this page is from ./arch/arm64/include/asm, dated October 2026, and the footer name is still kvm_pgtable_stage2_split(9). slay 🎀✨