← Documents Documentation/ABI/testing/sysfs-platform-intel-ifs GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Intel In-Field Scan sysfs ABI

Intel IFS의 Scan Test·Array BIST instance mapping, per-core test 실행, 결과와 test-image batch 관리를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-platform-intel-ifs
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Instance mapping과 per-core 실행

sysfs-platform-intel-ifs:1-24

Instance 0은 Scan Test, instance 1은 Array BIST를 담당하며 online CPU thread 번호로 그 thread가 속한 core 전체를 검사합니다.

Status와 diagnostic details

sysfs-platform-intel-ifs:25-33

Last-test 상태와 STATUS MSR hexadecimal value를 분리해 제공하며 software-defined error code가 포함될 수 있습니다.

Test image version과 batch

sysfs-platform-intel-ifs:34-52

Scan Test instance에서 firmware image version과 0xff 이하의 batch suffix를 관리합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
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
53

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Intel In-Field Scan sysfs ABI: run test

1-16
항목한국어 전문 번역
What/sys/devices/virtual/misc/intel_ifs_<N>/run_test
Date2022년 11월 16일
KernelVersion6.2
Contact"Jithu Joseph" <jithu.joseph@intel.com>
Devicesall
DescriptionDevice instance와 test의 mapping은 `intel_ifs_0 -> Scan Test`, `intel_ifs_1 -> Array BIST test`입니다. `/sys/devices/virtual/misc/intel_ifs_<N>/run_test`에 online core의 `<cpu#>`를 쓰면 해당 core에 대한 IFS test를 시작합니다. Test는 per-core이므로 그 core의 어느 thread 번호를 써도 되며, thread 하나에서 실행하면 그 thread가 속한 core의 test가 완료됩니다. 예를 들어 cpu5가 속한 core는 `echo 5 > /sys/devices/virtual/misc/intel_ifs_<N>/run_test`로 검사합니다.
Intel IFS device mapping
Device instanceTest
intel_ifs_0Scan Test
intel_ifs_1Array BIST test

원문 머리말의 device instance와 test mapping을 보존했습니다.

Per-core IFS test
Choose online cpu#Write cpu# to run_testResolve containing coreComplete test for that core

어느 sibling thread를 지정해도 그 thread가 속한 core 하나를 검사합니다.

echo 5 > /sys/devices/virtual/misc/intel_ifs_<N>/run_test

Intel In-Field Scan sysfs ABI: status

17-24
항목한국어 전문 번역
What/sys/devices/virtual/misc/intel_ifs_<N>/status
Date2022년 11월 16일
KernelVersion6.2
Contact"Jithu Joseph" <jithu.joseph@intel.com>
Devicesall
Description`/sys/devices/virtual/misc/intel_ifs_<N>/status`는 마지막 test의 status를 표시합니다. 값은 `pass`, `fail`, `untested` 중 하나입니다.
Intel IFS status values
ValueMeaning
passLast test passed
failLast test failed
untestedNo completed result

Last-test status가 가질 수 있는 세 값을 정리합니다.

Intel In-Field Scan sysfs ABI: details

25-33
항목한국어 전문 번역
What/sys/devices/virtual/misc/intel_ifs_<N>/details
Date2022년 11월 16일
KernelVersion6.2
Contact"Jithu Joseph" <jithu.joseph@intel.com>
Devicesall
Description`/sys/devices/virtual/misc/intel_ifs_<N>/details`는 마지막 test에 관한 추가 정보를 제공합니다. Details file은 이 test의 `STATUS MSR` hexadecimal value를 보고합니다. `error_code` field에는 Intel SDM에 정의되지 않은 driver-defined software code가 들어갈 수 있습니다.
Intel IFS result files
FileReports
statuspass / fail / untested
detailsSTATUS MSR hexadecimal value and error_code

상태와 low-level diagnostic payload를 서로 다른 files에서 읽습니다.

Intel In-Field Scan sysfs ABI: image version

34-42
항목한국어 전문 번역
What/sys/devices/virtual/misc/intel_ifs_<N>/image_version
Date2022년 11월 16일
KernelVersion6.2
Contact"Jithu Joseph" <jithu.joseph@intel.com>
Devicesintel_ifs_0
Description`/sys/devices/virtual/misc/intel_ifs_<N>/image_version`은 load된 IFS test image의 version을 hexadecimal로 표시합니다. Test image가 load되지 않았으면 `none`을 보고합니다. Test image를 적용할 수 있는 device instance에만 존재합니다.

Intel In-Field Scan sysfs ABI: current batch

43-52
항목한국어 전문 번역
What/sys/devices/virtual/misc/intel_ifs_<N>/current_batch
Date2022년 11월 16일
KernelVersion6.2
Contact"Jithu Joseph" <jithu.joseph@intel.com>
Devicesintel_ifs_0
Description`/sys/devices/virtual/misc/intel_ifs_<N>/current_batch`에 `0xff` 이하의 number를 쓰면 IFS test image를 load합니다. 쓴 number는 `/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scan` filename의 두 자리 suffix로 취급됩니다. File을 읽으면 현재 load된 IFS test image의 suffix를 반환합니다. Test image를 적용할 수 있는 device instance에만 존재합니다.
IFS batch image selection
Write batch <= 0xffUse as two-digit suffix/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scanRead current_batch suffix

0xff 이하의 batch number가 firmware filename suffix와 current_batch readback으로 연결됩니다.