drm/i915: Add missing doc for drm_i915_reset_stats

Add missing doc for struct drm_i915_reset_stats.

Cc: Andi Shyti <andi.shyti@linux.intel.com>
Signed-off-by: Nirmoy Das <nirmoy.das@intel.com>
Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20240229132918.10205-1-nirmoy.das@intel.com

diff --git a/include/uapi/drm/i915_drm.h b/include/uapi/drm/i915_drm.h
index bd87386a82438500d9263a7d2193496b94f3500c..fb195d3b3e9fa5e766005f9cf817cc2553bc82a3 100644 (file)
--- a/include/uapi/drm/i915_drm.h
+++ b/include/uapi/drm/i915_drm.h
@@ -2623,19 +2623,29 @@ struct drm_i915_reg_read {
  *
  */
 
+/*
+ * struct drm_i915_reset_stats - Return global reset and other context stats
+ *
+ * Driver keeps few stats for each contexts and also global reset count.
+ * This struct can be used to query those stats.
+ */
 struct drm_i915_reset_stats {
+       /** @ctx_id: ID of the requested context */
        __u32 ctx_id;
+
+       /** @flags: MBZ */
        __u32 flags;
 
-       /* All resets since boot/module reload, for all contexts */
+       /** @reset_count: All resets since boot/module reload, for all contexts */
        __u32 reset_count;
 
-       /* Number of batches lost when active in GPU, for this context */
+       /** @batch_active: Number of batches lost when active in GPU, for this context */
        __u32 batch_active;
 
-       /* Number of batches lost pending for execution, for this context */
+       /** @batch_pending: Number of batches lost pending for execution, for this context */
        __u32 batch_pending;
 
+       /** @pad: MBZ */
        __u32 pad;
 };