hl_vm_ctx_fini(9)

💅 hl_vm_ctx_fini(9) — the Kernel API Manual glow-up

okay so bestie, welcome to hl_vm_ctx_fini, straight out of the Kernel API Manual. she's a teardown function, she's drama, she's the last one to leave the party and she's making sure the lights are OFF. 🎀

---

✨ NAME ✨

hl_vm_ctx_fini — virtual memory teardown of context. that's it, that's the vibe. she cleans up the whole virtual memory situation for a context. 🧹💖

---

✨ SYNOPSIS ✨

void hl_vm_ctx_fini (struct hl_ctx *ctx );

no return value, no cap, she just goes in and does the thing. 💅

---

✨ ARGUMENTS ✨

• ctx — pointer to the habanalabs context structure. this is your context, the one you're shutting down. she's holding it, she's looking at it, she's about to take it apart. 🫶

---

✨ DESCRIPTION ✨

so what does this icon actually do? she performs teardown of the following, and yes we're listing them all, no skipping, i don't play like that:

• Virtual block list of available virtual memory. 💀
• Virtual address to area descriptor hashtable. 🔥
• MMU for context. ✨

and in addition (because she's not done, the way that she's not done), this function does the following:

• Unmaps the existing hashtable nodes if the hashtable is not empty. 👀 the hashtable should be empty as no valid mappings should exist at this point. like, fr fr, if it's not empty something's off.
• Frees any existing physical page list from the idr which relates to the current context asid. 🧚
• This function checks the virtual block list for correctness. at this point the list should contain one element which describes the whole virtual memory range of the context. otherwise, a warning is printed. 😭 so like, if you see that warning, that's your sign that something didn't go the way it should have.

ngl, this whole function is basically the "okay everybody out, check your bags, did anyone leave a mapping behind" moment of context teardown. 🦋

---

✨ SEE ALSO ✨

bestie the cross-references go CRAZY. here's the whole squad, plus the kernel file:

Kernel file ./drivers/accel/habanalabs/common/memory.c

dma_map_host_va(9), dma_unmap_host_va(9), dram_pg_pool_do_release(9), free_phys_pg_pack(9), free_device_memory(9), clear_va_list_locked(9), print_va_list_locked(9), merge_va_blocks_locked(9), add_va_block_locked(9), add_va_block(9), is_hint_crossing_range(9), get_va_block(9), hl_get_va_range_type(9), hl_unreserve_va_block(9), init_phys_pg_pack_from_userptr(9), map_phys_pg_pack(9), unmap_phys_pg_pack(9), map_device_va(9), unmap_device_va(9), hl_hw_block_mmap(9), export_dmabuf_from_addr(9), allocate_timestamps_buffers(9), hl_pin_host_memory(9), hl_userptr_delete_list(9), hl_userptr_is_pinned(9), va_range_init(9), va_range_fini(9), vm_ctx_init_with_ranges(9), hl_vm_init(9), hl_vm_fini(9), hl_hw_block_mem_init(9), hl_hw_block_mem_fini(9)

---

🌈 and that's the page, babes. brought to you from ./drivers/accel/habanalabs/common, dated October 2026, and she's hl_vm_ctx_fini(9) — say her name, she earned it. 👑✨