← Documents Documentation/ABI/testing/sysfs-edac-ecs GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

EDAC DDR5 Error Check Scrub sysfs ABI

DDR5 ECS media FRU의 log scope, row·codeword counting mode, counter reset과 per-Gbit threshold controls를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-edac-ecs
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

FRU-scoped DDR5 error counting

sysfs-edac-ecs:1-74

ECS nodes는 driver callback support에 따라 나타나며 reporting scope와 counting unit을 선택하고 threshold 아래 errors를 mask할 수 있습니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/edac/devices/<dev-name>/ecs_fruX
2 Date: March 2025
3 KernelVersion: 6.15
5 Description:
6 The sysfs EDAC bus devices /<dev-name>/ecs_fruX subdirectory
7 pertains to the memory media ECS (Error Check Scrub) control
8 feature, where <dev-name> directory corresponds to a device
9 registered with the EDAC device driver for the ECS feature.
10 /ecs_fruX belongs to the media FRUs (Field Replaceable Unit)
11 under the memory device.
12
13 The sysfs ECS attr nodes are only present if the parent
14 driver has implemented the corresponding attr callback
15 function and provided the necessary operations to the EDAC
16 device driver during registration.
17
18 What: /sys/bus/edac/devices/<dev-name>/ecs_fruX/log_entry_type
19 Date: March 2025
20 KernelVersion: 6.15
22 Description:
23 (RW) The log entry type of how the DDR5 ECS log is reported.
24
25 - 0 - per DRAM.
26
27 - 1 - per memory media FRU.
28
29 - All other values are reserved.
30
31 What: /sys/bus/edac/devices/<dev-name>/ecs_fruX/mode
32 Date: March 2025
33 KernelVersion: 6.15
35 Description:
36 (RW) The mode of how the DDR5 ECS counts the errors.
37 Error count is tracked based on two different modes
38 selected by DDR5 ECS Control Feature - Codeword mode and
39 Row Count mode. If the ECS is under Codeword mode, then
40 the error count increments each time a codeword with check
41 bit errors is detected. If the ECS is under Row Count mode,
42 then the error counter increments each time a row with
43 check bit errors is detected.
44
45 - 0 - ECS counts rows in the memory media that have ECC errors.
46
47 - 1 - ECS counts codewords with errors, specifically, it counts
48 the number of ECC-detected errors in the memory media.
49
50 - All other values are reserved.
51
52 What: /sys/bus/edac/devices/<dev-name>/ecs_fruX/reset
53 Date: March 2025
54 KernelVersion: 6.15
56 Description:
57 (WO) ECS reset ECC counter.
58
59 - 1 - reset ECC counter to the default value.
60
61 - All other values are reserved.
62
63 What: /sys/bus/edac/devices/<dev-name>/ecs_fruX/threshold
64 Date: March 2025
65 KernelVersion: 6.15
67 Description:
68 (RW) DDR5 ECS threshold count per gigabits of memory cells.
69 The ECS error count is subject to the ECS Threshold count
70 per Gbit, which masks error counts less than the Threshold.
71
72 Supported values are 256, 1024 and 4096.
73
74 All other values are reserved.
75

3. 한국어 전문 번역

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

EDAC ECS media-FRU directory

1-17
항목한국어 전문 번역
What/sys/bus/edac/devices/<dev-name>/ecs_fruX
Date2025년 3월
KernelVersion6.15
Contact[email protected]
Description`/<dev-name>/ecs_fruX` subdirectory는 memory media ECS(Error Check Scrub) control feature에 대응합니다. `<dev-name>`은 ECS feature를 위해 EDAC device driver에 registered된 device이고 `ecs_fruX`는 memory device 아래의 media FRU(Field Replaceable Unit)에 속합니다. Parent driver가 해당 attribute callback function과 필요한 operations를 registration 시 EDAC device driver에 제공한 경우에만 ECS attribute nodes가 나타납니다.
AccessAttribute subdirectory
EDAC ECS attribute exposure
Parent driver implements ECS callbacksDriver registers operations with EDACEDAC creates ecs_fruXSupported ECS attributes appear

Parent driver support가 있을 때만 FRU controls가 sysfs에 노출됩니다.

DDR5 ECS log-entry scope

18-30
항목한국어 전문 번역
What/sys/bus/edac/devices/<dev-name>/ecs_fruX/log_entry_type
Date2025년 3월
KernelVersion6.15
Contact[email protected]
DescriptionDDR5 ECS log가 보고되는 entry scope를 선택합니다. 값 0은 per-DRAM, 값 1은 per-memory-media-FRU reporting이며 다른 모든 값은 reserved입니다.
AccessRead-write
ECS log-entry types
ValueScope
0Per DRAM
1Per memory media FRU
OtherReserved

DDR5 ECS log의 reporting granularity입니다.

DDR5 ECS error-counting mode

31-51
항목한국어 전문 번역
What/sys/bus/edac/devices/<dev-name>/ecs_fruX/mode
Date2025년 3월
KernelVersion6.15
Contact[email protected]
DescriptionDDR5 ECS가 errors를 count하는 mode를 선택합니다. Codeword mode에서는 check-bit error가 있는 codeword를 detect할 때마다 counter가 증가하고 Row Count mode에서는 check-bit error가 있는 row를 detect할 때마다 증가합니다. 값 0은 ECC errors가 있는 memory-media rows를 count하고 값 1은 ECC-detected codeword errors를 count하며 다른 값은 reserved입니다.
AccessRead-write
DDR5 ECS counting modes
ValueModeCounter increments for
0Row CountRows with ECC errors
1CodewordECC-detected codeword errors
OtherReservedNot valid

Counter increment 단위의 차이입니다.

DDR5 ECS counter reset

52-62
항목한국어 전문 번역
What/sys/bus/edac/devices/<dev-name>/ecs_fruX/reset
Date2025년 3월
KernelVersion6.15
Contact[email protected]
DescriptionECS ECC counter를 reset합니다. 값 1을 쓰면 ECC counter를 default value로 reset하며 다른 값은 reserved입니다.
AccessWrite-only
Valid value1

DDR5 ECS threshold per gigabit

63-74
항목한국어 전문 번역
What/sys/bus/edac/devices/<dev-name>/ecs_fruX/threshold
Date2025년 3월
KernelVersion6.15
Contact[email protected]
DescriptionMemory cells의 gigabit당 DDR5 ECS threshold count입니다. ECS error count에는 Gbit당 threshold가 적용되어 threshold보다 작은 counts를 mask합니다. Supported values는 256, 1024, 4096이고 다른 값은 reserved입니다.
AccessRead-write
DDR5 ECS threshold values
Supported valueEffect
256Mask counts below 256 per Gbit
1024Mask counts below 1024 per Gbit
4096Mask counts below 4096 per Gbit

Gbit당 허용 values와 masking behavior입니다.