From: Honglei Huang <[email protected]> Extend the virtgpu UAPI to support userptr blob resources, enabling the host to directly access guest userspace memory without data copying. This is essential for compute workloads where memcpy overhead between host and guest is unacceptable.
UAPI Changes: - Add VIRTGPU_BLOB_FLAG_USE_USERPTR flag to enable userptr mode - Add VIRTGPU_BLOB_FLAG_USERPTR_RDONLY flag for read-only access - Add 'userptr' field to drm_virtgpu_resource_create_blob structure to pass guest userspace virtual address - Add VIRTGPU_PARAM_RESOURCE_USERPTR for runtime feature detection The userptr field contains the guest userspace virtual address that will be pinned by the driver during resource creation and unpinned on destruction. The driver validates the address, pins the pages, and provides the physical addresses to the host via scatter-gather table. Signed-off-by: Honglei Huang <[email protected]> --- include/uapi/drm/virtgpu_drm.h | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/include/uapi/drm/virtgpu_drm.h b/include/uapi/drm/virtgpu_drm.h index 9debb320c34b..02be53262f05 100644 --- a/include/uapi/drm/virtgpu_drm.h +++ b/include/uapi/drm/virtgpu_drm.h @@ -98,6 +98,7 @@ struct drm_virtgpu_execbuffer { #define VIRTGPU_PARAM_CONTEXT_INIT 6 /* DRM_VIRTGPU_CONTEXT_INIT */ #define VIRTGPU_PARAM_SUPPORTED_CAPSET_IDs 7 /* Bitmask of supported capability set ids */ #define VIRTGPU_PARAM_EXPLICIT_DEBUG_NAME 8 /* Ability to set debug name from userspace */ +#define VIRTGPU_PARAM_RESOURCE_USERPTR 9 /* userptr support with blob resources */ struct drm_virtgpu_getparam { __u64 param; @@ -185,6 +186,8 @@ struct drm_virtgpu_resource_create_blob { #define VIRTGPU_BLOB_FLAG_USE_MAPPABLE 0x0001 #define VIRTGPU_BLOB_FLAG_USE_SHAREABLE 0x0002 #define VIRTGPU_BLOB_FLAG_USE_CROSS_DEVICE 0x0004 +#define VIRTGPU_BLOB_FLAG_USE_USERPTR 0x0008 +#define VIRTGPU_BLOB_FLAG_USERPTR_RDONLY 0x0010 /* zero is invalid blob_mem */ __u32 blob_mem; __u32 blob_flags; @@ -200,6 +203,13 @@ struct drm_virtgpu_resource_create_blob { __u32 cmd_size; __u64 cmd; __u64 blob_id; + + /* + * userptr: guest userspace memory address for VIRTGPU_BLOB_FLAG_USE_USERPTR. + * Must be 0 if VIRTGPU_BLOB_FLAG_USE_USERPTR is not set. + * The driver will pin the user pages and allow the host to access them. + */ + __u64 userptr; }; #define VIRTGPU_CONTEXT_PARAM_CAPSET_ID 0x0001 -- 2.34.1
