Merge tag 'drm-next-2024-05-25' of https://gitlab.freedesktop.org/drm/kernel

[linux-block.git] / include / uapi / drm / panthor_drm.h

diff --git a/include/uapi/drm/panthor_drm.h b/include/uapi/drm/panthor_drm.h
index dadb05ab1235839cc828c94a73614d9a76a4be25..aaed8e12ad0b6d632b9726e20b171ac570a28ca8 100644 (file)
--- a/include/uapi/drm/panthor_drm.h
+++ b/include/uapi/drm/panthor_drm.h
@@ -895,13 +895,21 @@ struct drm_panthor_tiler_heap_create {
        /** @vm_id: VM ID the tiler heap should be mapped to */
        __u32 vm_id;
 
-       /** @initial_chunk_count: Initial number of chunks to allocate. */
+       /** @initial_chunk_count: Initial number of chunks to allocate. Must be at least one. */
        __u32 initial_chunk_count;
 
-       /** @chunk_size: Chunk size. Must be a power of two at least 256KB large. */
+       /**
+        * @chunk_size: Chunk size.
+        *
+        * Must be page-aligned and lie in the [128k:8M] range.
+        */
        __u32 chunk_size;
 
-       /** @max_chunks: Maximum number of chunks that can be allocated. */
+       /**
+        * @max_chunks: Maximum number of chunks that can be allocated.
+        *
+        * Must be at least @initial_chunk_count.
+        */
        __u32 max_chunks;
 
        /**
@@ -931,7 +939,11 @@ struct drm_panthor_tiler_heap_create {
  * struct drm_panthor_tiler_heap_destroy - Arguments passed to DRM_IOCTL_PANTHOR_TILER_HEAP_DESTROY
  */
 struct drm_panthor_tiler_heap_destroy {
-       /** @handle: Handle of the tiler heap to destroy */
+       /**
+        * @handle: Handle of the tiler heap to destroy.
+        *
+        * Must be a valid heap handle returned by DRM_IOCTL_PANTHOR_TILER_HEAP_CREATE.
+        */
        __u32 handle;
 
        /** @pad: Padding field, MBZ. */