drm/ttm: Update the struct ttm_operation_ctx kerneldoc

Update the kerneldoc with a more elaborate description of some members,
including the gfp_retry_mayfail member. Use inline kerneldoc.

Suggested-by: Simona Vetter <simona.vetter@ffwll.ch>
Signed-off-by: Thomas Hellström <thomas.hellstrom@linux.intel.com>
Reviewed-by: Maarten Lankhorst <dev@lankhorst.se>
Acked-by: Christian König <christian.koening@amd.com>
Link: https://patch.msgid.link/20260317141856.237876-4-thomas.hellstrom@linux.intel.com

diff --git a/include/drm/ttm/ttm_bo.h b/include/drm/ttm/ttm_bo.h
index bca3a8849d47da77903faf9f39929d150217146b..8310bc3d55f90871796c5c39e734edee58f445b3 100644 (file)
--- a/include/drm/ttm/ttm_bo.h
+++ b/include/drm/ttm/ttm_bo.h
@@ -167,24 +167,34 @@ struct ttm_bo_kmap_obj {
 /**
  * struct ttm_operation_ctx
  *
- * @interruptible: Sleep interruptible if sleeping.
- * @no_wait_gpu: Return immediately if the GPU is busy.
- * @gfp_retry_mayfail: Set the __GFP_RETRY_MAYFAIL when allocation pages.
- * @allow_res_evict: Allow eviction of reserved BOs. Can be used when multiple
- * BOs share the same reservation object.
- * faults. Should only be used by TTM internally.
- * @resv: Reservation object to allow reserved evictions with.
- * @bytes_moved: Statistics on how many bytes have been moved.
- *
  * Context for TTM operations like changing buffer placement or general memory
  * allocation.
  */
 struct ttm_operation_ctx {
+       /** @interruptible: Sleep interruptible if sleeping. */
        bool interruptible;
+       /** @no_wait_gpu: Return immediately if the GPU is busy. */
        bool no_wait_gpu;
+       /**
+        * @gfp_retry_mayfail: Use __GFP_RETRY_MAYFAIL | __GFP_NOWARN
+        * when allocation pages. This is to avoid invoking the OOM
+        * killer when populating a buffer object, in order to
+        * forward the error for it to be dealt with.
+        */
        bool gfp_retry_mayfail;
+       /**
+        * @allow_res_evict: Allow eviction of reserved BOs. Can be used
+        * when multiple BOs share the same reservation object @resv.
+        */
        bool allow_res_evict;
+       /**
+        * @resv: Reservation object to be used together with
+        * @allow_res_evict.
+        */
        struct dma_resv *resv;
+       /**
+        * @bytes_moved: Statistics on how many bytes have been moved.
+        */
        uint64_t bytes_moved;
 };