kho_restore_free(9)

💜 kho_restore_free(9) 💜

okay bestie, welcome to the kho_restore_free(9) page — it lives in the Kernel API Manual, and honestly? it's a lil post-kexec glow-up moment ✨

🫶 NAME 🫶

kho_restore_free — bestie's job is literally restore and free memory after kexec, no cap 💅

---

🌸 SYNOPSIS 🌸

void kho_restore_free (void *mem );

🎀 ARGUMENTS 🎀

• mem — a pointer to the memory (living in the new kernel's address space, iykyk) that was allocated by the old kernel. like, the old one did the allocating, you're just here to claim it 💖

---

✨ DESCRIPTION ✨

so this function is the one you call in the new kernel (yes, post-kexec, exactly) to take ownership of a memory region — and then free it — where that region was preserved by the old kernel using kho_alloc_preserve. it's giving handoff. it's giving main character energy 🔥

here's the tea on what it actually does, in order:

1. it first restores the pages from KHO (using their physical address — that part matters 🫶)
2. then it frees the pages back to the new kernel's page allocator

that's it. restore, then free. two steps, both iconic, periodt 👑

---

🦋 SEE ALSO 🦋

• Kernel file ./kernel/liveupdate/kexec_handover.c
• kho_encode_radix_key(9), kho_decode_radix_key(9), kho_radix_add_key(9), kho_radix_del_key(9), kho_radix_init_tree(9), kho_radix_destroy_tree(9), kho_radix_walk_tree(9), kho_restore_folio(9), kho_restore_pages(9), kho_reserve_scratch(9), kho_add_subtree(9), kho_preserve_folio(9), kho_unpreserve_folio(9), kho_preserve_pages(9), kho_unpreserve_pages(9), kho_preserve_vmalloc(9), kho_unpreserve_vmalloc(9), kho_restore_vmalloc(9), kho_alloc_preserve(9), kho_unpreserve_free(9), is_kho_boot(9), kho_retrieve_subtree(9)

ngl that's a whole friend group of functions, and every single one of them is in here 💀 go read them, bestie, they're all linked in spirit 🧚

---

mwah 💋 this page came from the Kernel file ./kernel/liveupdate, dated October 2026 — and that's the whole footer, slay 🌈⭐