free_device_memory(9)

💖 free_device_memory(9) 💖

okay so we're in the Kernel API Manual bestie, and this page is literally about free_device_memory — the function that frees device memory. no cap, that's the whole vibe 🫶

---

✨ SYNOPSIS ✨

int free_device_memory (struct hl_ctx *ctx , struct hl_mem_in *args );

like, yes, it's int — it gives you a return value back, she's not mysterious 🎀

---

🌸 ARGUMENTS 🌸

• ctx — a pointer to the context structure. that's the ~context~ of the whole thing, keep it close 💅
• args — the host parameters containing the requested size. yeah, the size info lives in here 👑

---

💫 DESCRIPTION 💫

so here's what this function actually does, bestie (it's a short list, it's giving lowkey but iconic):

• Free the device memory related to the given handle.

that's it. that's the flex. you hand it the handle-adjacent stuff and the device memory tied to that handle gets freed, periodt ✨

---

🦋 SEE ALSO 🦋

the kernel file herself lives at ./drivers/accel/habanalabs/common/memory.c — go look, iykyk 🧚

and here's the whole friend group of related calls, all of them, fr fr:

• dma_map_host_va(9), dma_unmap_host_va(9), dram_pg_pool_do_release(9), free_phys_pg_pack(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_ctx_fini(9), hl_vm_init(9), hl_vm_fini(9), hl_hw_block_mem_init(9), hl_hw_block_mem_fini(9)

like, that's the entire roster, nobody left out 💀👑

---

ngl, nothing scary flagged on this one — no deprecation warnings, no undefined behaviour drama, just a tidy little free. but always actually read your return value, bestie 😭

---

okay and for the cute sign-off: this page is from ./drivers/accel/habanalabs/common, dated October 2026, and it's page free_device_memory(9) of the Kernel API Manual 💜 that's the whole footer, mwah, bye bestie 🎀⭐