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