drm_gpuvm_exec_lock(9)

okay so bestie, we're deep in the Kernel API Manual and today's main character is drm_gpuvm_exec_lock(9) — she's here to lock all dma-resv of all associated BOs, no cap. ✨

🌸 NAME 🌸

drm_gpuvm_exec_lock — lock all dma-resv of all associated BOs. 💅

✨ SYNOPSIS ✨

int drm_gpuvm_exec_lock (struct drm_gpuvm_exec *vm_exec );

🎀 ARGUMENTS 🎀

• vm_exec — the drm_gpuvm_exec wrapper. That's the whole arg, bestie. 🫶

💅 DESCRIPTION 💅

Okay so here's the tea: this function acquires all dma-resv locks of all drm_gem_objects the given drm_gpuvm contains mappings of. Literally all the locks, all the mappings, the whole vibe check. 🔥

Additionally, when calling this function with struct drm_gpuvm_exec::extra being set, the driver receives the given fn callback to lock additional dma-resv in the context of the drm_gpuvm_exec instance. And typically, drivers would call drm_exec_prepare_obj from within this callback. Obsessed with a callback that knows its assignment. 💖

🔥 RETURN 🔥

0 on success, negative error code on failure. Slay when it's zero; when it's negative, that's the sad trombone. 😭

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/drm_gpuvm.c plus the whole SEE ALSO squad:

• Overview(9)
• Split and Merge(9)
• Madvise Logic - Splitting and Traversal(9)
• Locking(9)
• Examples(9)
• get_next_vm_bo_from_list(9)
• for_each_vm_bo_in_list(9)
• restore_vm_bo_list(9)
• drm_gpuvm_bo_is_zombie(9)
• drm_gpuvm_bo_list_add(9)
• drm_gpuvm_bo_list_del_init(9)
• drm_gpuvm_bo_list_del(9)
• drm_gpuvm_range_valid(9)
• drm_gpuvm_resv_object_alloc(9)
• drm_gpuvm_init(9)
• drm_gpuvm_put(9)
• drm_gpuvm_prepare_vm(9)
• drm_gpuvm_prepare_objects(9)
• drm_gpuvm_prepare_range(9)
• drm_gpuvm_exec_lock_array(9)
• drm_gpuvm_exec_lock_range(9)
• drm_gpuvm_validate(9)
• drm_gpuvm_resv_add_fence(9)
• drm_gpuvm_bo_create(9)
• drm_gpuvm_bo_put(9)
• drm_gpuvm_bo_put_deferred(9)
• drm_gpuvm_bo_deferred_cleanup(9)
• drm_gpuvm_bo_find(9)
• drm_gpuvm_bo_obtain_locked(9)
• drm_gpuvm_bo_obtain_prealloc(9)
• drm_gpuvm_bo_extobj_add(9)
• drm_gpuvm_bo_evict(9)
• drm_gpuva_insert(9)
• drm_gpuva_remove(9)
• drm_gpuva_link(9)
• drm_gpuva_unlink(9)
• drm_gpuva_unlink_defer(9)
• drm_gpuva_find_first(9)
• drm_gpuva_find(9)
• drm_gpuvm_interval_empty(9)
• drm_gpuva_map(9)
• drm_gpuva_remap(9)
• drm_gpuva_unmap(9)
• drm_gpuvm_sm_map(9)
• drm_gpuvm_sm_unmap(9)
• drm_gpuvm_sm_map_exec_lock(9)
• drm_gpuvm_sm_unmap_exec_lock(9)
• drm_gpuvm_sm_map_ops_create(9)
• drm_gpuvm_madvise_ops_create(9)
• drm_gpuvm_sm_unmap_ops_create(9)
• drm_gpuvm_prefetch_ops_create(9)
• drm_gpuvm_bo_unmap_ops_create(9)
• drm_gpuva_ops_free(9)

— signing off from ./drivers/gpu/drm, October 2026. mwah 💖