drm/xe: Add pat_index to properties line in VM snapshot capture

Add pat index to properties line in VM snapshot capture indicating
the VMA caching properites. This is useful information for debug and
will help build a robust GPU hang replay tool.

The current format is:

[<vma address>]: <permissions>|<type>|mem_region=0x%x|pat_index=%d

Permissions has two options, either "read_only" or "read_write".

Type has three options, either "userptr", "null_sparse", or "bo".

Memory region is a bit mask of where the memory is located.

Pat index corresponds to the value setup upon VM bind.

Cc: José Roberto de Souza <jose.souza@intel.com>
Signed-off-by: Matthew Brost <matthew.brost@intel.com>
Reviewed-by: Jonathan Cavitt <jonathan.cavitt@intel.com>
Link: https://patch.msgid.link/20251126185952.546277-5-matthew.brost@intel.com

diff --git a/drivers/gpu/drm/xe/xe_vm.c b/drivers/gpu/drm/xe/xe_vm.c
index f2cf95d23bd014b49723587c20f5c65ea5377427..b298953d2eed61d272b95af01fa911fbd2ace767 100644 (file)
--- a/drivers/gpu/drm/xe/xe_vm.c
+++ b/drivers/gpu/drm/xe/xe_vm.c
@@ -4052,6 +4052,7 @@ struct xe_vm_snapshot {
 #define XE_VM_SNAP_FLAG_IS_NULL                BIT(2)
                unsigned long flags;
                int uapi_mem_region;
+               int pat_index;
                struct xe_bo *bo;
                void *data;
                struct mm_struct *mm;
@@ -4094,6 +4095,7 @@ struct xe_vm_snapshot *xe_vm_snapshot_capture(struct xe_vm *vm)
                snap->snap[i].len = xe_vma_size(vma);
                snap->snap[i].flags = xe_vma_read_only(vma) ?
                        XE_VM_SNAP_FLAG_READ_ONLY : 0;
+               snap->snap[i].pat_index = vma->attr.pat_index;
                if (bo) {
                        snap->snap[i].bo = xe_bo_get(bo);
                        snap->snap[i].bo_ofs = xe_vma_bo_offset(vma);
@@ -4195,7 +4197,7 @@ void xe_vm_snapshot_print(struct xe_vm_snapshot *snap, struct drm_printer *p)
        for (i = 0; i < snap->num_snaps; i++) {
                drm_printf(p, "[%llx].length: 0x%lx\n", snap->snap[i].ofs, snap->snap[i].len);
 
-               drm_printf(p, "[%llx].properties: %s|%s|mem_region=0x%lx\n",
+               drm_printf(p, "[%llx].properties: %s|%s|mem_region=0x%lx|pat_index=%d\n",
                           snap->snap[i].ofs,
                           snap->snap[i].flags & XE_VM_SNAP_FLAG_READ_ONLY ?
                           "read_only" : "read_write",
@@ -4204,7 +4206,8 @@ void xe_vm_snapshot_print(struct xe_vm_snapshot *snap, struct drm_printer *p)
                           snap->snap[i].flags & XE_VM_SNAP_FLAG_USERPTR ?
                           "userptr" : "bo",
                           snap->snap[i].uapi_mem_region == -1 ? 0 :
-                          BIT(snap->snap[i].uapi_mem_region));
+                          BIT(snap->snap[i].uapi_mem_region),
+                          snap->snap[i].pat_index);
 
                if (IS_ERR(snap->snap[i].data)) {
                        drm_printf(p, "[%llx].error: %li\n", snap->snap[i].ofs,