vmw_user_re...ookup_handle(9)

💖 vmw_user_resource_lookup_handle(9) 💖

okay so you're in the Kernel API Manual, bestie, and the header/footer shorthand for this page is vmw_user_re...ookup_handle(9). This function is literally the resource-lookup bestie: it looks up a struct resource from a TTM user-space handle and does basic type checks. 🫶

✨ NAME ✨

vmw_user_resource_lookup_handle — lookup a struct resource from a TTM user-space handle and perform basic type checks.

🌸 SYNOPSIS 🌸

       int vmw_user_resource_lookup_handle (struct vmw_private *dev_priv ,
       struct ttm_object_file *tfile , uint32_t handle , const struct
       vmw_user_resource_conv *converter , struct vmw_resource **p_res );

🎀 ARGUMENTS 🎀

• dev_priv — pointer to a device private struct. That's the device private-struct pointer, periodt.
• tfile — pointer to a struct ttm_object_file identifying the caller. So we know who's asking, iykyk.
• handle — the TTM user-space handle. The actual handle, no cap.
• converter — pointer to an object describing the resource type. It's giving "resource type info," bestie.
• p_res — on successful return, the location pointed to will contain a pointer to a refcounted struct vmw_resource. Main character energy tbh.

💅 DESCRIPTION 💅

The way that this is a whole type-check moment: if the handle can't be found or is associated with an incorrect resource type, -EINVAL will be returned. That's the vibe check. 😭

🦋 SEE ALSO 🦋

• Kernel file: ./drivers/gpu/drm/vmwgfx/vmwgfx_resource.c
• vmw_resource_mob_attach(9)
• vmw_resource_mob_detach(9)
• vmw_resource_release_id(9)
• vmw_resource_alloc_id(9)
• vmw_resource_init(9)
• vmw_resource_buf_alloc(9)
• vmw_resource_do_validate(9)
• vmw_resource_unreserve(9)
• vmw_resource_check_buffer(9)
• vmw_resource_backoff_reservation(9)
• vmw_resource_do_evict(9)
• vmw_resource_validate(9)
• vmw_resource_unbind_list(9)
• vmw_query_readback_all(9)
• vmw_query_move_notify(9)
• vmw_resource_needs_backup(9)
• vmw_resource_evict_type(9)
• vmw_resource_evict_all(9)
• vmw_resource_unpin(9)
• vmw_res_type(9)
• vmw_resource_dirty_update(9)
• vmw_resources_clean(9)

okay bye bestie! 💖 This page is from the Kernel API Manual, header/footer shorthand vmw_user_re...ookup_handle(9), source/version ./drivers/gpu/drm/vmwgfx, dated October 2026. Periodt. 🫶