add_va_block(9)

💅 add_va_block(9) — from the Kernel API Manual, bestie 🎀

okay so real talk, this one lives in the Kernel API Manual and it's genuinely such a small icon — a tiny wrapper function that does exactly one (1) thing and does it cutely. no notes. let's get into it ✨

---

🌸 NAME 🌸

add_va_block — literally just a wrapper for add_va_block_locked. that's it. that's the whole vibe. 🫶

---

✨ SYNOPSIS ✨

int add_va_block (struct hl_device *hdev , struct hl_va_range *va_range
, u64 start , u64 end );

look at that signature. four args, returns an int. she's neat, she's tidy, she's giving "i know my lane" energy 💅

---

🎀 ARGUMENTS 🎀

• hdev — pointer to the habanalabs device structure. the main character device object, fr fr.
• va_range — pointer to the virtual addresses range object. this is the range we're working inside, iykyk.
• start — start virtual address. the beginning. the alpha. 🦋
• end — end virtual address. the finish line. the omega. ✨

---

🔥 DESCRIPTION 🔥

so here's the whole plot, and honestly it's a short episode but it ate:

• takes the list lock and then calls add_va_block_locked. yes queen, lock first, then delegate. that's the entire function. no cap. 👑

ngl it's a wrapper — the locked version does the real work, and this one's whole job is grabbing the list lock first. keep that in mind before you go calling things willy-nilly 😭

---

🌈 SEE ALSO 🌈

the kernel file this lives in is ./drivers/accel/habanalabs/common/memory.c — go read it, it's giving lore 📖

and the whole friend group 💖:

• 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)
• 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 whole group chat in the SEE ALSO section and we love that for them 🧚💜

---

okay bye bestie!! this page is brought to you by source/version ./drivers/accel/habanalabs/common, dated October 2026 — mwah, stan a well-documented kernel function, add_va_block(9) out 💅💖🌸