drm_gpuvm_sm_unmap(9)

📦 version 7.3.1, in nixpkgs unstable

🌸 drm_gpuvm_sm_unmap(9) — Kernel API Manual 🌸

okay so bestie, we're in the kernel API manual today, and this one is called drm_gpuvm_sm_unmap. Buckle up 💖

✨ NAME ✨

drm_gpuvm_sm_unmap — calls the &drm_gpuva_ops to split on unmap 💅

🦋 SYNOPSIS 🦋

int drm_gpuvm_sm_unmap (struct drm_gpuvm *gpuvm , void *priv , u64
req_addr , u64 req_range );

like, that's the whole signature. iykyk ✨

🎀 ARGUMENTS 🎀

  • gpuvm — the drm_gpuvm representing the GPU VA space, the main character 👑
  • priv — pointer to a driver private data structure, your little secret stash 🙈
  • req_addr — the start address of the range to unmap ⭐
  • req_range — the range of the mappings to unmap, so like how much we're clearing out 🌈

💜 DESCRIPTION 💜

so this function iterates the given range of the GPU VA space, no biggie. it utilizes the drm_gpuvm_ops to call back into the driver with the operations to unmap and, if required, split existing mappings. the way that it just handles all of it for you?? obsessed 🫶

Drivers may use these callbacks to update the GPU VA space right away within the callback — super convenient, lowkey iconic. But here's the important bit, bestie, listen up ⚠️: in case the driver decides to copy and store the operations for later processing, neither this function nor drm_gpuvm_sm_map is allowed to be called before the drm_gpuvm's view of the GPU VA space was updated with the previous set of operations. like, that's the rule. no cap. To update the drm_gpuvm's view of the GPU VA space, drm_gpuva_insert, drm_gpuva_destroy_locked and/or drm_gpuva_destroy_unlocked should be used. those are your girls for that job 💅

A sequence of callbacks can contain unmap and remap operations, depending on whether there are actual overlapping mappings to split. so like sometimes it's just unmaps, sometimes it's unmaps and remaps. depends on the vibe check 🔥

There can be an arbitrary amount of unmap operations and a maximum of two remap operations. arbitrary! but max two. remember that ✨

⭐ RETURN ⭐

0 on success or a negative error code. slay when it's 0 🎉

🌸 SEE ALSO 🌸

Kernel file ./drivers/gpu/drm/drm_gpuvm.c — plus the entire friend group, all of (9) fame 🫶:

this page lives in ./drivers/gpu/drm and it's dated October 2026 📅 go read the whole drm_gpuvm.c file, it's giving main character energy, fr fr 🧚💖

k bye bestie, ily, go unmap responsibly 💅✨🎀

📦 where this page comes from