[PATCH v1 04/14] drm/xe/uapi: Document drm_xe_query_config keys

[Rodrigo Vivi]

On Thu, Dec 07, 2023 at 01:49:59PM +0000, Francois Dugast wrote:
> Provide a description of the keys used the struct
> drm_xe_query_config info array.
> 
> Closes: https://gitlab.freedesktop.org/drm/xe/kernel/-/issues/637
> Signed-off-by: Francois Dugast <francois.dugast at intel.com>

Reviewed-by: Rodrigo Vivi <rodrigo.vivi at intel.com>

> ---
>  include/uapi/drm/xe_drm.h | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)
> 
> diff --git a/include/uapi/drm/xe_drm.h b/include/uapi/drm/xe_drm.h
> index 7b18844401fd..cc1c6c5d594c 100644
> --- a/include/uapi/drm/xe_drm.h
> +++ b/include/uapi/drm/xe_drm.h
> @@ -352,11 +352,31 @@ struct drm_xe_query_config {
>  	/** @pad: MBZ */
>  	__u32 pad;
>  
> +	/*
> +	 * Device ID (lower 16 bits) and the device revision (next
> +	 * 8 bits)
> +	 */
>  #define DRM_XE_QUERY_CONFIG_REV_AND_DEVICE_ID	0
> +	/*
> +	 * Flags describing the device configuration, see list below
> +	 */
>  #define DRM_XE_QUERY_CONFIG_FLAGS			1
> +	/*
> +	 * Flag is set if the device has usable VRAM
> +	 */
>  	#define DRM_XE_QUERY_CONFIG_FLAG_HAS_VRAM	(1 << 0)
> +	/*
> +	 * Minimal memory alignment required by this device,
> +	 * typically SZ_4K or SZ_64K
> +	 */
>  #define DRM_XE_QUERY_CONFIG_MIN_ALIGNMENT		2
> +	/*
> +	 * Maximum bits of a virtual address
> +	 */
>  #define DRM_XE_QUERY_CONFIG_VA_BITS			3
> +	/*
> +	 * Value of the highest available exec queue priority
> +	 */
>  #define DRM_XE_QUERY_CONFIG_MAX_EXEC_QUEUE_PRIORITY	4
>  	/** @info: array of elements containing the config info */
>  	__u64 info[];
> -- 
> 2.34.1
>