[PATCH v3 17/17] Documentation/ABI: Update IFS ABI doc
From: Ehab Ababneh
Date: Fri Nov 20 2026 - 12:57:20 EST
From: Qiuxu Zhuo <qiuxu.zhuo@xxxxxxxxx>
Add documentation for the new sysfs interfaces {status, details,
additional_details, cpus_ran}_list.
Signed-off-by: Qiuxu Zhuo <qiuxu.zhuo@xxxxxxxxx>
Signed-off-by: Ehab Ababneh <ehab.ababneh@xxxxxxxxx>
Tested-by: Yi Lai <yi1.lai@xxxxxxxxx>
---
.../ABI/testing/sysfs-platform-intel-ifs | 34 +++++++++++++++++++
1 file changed, 34 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-platform-intel-ifs b/Documentation/ABI/testing/sysfs-platform-intel-ifs
index 2b922c2cd821..519ad83a89f9 100644
--- a/Documentation/ABI/testing/sysfs-platform-intel-ifs
+++ b/Documentation/ABI/testing/sysfs-platform-intel-ifs
@@ -22,6 +22,10 @@ KernelVersion: 6.2
Contact: "Jithu Joseph" <jithu.joseph@xxxxxxxxx>
Description: The status of the last test. It can be one of "pass", "fail"
or "untested".
+ When the test ran on a group of CPUs (see cpus_ran_list), it
+ is "pass" only if all of them passed. Otherwise it is "fail"
+ if any CPU failed, or "untested" if any CPU was not fully
+ tested. status_list shows the result of each CPU.
Devices: all
What: /sys/devices/virtual/misc/intel_ifs_<N>/details
@@ -31,6 +35,8 @@ Contact: "Jithu Joseph" <jithu.joseph@xxxxxxxxx>
Description: Additional information regarding the last test. The details file reports
the hex value of the STATUS MSR for this test. Note that the error_code field
may contain driver defined software code not defined in the Intel SDM.
+ When a group test did not pass, the details are for the first
+ CPU with the reported status (see details_list).
Devices: all
What: /sys/devices/virtual/misc/intel_ifs_<N>/image_version
@@ -56,3 +62,31 @@ Description: Write a number to load an IFS test image.
Reading the file will provide the suffix of the currently loaded IFS test image.
This file is present only for device instances where a test image is applicable.
Devices: intel_ifs_0
+
+What: /sys/devices/virtual/misc/intel_ifs_<N>/cpus_ran_list
+Date: Mar 3 2025
+Contact: "Qiuxu Zhuo" <qiuxu.zhuo@xxxxxxxxx>
+Description: The CPU list of the last test. These CPUs share the same SCAN
+ test engine.
+Devices: intel_ifs_0
+
+What: /sys/devices/virtual/misc/intel_ifs_<N>/status_list
+Date: Mar 3 2025
+Contact: "Qiuxu Zhuo" <qiuxu.zhuo@xxxxxxxxx>
+Description: The status list of the last test for CPUs sharing the same
+ SCAN test engine.
+Devices: intel_ifs_0
+
+What: /sys/devices/virtual/misc/intel_ifs_<N>/details_list
+Date: Mar 3 2025
+Contact: "Qiuxu Zhuo" <qiuxu.zhuo@xxxxxxxxx>
+Description: The detail status list of the last test for CPUs sharing the
+ same SCAN test engine.
+Devices: intel_ifs_0
+
+What: /sys/devices/virtual/misc/intel_ifs_<N>/addnl_details_list
+Date: Mar 3 2025
+Contact: "Qiuxu Zhuo" <qiuxu.zhuo@xxxxxxxxx>
+Description: The additional detail status list of the last test for CPUs
+ sharing the same SCAN test engine.
+Devices: intel_ifs_0
--
2.43.0