kho_preserve_vmalloc(9)

🎀 kho_preserve_vmalloc(9) — Kernel API Manual 🎀

okay bestie, welcome to the Kernel API Manual entry for kho_preserve_vmalloc(9) — it's giving kernel handover realness and we're gonna keep every detail cute and intact 💖

---

✨ NAME ✨

kho_preserve_vmalloc — preserve memory allocated with vmalloc() across kexec

🦋 SYNOPSIS 🦋

int kho_preserve_vmalloc (void *ptr , struct kho_vmalloc *preservation
);

💅 ARGUMENTS 💅

• ptr — pointer to the area in vmalloc address space
• preservation — placeholder for preservation metadata

🌸 DESCRIPTION 🌸

okay so this one instructs KHO to preserve the area in vmalloc address space at ptr. The physical pages mapped at ptr will be preserved, and on successful return preservation will hold the physical address of a structure that describes the preservation. no cap, that's the whole flow 💫

💀 NOTE 💀

bestie, heads up: the memory allocated with vmalloc_node variants cannot be reliably restored on the same node 😭

🔥 RETURN 🔥

• 0 on success
• error code on failure

🌈 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_unpreserve_vmalloc(9)
• kho_restore_vmalloc(9)
• kho_alloc_preserve(9)
• kho_unpreserve_free(9)
• kho_restore_free(9)
• is_kho_boot(9)
• kho_retrieve_subtree(9)

---

xoxo bestie, footer sign-off time 💖 source/version is ./kernel/liveupdate, dated October 2026, and this whole page is still serving kho_preserve_vmalloc(9) — periodt 💅✨