kho_retrieve_subtree(9)

💅 kho_retrieve_subtree(9)

okay bestie, so this one is from the Kernel API Manual and it's literally the "hey, can I get that blob back" function 🎀

---

✨ NAME ✨

kho_retrieve_subtree — retrieve a preserved sub blob by its name. that's it, that's the whole vibe 🫶

---

🦋 SYNOPSIS 🦋

int kho_retrieve_subtree (const char *name , phys_addr_t *phys , size_t
       *size );

---

🌸 ARGUMENTS 🌸

• name — the name of the sub blob passed to kho_add_subtree. like the little name tag on its lil backpack 🎒
• phys — if found, the physical address of the sub blob is stored in phys. that's the whole point, bestie 💖
• size — if not NULL and found, the size of the sub blob is stored in size. so it's optional and conditional, she's high-maintenance like that 💅

---

👑 DESCRIPTION 👑

Retrieve a preserved sub blob named name and store its physical address in phys and optionally its size in size.

literally that simple. you give her the name, she gives you the address, and if you pass a non-NULL size she'll drop the size in there too. no cap ✨

ngl, the size pointer is the sneaky optional one — not NULL and found are both required before anything gets written there. iykyk 🧚

---

⭐ 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_preserve_vmalloc(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)

---

and that's the whole page, bestie — go read the whole family, they all slay together 🔥

this masterclass in blob retrieval lives in ./kernel/liveupdate, dated October 2026, and she's serving kho_retrieve_subtree(9) realness 💜 periodt.