요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Status와 diagnostic details
sysfs-platform-intel-ifs:25-33Last-test 상태와 STATUS MSR hexadecimal value를 분리해 제공하며 software-defined error code가 포함될 수 있습니다.
Test image version과 batch
sysfs-platform-intel-ifs:34-52Scan 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
5
What: /sys/devices/virtual/misc/intel_ifs_<N>/run_test
6
Date: Nov 16 2022
7
KernelVersion: 6.2
8
Contact: "Jithu Joseph" <[email protected]>
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
17
What: /sys/devices/virtual/misc/intel_ifs_<N>/status
18
Date: Nov 16 2022
19
KernelVersion: 6.2
20
Contact: "Jithu Joseph" <[email protected]>
21
Description: The status of the last test. It can be one of "pass", "fail"
22
or "untested".
23
Devices: all
25
What: /sys/devices/virtual/misc/intel_ifs_<N>/details
26
Date: Nov 16 2022
27
KernelVersion: 6.2
28
Contact: "Jithu Joseph" <[email protected]>
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
34
What: /sys/devices/virtual/misc/intel_ifs_<N>/image_version
35
Date: Nov 16 2022
36
KernelVersion: 6.2
37
Contact: "Jithu Joseph" <[email protected]>
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
43
What: /sys/devices/virtual/misc/intel_ifs_<N>/current_batch
44
Date: Nov 16 2022
45
KernelVersion: 6.2
46
Contact: "Jithu Joseph" <[email protected]>
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
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Intel In-Field Scan sysfs ABI: run test
1-16| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/virtual/misc/intel_ifs_<N>/run_test |
| Date | 2022년 11월 16일 |
| KernelVersion | 6.2 |
| Contact | "Jithu Joseph" <[email protected]> |
| Devices | all |
| Description | Device 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`로 검사합니다. |
Device instanceTest
intel_ifs_0Scan Test
intel_ifs_1Array BIST test
원문 머리말의 device instance와 test mapping을 보존했습니다.
Choose online cpu#→Write cpu# to run_test→Resolve containing core→Complete test for that core
어느 sibling thread를 지정해도 그 thread가 속한 core 하나를 검사합니다.
echo 5 > /sys/devices/virtual/misc/intel_ifs_<N>/run_testIntel In-Field Scan sysfs ABI: status
17-24| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/virtual/misc/intel_ifs_<N>/status |
| Date | 2022년 11월 16일 |
| KernelVersion | 6.2 |
| Contact | "Jithu Joseph" <[email protected]> |
| Devices | all |
| Description | `/sys/devices/virtual/misc/intel_ifs_<N>/status`는 마지막 test의 status를 표시합니다. 값은 `pass`, `fail`, `untested` 중 하나입니다. |
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 |
| Date | 2022년 11월 16일 |
| KernelVersion | 6.2 |
| Contact | "Jithu Joseph" <[email protected]> |
| Devices | all |
| 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가 들어갈 수 있습니다. |
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 |
| Date | 2022년 11월 16일 |
| KernelVersion | 6.2 |
| Contact | "Jithu Joseph" <[email protected]> |
| Devices | intel_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 |
| Date | 2022년 11월 16일 |
| KernelVersion | 6.2 |
| Contact | "Jithu Joseph" <[email protected]> |
| Devices | intel_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에만 존재합니다. |
Write batch <= 0xff→Use as two-digit suffix→/lib/firmware/intel/ifs_<N>/ff-mm-ss-02x.scan→Read current_batch suffix
0xff 이하의 batch number가 firmware filename suffix와 current_batch readback으로 연결됩니다.
Instance mapping과 per-core 실행
sysfs-platform-intel-ifs:1-24Instance 0은 Scan Test, instance 1은 Array BIST를 담당하며 online CPU thread 번호로 그 thread가 속한 core 전체를 검사합니다.