Commit 034d47b2 authored by Tvrtko Ursulin's avatar Tvrtko Ursulin

drm/i915/uapi: Document DRM_I915_QUERY_HWCONFIG_BLOB

UAPI with absolutely no documentation should not have been added -
clarify blob format and content will be described externally.

Fixes: 78e1fb31 ("drm/i915/uapi: Add query for hwconfig blob")
Signed-off-by: default avatarTvrtko Ursulin <tvrtko.ursulin@intel.com>
Co-developed-by: default avatarJordan Justen <jordan.l.justen@intel.com>
Cc: Jon Bloomfield <jon.bloomfield@intel.com>
Cc: Daniel Vetter <daniel.vetter@ffwll.ch>
Cc: John Harrison <john.c.harrison@intel.com>
Cc: Jon Ewins <jon.ewins@intel.com>
Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com>
Cc: Rodrigo Vivi <rodrigo.vivi@intel.com>
Reviewed-by: default avatarDaniel Vetter <daniel.vetter@ffwll.ch>
Link: https://patchwork.freedesktop.org/patch/msgid/20220325094916.2186367-1-tvrtko.ursulin@linux.intel.com
[tursulin: Fixed spelling s/meading/meaning/.]
parent a0f1f7b4
...@@ -2683,6 +2683,9 @@ struct drm_i915_perf_oa_config { ...@@ -2683,6 +2683,9 @@ struct drm_i915_perf_oa_config {
* *
* The behaviour is determined by the @query_id. Note that exactly what * The behaviour is determined by the @query_id. Note that exactly what
* @data_ptr is also depends on the specific @query_id. * @data_ptr is also depends on the specific @query_id.
*
* For specific queries see:
* * `GuC HWCONFIG blob uAPI`_
*/ */
struct drm_i915_query_item { struct drm_i915_query_item {
/** @query_id: The id for this query */ /** @query_id: The id for this query */
...@@ -3135,6 +3138,16 @@ struct drm_i915_query_memory_regions { ...@@ -3135,6 +3138,16 @@ struct drm_i915_query_memory_regions {
struct drm_i915_memory_region_info regions[]; struct drm_i915_memory_region_info regions[];
}; };
/**
* DOC: GuC HWCONFIG blob uAPI
*
* The GuC produces a blob with information about the current device.
* i915 reads this blob from GuC and makes it available via this uAPI.
*
* The format and meaning of the blob content are documented in the
* Programmer's Reference Manual.
*/
/** /**
* struct drm_i915_gem_create_ext - Existing gem_create behaviour, with added * struct drm_i915_gem_create_ext - Existing gem_create behaviour, with added
* extension support using struct i915_user_extension. * extension support using struct i915_user_extension.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment