xref: /linux/Documentation/ABI/testing/sysfs-platform-intel-ifs (revision cbdb1f163af2bb90d01be1f0263df1d8d5c9d9d3)
1What:		/sys/devices/virtual/misc/intel_ifs_<N>/run_test
2Date:		Nov 16 2022
3KernelVersion:	6.2
4Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
5Description:	Write <cpu#> to trigger IFS test for one online core.
6		Note that the test is per core. The cpu# can be
7		for any thread on the core. Running on one thread
8		completes the test for the core containing that thread.
9		Example: to test the core containing cpu5: echo 5 >
10		/sys/devices/virtual/misc/intel_ifs_<N>/run_test
11
12What:		/sys/devices/virtual/misc/intel_ifs_<N>/status
13Date:		Nov 16 2022
14KernelVersion:	6.2
15Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
16Description:	The status of the last test. It can be one of "pass", "fail"
17		or "untested".
18
19What:		/sys/devices/virtual/misc/intel_ifs_<N>/details
20Date:		Nov 16 2022
21KernelVersion:	6.2
22Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
23Description:	Additional information regarding the last test. The details file reports
24		the hex value of the SCAN_STATUS MSR. Note that the error_code field
25		may contain driver defined software code not defined in the Intel SDM.
26
27What:		/sys/devices/virtual/misc/intel_ifs_<N>/image_version
28Date:		Nov 16 2022
29KernelVersion:	6.2
30Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
31Description:	Version (hexadecimal) of loaded IFS binary image. If no scan image
32		is loaded reports "none".
33
34What:		/sys/devices/virtual/misc/intel_ifs_<N>/current_batch
35Date:		Nov 16 2022
36KernelVersion:	6.2
37Contact:	"Jithu Joseph" <jithu.joseph@intel.com>
38Description:	Write a number less than or equal to 0xff to load an IFS test image.
39		The number written treated as the 2 digit suffix in the following file name:
40		/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scan
41		Reading the file will provide the suffix of the currently loaded IFS test image.
42