drm/xe/vm: Add attributes struct as member of vma

The attribute of xe_vma will determine the migration policy and the
encoding of the page table entries (PTEs) for that vma.
This attribute helps manage how memory pages are moved and how their
addresses are translated. It will be used by madvise to set the
behavior of the vma.

v2 (Matthew Brost)
- Add docs

v3 (Matthew Brost)
- Add uapi references
- 80 characters line wrap

Cc: Matthew Brost <matthew.brost@intel.com>
Reviewed-by: Matthew Brost <matthew.brost@intel.com>
Reviewed-by: Thomas Hellström <thomas.hellstrom@linux.intel.com>
Link: https://lore.kernel.org/r/20250821173104.3030148-3-himal.prasad.ghimiray@intel.com
Signed-off-by: Himal Prasad Ghimiray <himal.prasad.ghimiray@intel.com>

diff --git a/drivers/gpu/drm/xe/xe_vm_types.h b/drivers/gpu/drm/xe/xe_vm_types.h
index 8a07feef503badc01ad657ab9b5089622d0371fc..8e8138c2b80a0dd96923f938a899cd0dfd21a7e3 100644 (file)
--- a/drivers/gpu/drm/xe/xe_vm_types.h
+++ b/drivers/gpu/drm/xe/xe_vm_types.h
@@ -77,6 +77,33 @@ struct xe_userptr {
 #endif
 };
 
+/**
+ * struct xe_vma_mem_attr - memory attributes associated with vma
+ */
+struct xe_vma_mem_attr {
+       /** @preferred_loc: perferred memory_location */
+       struct {
+               /** @preferred_loc.migration_policy: Pages migration policy */
+               u32 migration_policy;
+
+               /**
+                * @preferred_loc.devmem_fd: used for determining pagemap_fd
+                * requested by user DRM_XE_PREFERRED_LOC_DEFAULT_SYSTEM and
+                * DRM_XE_PREFERRED_LOC_DEFAULT_DEVICE mean system memory or
+                * closest device memory respectively.
+                */
+               u32 devmem_fd;
+       } preferred_loc;
+
+       /**
+        * @atomic_access: The atomic access type for the vma
+        * See %DRM_XE_VMA_ATOMIC_UNDEFINED, %DRM_XE_VMA_ATOMIC_DEVICE,
+        * %DRM_XE_VMA_ATOMIC_GLOBAL, and %DRM_XE_VMA_ATOMIC_CPU for possible
+        * values. These are defined in uapi/drm/xe_drm.h.
+        */
+       u32 atomic_access;
+};
+
 struct xe_vma {
        /** @gpuva: Base GPUVA object */
        struct drm_gpuva gpuva;
@@ -135,6 +162,12 @@ struct xe_vma {
         * Needs to be signalled before UNMAP can be processed.
         */
        struct xe_user_fence *ufence;
+
+       /**
+        * @attr: The attributes of vma which determines the migration policy
+        * and encoding of the PTEs for this vma.
+        */
+       struct xe_vma_mem_attr attr;
 };
 
 /**