merge_va_blocks_locked(9)

🌸 NAME 🌸

okay bestie, welcome to merge_va_blocks_locked(9) from the Kernel API Manual — this page is literally about one lil function. 💖 Its NAME-section energy is: merge_va_blocks_locked — merge a virtual block if possible. ✨

---

✨ SYNOPSIS ✨

Here’s the signature, copied exactly so nobody gets it twisted:

void merge_va_blocks_locked (struct hl_device *hdev , struct list_head
*va_list , struct hl_vm_va_block *va_block );

---

🫶 ARGUMENTS 🫶

Three args, no stress:

• hdev — pointer to the habanalabs device structure.
• va_list — pointer to the virtual addresses block list.
• va_block — virtual block to merge with adjacent blocks.

---

💅 DESCRIPTION 💅

This function does the following, periodt:

• Merge the given blocks with the adjacent blocks if their virtual ranges create a contiguous virtual range.

🚨 lock check bestie: this function should be called only when the va_list lock is taken. No sneaky unlocked calls, okay? 😭

---

🔥 SEE ALSO 🔥

Kernel file: ./drivers/accel/habanalabs/common/memory.c — that’s the source luv. 🦋

And the whole SEE ALSO friend group, all accounted for:

• 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), 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)

---

okay that’s the whole page, bestie! 💖 source/version: ./drivers/accel/habanalabs/common, date: October 2026 — merge_va_blocks_locked(9) signing off with main character energy. 🎀