From: Ehab Ababneh <ehab.ababneh@intel.com>
To: ilpo.jarvinen@linux.intel.com, hansg@kernel.org, tony.luck@intel.com
Cc: ashok.raj.linux@gmail.com, platform-driver-x86@vger.kernel.org,
linux-kernel@vger.kernel.org, tglx@kernel.org, mingo@redhat.com,
bp@alien8.de, dave.hansen@linux.intel.com, x86@kernel.org,
hpa@zytor.com, rostedt@goodmis.org, mhiramat@kernel.org,
mathieu.desnoyers@efficios.com,
linux-trace-kernel@vger.kernel.org, peterz@infradead.org,
sathyanarayanan.kuppuswamy@linux.intel.com
Subject: [PATCH v3 17/17] Documentation/ABI: Update IFS ABI doc
Date: Fri, 20 Nov 2026 10:56:58 -0700 [thread overview]
Message-ID: <20261120175658.1147030-18-ehab.ababneh@intel.com> (raw)
In-Reply-To: <20261120175658.1147030-1-ehab.ababneh@intel.com>
From: Qiuxu Zhuo <qiuxu.zhuo@intel.com>
Add documentation for the new sysfs interfaces {status, details,
additional_details, cpus_ran}_list.
Signed-off-by: Qiuxu Zhuo <qiuxu.zhuo@intel.com>
Signed-off-by: Ehab Ababneh <ehab.ababneh@intel.com>
Tested-by: Yi Lai <yi1.lai@intel.com>
---
.../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@intel.com>
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@intel.com>
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@intel.com>
+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@intel.com>
+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@intel.com>
+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@intel.com>
+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
prev parent reply other threads:[~2026-11-20 17:54 UTC|newest]
Thread overview: 18+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-20 17:56 [PATCH v3 00/17] platform/x86/intel/ifs: Support group-based In-Field Scan and Diamond Rapids Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 01/17] platform/x86/intel/ifs: Revert SBAF feature Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 02/17] platform/x86/intel/ifs: Fix IFS sysfs interfaces in the comments Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 03/17] platform/x86/intel/ifs: Clarify In-Field Scan MSR bit macro definitions Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 04/17] platform/x86/intel/ifs: Use u64 to define the bits of IFS MSR registers Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 05/17] platform/x86/intel/ifs: Early return on the IFS image hash/chunk error Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 06/17] platform/x86/intel/ifs: Refactor Array BIST function interface Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 07/17] stop_machine: Add stop_cluster_cpuslocked() for per-cluster operations Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 08/17] platform/x86/intel/ifs: Enumerate the bit to determine if CPUs need to join for IFS tests Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 09/17] platform/x86/intel/ifs: Select CPUs from topology_cluster_cpumask() for simultaneous " Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 10/17] platform/x86/intel/ifs: Warn if a group test fails with CPUs missing Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 11/17] platform/x86/intel/ifs: Track and report scan results on a per-CPU basis Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 12/17] platform/x86/intel/ifs: Add new sysfs interfaces {status, details, cpus_ran}_list Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 13/17] platform/x86/intel/ifs: Add additional details sysfs interface Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 14/17] platform/x86/intel/ifs: Add Intel Diamond Rapids server support Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 15/17] platform/x86/intel/ifs: Remove limit on number of batch files Ehab Ababneh
2026-11-20 17:56 ` [PATCH v3 16/17] platform/x86/intel/ifs: Update IFS documentation Ehab Ababneh
2026-11-20 17:56 ` Ehab Ababneh [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261120175658.1147030-18-ehab.ababneh@intel.com \
--to=ehab.ababneh@intel.com \
--cc=ashok.raj.linux@gmail.com \
--cc=bp@alien8.de \
--cc=dave.hansen@linux.intel.com \
--cc=hansg@kernel.org \
--cc=hpa@zytor.com \
--cc=ilpo.jarvinen@linux.intel.com \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-trace-kernel@vger.kernel.org \
--cc=mathieu.desnoyers@efficios.com \
--cc=mhiramat@kernel.org \
--cc=mingo@redhat.com \
--cc=peterz@infradead.org \
--cc=platform-driver-x86@vger.kernel.org \
--cc=rostedt@goodmis.org \
--cc=sathyanarayanan.kuppuswamy@linux.intel.com \
--cc=tglx@kernel.org \
--cc=tony.luck@intel.com \
--cc=x86@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox