map_phys_pg_pack(9)

💖 map_phys_pg_pack — kernel API manual, section 9 🎀

okay so bestie, buckle up, because we're diving into the Kernel API Manual (section 9, the big-kid section) and this one is literally about gluing virtual memory to physical memory. no cap. let's go ✨

---

🌸 NAME 🌸

map_phys_pg_pack — maps the physical page pack.. 🦋

(yes the double period is canon, i don't make the rules, i just report them 💅)

---

✨ SYNOPSIS ✨

int map_phys_pg_pack (struct hl_ctx *ctx , u64 vaddr , struct
hl_vm_phys_pg_pack *phys_pg_pack );

like, it returns an int, it takes three things, and it's giving very much "i do one job and i do it well" energy 👑

---

🫶 ARGUMENTS 🫶

• ctx — pointer to the context structure. the main character of the operation, honestly 🌈
• vaddr — start address of the virtual area to map from. this is where the virtual vibes begin ⭐
• phys_pg_pack — the pack of physical pages to map to. the actual real ones. the land, not the map 🍓

---

🔥 DESCRIPTION 🔥

so here's the tea, this function does the following:

• Maps each chunk of virtual memory to matching physical chunk. one-to-one, no funny business, slay 💜
• Stores number of successful mappings in the given argument. it's keeping receipts, periodt 🧚
• Returns 0 on success, error code otherwise. zero means we ate, anything else means something's up 😭

ngl, that third bullet is the whole mood: 0 = iconic, non-zero = go read the error code bestie 💀

---

👑 SEE ALSO 👑

the kernel file lives right here, fr fr:

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

and it's friends with literally everyone, i'm obsessed:

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

that's a whole friend group and honestly? goals 💖

---

<div align="center">— 🎀 —</div>

and that's the page!! sourced straight from ./drivers/accel/habanalabs/common, stamped October 2026, section 9 of the Kernel API Manual. mwah 💋 go map some pages bestie, you got this 🌟