vmw_translate_mob_ptr(9)

💅 NAME 💅

vmw_translate_mob_ptr(9) is serving Kernel API Manual energy, bestie: this one is here to prepare to translate a user-space buffer handle to a MOB id. It's giving prep, not the translation itself — more on that below 😌✨

✨ SYNOPSIS ✨

int vmw_translate_mob_ptr (struct vmw_private *dev_priv , struct
       vmw_sw_context *sw_context , SVGAMobId *id , struct vmw_bo **vmw_bo_p );

🫶 ARGUMENTS 🫶

• dev_priv — Pointer to a device private structure. Classic device-private moment.
• sw_context — The software context used for this command batch validation. Validation HQ for this batch, basically.
• id — Pointer to the user-space handle to be translated. Pointy pointy.
• vmw_bo_p — Points to a location that, on successful return, will carry a non-reference-counted pointer to the buffer object identified by the user-space handle in id. Key words: on successful return, and non-reference-counted.

🌸 DESCRIPTION 🌸

Okay so this function saves information needed to translate a user-space buffer handle to a MOB id. The translation does not take place immediately, bestie — it happens during a call to vmw_apply_relocations. ⏳💅

This function builds a relocation list and a list of buffers to validate. The former needs to be freed using either vmw_apply_relocations or vmw_free_relocations. The latter needs to be freed using vmw_clear_validations. Cleanup order matters, iykyk 🧹✨

🔥 SEE ALSO 🔥

Kernel file ./drivers/gpu/drm/vmwgfx/vmwgfx_execbuf.c — and the full guest list is:

• struct vmw_relocation(9)
• enum vmw_resource_relocation_type(9)
• struct vmw_resource_relocation(9)
• struct vmw_ctx_validation_info(9)
• struct vmw_cmd_entry(9)
• vmw_ptr_diff(9)
• vmw_execbuf_bindings_commit(9)
• vmw_bind_dx_query_mob(9)
• vmw_cmd_ctx_first_setup(9)
• vmw_execbuf_res_size(9)
• vmw_execbuf_rcache_update(9)
• vmw_execbuf_res_val_add(9)
• vmw_view_res_val_add(9)
• vmw_view_id_val_add(9)
• vmw_resource_context_res_add(9)
• vmw_resource_relocation_add(9)
• vmw_resource_relocations_free(9)
• vmw_resource_relocations_apply(9)
• vmw_resources_reserve(9)
• vmw_cmd_res_check(9)
• vmw_rebind_all_dx_query(9)
• vmw_rebind_contexts(9)
• vmw_view_bindings_add(9)
• vmw_cmd_cid_check(9)
• vmw_execbuf_info_from_res(9)
• vmw_query_bo_switch_prepare(9)
• vmw_query_bo_switch_commit(9)
• vmw_translate_guest_ptr(9)
• vmw_cmd_dx_define_query(9)
• vmw_cmd_dx_bind_query(9)
• vmw_cmd_begin_gb_query(9)
• vmw_cmd_begin_query(9)
• vmw_cmd_end_gb_query(9)
• vmw_cmd_end_query(9)
• vmw_cmd_wait_gb_query(9)
• vmw_cmd_wait_query(9)
• vmw_cmd_res_switch_backup(9)
• vmw_cmd_switch_backup(9)
• vmw_cmd_bind_gb_surface(9)
• vmw_cmd_update_gb_image(9)
• vmw_cmd_update_gb_surface(9)
• vmw_cmd_readback_gb_image(9)
• vmw_cmd_readback_gb_surface(9)
• vmw_cmd_invalidate_gb_image(9)
• vmw_cmd_invalidate_gb_surface(9)
• vmw_cmd_shader_define(9)
• vmw_cmd_shader_destroy(9)
• vmw_cmd_set_shader(9)
• vmw_cmd_set_shader_const(9)
• vmw_cmd_bind_gb_shader(9)
• vmw_cmd_dx_set_single_constant_buffer(9)
• vmw_cmd_dx_set_constant_buffer_offset(9)
• vmw_cmd_dx_set_shader_res(9)
• vmw_cmd_dx_set_shader(9)
• vmw_cmd_dx_set_vertex_buffers(9)
• vmw_cmd_dx_set_index_buffer(9)
• vmw_cmd_dx_set_rendertargets(9)
• vmw_cmd_dx_clear_rendertarget_view(9)
• vmw_cmd_dx_clear_depthstencil_view(9)
• vmw_cmd_dx_set_so_targets(9)
• vmw_cmd_dx_check_subresource(9)
• vmw_cmd_dx_view_remove(9)
• vmw_cmd_dx_define_shader(9)
• vmw_cmd_dx_destroy_shader(9)
• vmw_cmd_dx_bind_shader(9)
• vmw_cmd_dx_genmips(9)
• vmw_cmd_dx_transfer_from_buffer(9)
• vmw_cmd_intra_surface_copy(9)
• vmw_execbuf_copy_fence_user(9)
• vmw_execbuf_submit_fifo(9)
• vmw_execbuf_submit_cmdbuf(9)
• vmw_execbuf_cmdbuf(9)
• vmw_execbuf_unpin_panic(9)
• __vmw_execbuf_release_pinned_bo(9)
• vmw_execbuf_release_pinned_bo(9)

With so much love from the ./drivers/gpu/drm/vmwgfx source/version spot, dated October 2026, closing out the vmw_translate_mob_ptr(9) page — bye bestie! 💋🫶