hl_pin_host_memory(9)

💖 NAME 💖

hl_pin_host_memory — pins a chunk of host memory. This is the hl_pin_host_memory(9) page from the Kernel API Manual, and yes bestie, the whole vibe is literally pinning host memory. No cap. 🎀

✨ SYNOPSIS ✨

       int hl_pin_host_memory (struct hl_device *hdev , u64 addr , u64 size ,
       struct hl_userptr *userptr );

🫶 ARGUMENTS 🫶

• hdev — pointer to the habanalabs device structure. That’s the habanalabs device, okay? Iconic.
• addr — the host virtual address of the memory area. The address. The spot. The place. 💅
• size — the size of the memory area. Yes, the amount of memory we’re talking about, bestie.
• userptr — pointer to hl_userptr structure. Fr fr, that’s the one.

🔥 DESCRIPTION 🔥

Okay so here’s the tea: this function does the following, and the list is short but it’s giving exactly what it needs to give:

• Pins the physical pages. That’s the whole first thing. Periodt.
• Create an SG list from those pages. Yep, an SG list gets created from those pages. Slay.

🌈 SEE ALSO 🌈

This is the part where the page is like “go look at these other icons,” and honestly the list is long but every single one deserves its moment:

• 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_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 bestie, that’s the whole manual page. Source/version: ./drivers/accel/habanalabs/common; date: October 2026; and yes, it’s the hl_pin_host_memory(9) page. You ate that, no notes. 💅✨🦋