drm/amdgpu/uapi: Clarify comment on AMDGPU_VM_PAGE_PRT
authorTimur Kristóf <timur.kristof@gmail.com>
Wed, 19 Nov 2025 09:25:43 +0000 (10:25 +0100)
committerAlex Deucher <alexander.deucher@amd.com>
Mon, 8 Dec 2025 18:56:31 +0000 (13:56 -0500)
In the context of the amdgpu uAPI, the PRT flag is referring only
to unmapped pages of a partially resident texture (aka. sparse
resource), but not the full resource.

Virtual addresses marked with this flag behave as follows:
- Reads return zero
- Writes are discarded

Signed-off-by: Timur Kristóf <timur.kristof@gmail.com>
Reviewed-by: Christian König <christian.koenig@amd.com>
Signed-off-by: Alex Deucher <alexander.deucher@amd.com>
include/uapi/drm/amdgpu_drm.h

index c705fbc..351c2fb 100644 (file)
@@ -883,7 +883,7 @@ struct drm_amdgpu_gem_list_handles_entry {
 #define AMDGPU_VM_PAGE_WRITEABLE       (1 << 2)
 /* executable mapping, new for VI */
 #define AMDGPU_VM_PAGE_EXECUTABLE      (1 << 3)
-/* partially resident texture */
+/* unmapped page of partially resident textures */
 #define AMDGPU_VM_PAGE_PRT             (1 << 4)
 /* MTYPE flags use bit 5 to 8 */
 #define AMDGPU_VM_MTYPE_MASK           (0xf << 5)