hyp_alloc_private_va_range(9)

💜 hyp_alloc_private_va_range(9) — from the Kernel API Manual, bestie

okay so picture this: you're deep in arch/arm64/kvm land and you need a private virtual address range for the hypervisor. yes. that's the whole vibe of this page. it's giving "reserve me a lil slice of VA space, please and thank you" ✨

---

🌸 NAME 🌸

hyp_alloc_private_va_range — literally just allocates a private VA range. no cap, that's it.

---

🎀 SYNOPSIS 🎀

int hyp_alloc_private_va_range (size_t size , unsigned long *haddr );

like look at her. two args. so clean. so iconic. 🫶

---

🦋 ARGUMENTS 🦋

• size — the size of the VA range you wanna reserve. that's the whole number, bestie, don't skimp 💅
• haddr — out comes the hypervisor virtual start address of the allocation. this is where you find out where your range actually landed 📍

---

✨ DESCRIPTION ✨

so the private virtual address (VA) range gets allocated below io_map_base, and it's aligned based on the order of size. that's the whole tea 🍓

like, that's genuinely all she does. below io_map_base, aligned by the order of size. periodt. 🔥

ngl, if you're wondering about the exact alignment maths — it's "based on the order of size" and that's what the page says, so that's what you get 💀 no extra lore from me.

---

🌈 RETURN 🌈

• 0 on success 🎉 (we love to see it)
• negative error code on failure 😭 (she tried her best)

---

👑 SEE ALSO 👑

the source of all this wisdom lives in the kernel file ./arch/arm64/kvm/mmu.c — go read her, she ate 💅

and here's the whole friend group, all cross-referenced and everything:

• kvm_arch_flush_remote_tlbs(9)
• __unmap_stage2_range(9)
• stage2_flush_vm(9)
• free_hyp_pgds(9)
• create_hyp_mappings(9)
• create_hyp_io_mappings(9)
• create_hyp_exec_mappings(9)
• kvm_init_stage2_mmu(9)
• stage2_unmap_vm(9)
• kvm_phys_addr_ioremap(9)
• kvm_stage2_wp_range(9)
• kvm_mmu_wp_memory_region(9)
• kvm_mmu_split_memory_region(9)
• kvm_handle_guest_abort(9)

like that's a whole squad. main character energy from every single one tbh 🧚

---

okay mwah, that's a wrap 💖 this lil page came from ./arch/arm64/kvm and she's dated October 2026 — put that in your calendar, bestie, and go reserve yourself a private VA range. slay 🎀✨