drm/xe/pf: Add documentation for vram_quota

Add initial documentation for recently added VRAM provisioning
Xe driver specific SR-IOV sysfs files under device/sriov_admin.

Signed-off-by: Michal Wajdeczko <michal.wajdeczko@intel.com>
Cc: Rodrigo Vivi <rodrigo.vivi@intel.com>
Reviewed-by: Piotr Piórkowski <piotr.piorkowski@intel.com>
Acked-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
Link: https://patch.msgid.link/20260218205553.3561-11-michal.wajdeczko@intel.com

diff --git a/Documentation/ABI/testing/sysfs-driver-intel-xe-sriov b/Documentation/ABI/testing/sysfs-driver-intel-xe-sriov
index 7f5ef9eada531d26c8bd0eb5d19d52f506afad90..1d6eaff6882f035743bf9b92b8b9c4a232aafaed 100644 (file)
--- a/Documentation/ABI/testing/sysfs-driver-intel-xe-sriov
+++ b/Documentation/ABI/testing/sysfs-driver-intel-xe-sriov
@@ -129,6 +129,37 @@ Description:
                        -EIO if FW refuses to change the provisioning.
 
 
+What:          /sys/bus/pci/drivers/xe/.../sriov_admin/.bulk_profile/vram_quota
+What:          /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/profile/vram_quota
+Date:          February 2026
+KernelVersion: 7.0
+Contact:       intel-xe@lists.freedesktop.org
+Description:
+               These files allow to perform initial VFs VRAM provisioning prior to VFs
+               enabling or to change VFs VRAM provisioning once the VFs are enabled.
+               Any non-zero initial VRAM provisioning will block VFs auto-provisioning.
+               Without initial VRAM provisioning those files will show result of the
+               VRAM auto-provisioning performed by the PF once the VFs are enabled.
+               Once the VFs are disabled, all VRAM provisioning will be released.
+               These files are visible only on discrete Intel Xe platforms with VRAM
+               and are writeable only if dynamic VFs VRAM provisioning is supported.
+
+               .bulk_profile/vram_quota: (WO) unsigned integer
+                       The amount of the provisioned VRAM in [bytes] for each VF.
+                       Actual quota value might be aligned per HW/FW requirements.
+
+               profile/vram_quota: (RW) unsigned integer
+                       The amount of the provisioned VRAM in [bytes] for this VF.
+                       Actual quota value might be aligned per HW/FW requirements.
+
+                       Default is 0 (unprovisioned).
+
+               Writes to these attributes may fail with errors like:
+                       -EINVAL if provided input is malformed or not recognized,
+                       -EPERM if change is not applicable on given HW/FW,
+                       -EIO if FW refuses to change the provisioning.
+
+
 What:          /sys/bus/pci/drivers/xe/.../sriov_admin/vf<n>/stop
 Date:          October 2025
 KernelVersion: 6.19