History

drm/xe/uapi: Document drm_xe_query_config keys

Provide a description of the keys used the struct drm_xe_query_config info array.

Francois Dugast committed 2 years ago

Commit af8ea411 parent ff6c6bc1 file · +20 −0Browse files

Unified · Split

include/uapi/drm/xe_drm.h+20−0
@@ -350,11 +350,31 @@ struct drm_xe_query_config { · 349 unmodified lines
350350 /** @pad: MBZ */
351351 __u32 pad;
352352
353+ /*
354+ * Device ID (lower 16 bits) and the device revision (next
355+ * 8 bits)
356+ */
353357 #define DRM_XE_QUERY_CONFIG_REV_AND_DEVICE_ID 0
358+ /*
359+ * Flags describing the device configuration, see list below
360+ */
354361 #define DRM_XE_QUERY_CONFIG_FLAGS 1
362+ /*
363+ * Flag is set if the device has usable VRAM
364+ */
355365 #define DRM_XE_QUERY_CONFIG_FLAG_HAS_VRAM (1 << 0)
366+ /*
367+ * Minimal memory alignment required by this device,
368+ * typically SZ_4K or SZ_64K
369+ */
356370 #define DRM_XE_QUERY_CONFIG_MIN_ALIGNMENT 2
371+ /*
372+ * Maximum bits of a virtual address
373+ */
357374 #define DRM_XE_QUERY_CONFIG_VA_BITS 3
375+ /*
376+ * Value of the highest available exec queue priority
377+ */
358378 #define DRM_XE_QUERY_CONFIG_MAX_EXEC_QUEUE_PRIORITY 4
359379 /** @info: array of elements containing the config info */
360380 __u64 info[];