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

Linux 6.18.37 · ABI / testing

EDAC memory-controller and DIMM sysfs ABI

EDAC memory controller의 reset·CE/UE counters·scrub rate와 DIMM/rank size·type·location·label·error counters를 설명합니다.

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

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

1. 요약·해설

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

Controller reset, identity and capacity

sysfs-devices-edac:1-30

Memory controller는 CE/UE counter와 elapsed timer를 reset하고 reset 이후 seconds, controller type과 managed memory size를 제공합니다.

Controller correctable and uncorrectable errors

sysfs-devices-edac:31-65

Controller-level CE·UE total과 DIMM slot을 특정할 수 없는 noinfo count를 제공하며 CE non-zero 값은 DIMM failure의 조기 신호로 감시해야 합니다.

Scrub bandwidth and memory layout

sysfs-devices-edac:66-85

sdram_scrub_rate는 requested minimum bandwidth를 controller rate로 변환하고 실제 rate를 반환하며 max_location은 userspace가 memory filling layout을 표시하게 합니다.

DIMM and rank metadata

sysfs-devices-edac:86-141

각 DIMM/rank는 size, DRAM device width, EDAC mode, physical label·location과 buffered/unbuffered memory type을 제공합니다.

Per-DIMM error counters

sysfs-devices-edac:142-157

dimm_ce_count와 dimm_ue_count는 특정 DIMM의 correctable·uncorrectable error total을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/devices/system/edac/mc/mc*/reset_counters
2 Date: January 2006
3 Contact: linux-edac@vger.kernel.org
4 Description: This write-only control file will zero all the statistical
5 counters for UE and CE errors on the given memory controller.
6 Zeroing the counters will also reset the timer indicating how
7 long since the last counter were reset. This is useful for
8 computing errors/time. Since the counters are always reset
9 at driver initialization time, no module/kernel parameter
10 is available.
11
12 What: /sys/devices/system/edac/mc/mc*/seconds_since_reset
13 Date: January 2006
14 Contact: linux-edac@vger.kernel.org
15 Description: This attribute file displays how many seconds have elapsed
16 since the last counter reset. This can be used with the error
17 counters to measure error rates.
18
19 What: /sys/devices/system/edac/mc/mc*/mc_name
20 Date: January 2006
21 Contact: linux-edac@vger.kernel.org
22 Description: This attribute file displays the type of memory controller
23 that is being utilized.
24
25 What: /sys/devices/system/edac/mc/mc*/size_mb
26 Date: January 2006
27 Contact: linux-edac@vger.kernel.org
28 Description: This attribute file displays, in count of megabytes, of memory
29 that this memory controller manages.
30
31 What: /sys/devices/system/edac/mc/mc*/ue_count
32 Date: January 2006
33 Contact: linux-edac@vger.kernel.org
34 Description: This attribute file displays the total count of uncorrectable
35 errors that have occurred on this memory controller. If
36 panic_on_ue is set, this counter will not have a chance to
37 increment, since EDAC will panic the system
38
39 What: /sys/devices/system/edac/mc/mc*/ue_noinfo_count
40 Date: January 2006
41 Contact: linux-edac@vger.kernel.org
42 Description: This attribute file displays the number of UEs that have
43 occurred on this memory controller with no information as to
44 which DIMM slot is having errors.
45
46 What: /sys/devices/system/edac/mc/mc*/ce_count
47 Date: January 2006
48 Contact: linux-edac@vger.kernel.org
49 Description: This attribute file displays the total count of correctable
50 errors that have occurred on this memory controller. This
51 count is very important to examine. CEs provide early
52 indications that a DIMM is beginning to fail. This count
53 field should be monitored for non-zero values and report
54 such information to the system administrator.
55
56 What: /sys/devices/system/edac/mc/mc*/ce_noinfo_count
57 Date: January 2006
58 Contact: linux-edac@vger.kernel.org
59 Description: This attribute file displays the number of CEs that
60 have occurred on this memory controller wherewith no
61 information as to which DIMM slot is having errors. Memory is
62 handicapped, but operational, yet no information is available
63 to indicate which slot the failing memory is in. This count
64 field should be also be monitored for non-zero values.
65
66 What: /sys/devices/system/edac/mc/mc*/sdram_scrub_rate
67 Date: February 2007
68 Contact: linux-edac@vger.kernel.org
69 Description: Read/Write attribute file that controls memory scrubbing.
70 The scrubbing rate used by the memory controller is set by
71 writing a minimum bandwidth in bytes/sec to the attribute file.
72 The rate will be translated to an internal value that gives at
73 least the specified rate.
74 Reading the file will return the actual scrubbing rate employed.
75 If configuration fails or memory scrubbing is not implemented,
76 the value of the attribute file will be -1.
77
78 What: /sys/devices/system/edac/mc/mc*/max_location
79 Date: April 2012
80 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
81 linux-edac@vger.kernel.org
82 Description: This attribute file displays the information about the last
83 available memory slot in this memory controller. It is used by
84 userspace tools in order to display the memory filling layout.
85
86 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/size
87 Date: April 2012
88 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
89 linux-edac@vger.kernel.org
90 Description: This attribute file will display the size of dimm or rank.
91 For dimm*/size, this is the size, in MB of the DIMM memory
92 stick. For rank*/size, this is the size, in MB for one rank
93 of the DIMM memory stick. On single rank memories (1R), this
94 is also the total size of the dimm. On dual rank (2R) memories,
95 this is half the size of the total DIMM memories.
96
97 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type
98 Date: April 2012
99 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
100 linux-edac@vger.kernel.org
101 Description: This attribute file will display what type of DRAM device is
102 being utilized on this DIMM (x1, x2, x4, x8, ...).
103
104 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode
105 Date: April 2012
106 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
107 linux-edac@vger.kernel.org
108 Description: This attribute file will display what type of Error detection
109 and correction is being utilized. For example: S4ECD4ED would
110 mean a Chipkill with x4 DRAM.
111
112 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label
113 Date: April 2012
114 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
115 linux-edac@vger.kernel.org
116 Description: This control file allows this DIMM to have a label assigned
117 to it. With this label in the module, when errors occur
118 the output can provide the DIMM label in the system log.
119 This becomes vital for panic events to isolate the
120 cause of the UE event.
121 DIMM Labels must be assigned after booting, with information
122 that correctly identifies the physical slot with its
123 silk screen label. This information is currently very
124 motherboard specific and determination of this information
125 must occur in userland at this time.
126
127 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location
128 Date: April 2012
129 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
130 linux-edac@vger.kernel.org
131 Description: This attribute file will display the location (csrow/channel,
132 branch/channel/slot or channel/slot) of the dimm or rank.
133
134 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type
135 Date: April 2012
136 Contact: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
137 linux-edac@vger.kernel.org
138 Description: This attribute file will display what type of memory is
139 currently on this csrow. Normally, either buffered or
140 unbuffered memory (for example, Unbuffered-DDR3).
141
142 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ce_count
143 Date: October 2016
144 Contact: linux-edac@vger.kernel.org
145 Description: This attribute file displays the total count of correctable
146 errors that have occurred on this DIMM. This count is very important
147 to examine. CEs provide early indications that a DIMM is beginning
148 to fail. This count field should be monitored for non-zero values
149 and report such information to the system administrator.
150
151 What: /sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ue_count
152 Date: October 2016
153 Contact: linux-edac@vger.kernel.org
154 Description: This attribute file displays the total count of uncorrectable
155 errors that have occurred on this DIMM. If panic_on_ue is set, this
156 counter will not have a chance to increment, since EDAC will panic the
157 system
158

3. 한국어 전문 번역

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

Reset controller error counters

1-11
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/reset_counters
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description해당 memory controller의 UE와 CE error statistical counter를 모두 0으로 만드는 write-only control file입니다. Counter를 0으로 만들면 마지막 counter reset 뒤 경과 time을 나타내는 timer도 reset됩니다. 이를 errors/time 계산에 사용할 수 있습니다. Driver initialization 때 counter가 항상 reset되므로 module/kernel parameter는 없습니다.
AccessWrite-only

Seconds since counter reset

12-18
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/seconds_since_reset
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description마지막 counter reset 뒤 경과한 seconds를 표시합니다. Error counter와 함께 error rate를 측정할 수 있습니다.
UnitSeconds

Memory-controller type

19-24
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/mc_name
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description사용 중인 memory controller type을 표시합니다.

Managed memory size

25-30
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/size_mb
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description이 memory controller가 관리하는 memory 양을 megabyte count로 표시합니다.
UnitMegabytes
EDAC rate-measurement cycle
reset_counters writeCE/UE counters = 0seconds_since_reset timer = 0Errors accumulate over timecounter / elapsed seconds로 rate 계산

Counter와 elapsed time을 함께 reset하고 이후 error rate를 계산합니다.

Controller uncorrectable-error count

31-38
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/ue_count
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description이 memory controller에서 발생한 uncorrectable error total count를 표시합니다. panic_on_ue가 set되어 있으면 EDAC가 system을 panic시키므로 이 counter가 증가할 기회를 얻지 못합니다.

Unlocated controller UE count

39-45
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/ue_noinfo_count
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description이 memory controller에서 발생했지만 어느 DIMM slot에 error가 있는지 정보가 없는 UE 수를 표시합니다.

Controller correctable-error count

46-55
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/ce_count
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description이 memory controller에서 발생한 correctable error total count를 표시합니다. CE는 DIMM이 fail하기 시작한다는 조기 신호이므로 이 count는 매우 중요합니다. Non-zero value를 감시하고 system administrator에게 보고해야 합니다.

Unlocated controller CE count

56-65
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/ce_noinfo_count
Date2006년 1월
Contactlinux-edac@vger.kernel.org
Description이 memory controller에서 발생했지만 어느 DIMM slot에 error가 있는지 정보가 없는 CE 수를 표시합니다. Memory는 손상되었지만 operational이며 failing memory가 어느 slot에 있는지 알 수 없습니다. 이 count도 non-zero value를 감시해야 합니다.
EDAC controller error counters
CounterCorrectabilityDIMM slot known
ue_countUncorrectable전체 total
ue_noinfo_countUncorrectableNo
ce_countCorrectable전체 total
ce_noinfo_countCorrectableNo

Correctability와 DIMM-location availability의 두 축으로 counter가 나뉩니다.

EDAC error response
Memory error detectedCorrectable이면 CE counter 증가 및 administrator monitoringUncorrectable이면 UE pathpanic_on_ue set이면 system panic그 경우 ue_count가 증가하지 못할 수 있음

CE는 조기 경고로 감시하고 UE는 panic policy에 따라 counter update 전에 system을 멈출 수 있습니다.

Memory scrubbing bandwidth

66-77
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/sdram_scrub_rate
Date2007년 2월
Contactlinux-edac@vger.kernel.org
DescriptionMemory scrubbing을 control하는 read/write attribute file입니다. Attribute에 minimum bandwidth를 bytes/sec로 쓰면 memory controller가 사용할 scrubbing rate를 설정합니다. Rate는 지정한 rate 이상을 제공하는 internal value로 translate됩니다. Read하면 실제 적용 중인 scrubbing rate를 반환합니다. Configuration이 fail하거나 memory scrubbing을 구현하지 않았으면 -1입니다.
UnitBytes per second
AccessRead/write

Last available memory slot

78-85
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/max_location
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
Description이 memory controller에서 마지막으로 사용할 수 있는 memory slot 정보를 표시합니다. Userspace tool이 memory filling layout을 표시하는 데 사용합니다.
EDAC scrub-rate setting
Minimum bytes/sec writeController internal scrub value 선택지정 rate 이상의 actual scrubbingAttribute read로 actual rate 확인Failure 또는 unsupported이면 -1

Requested minimum bandwidth가 hardware internal rate로 변환되고 actual rate를 다시 읽습니다.

DIMM or rank size

86-96
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/size
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
DescriptionDIMM 또는 rank size를 표시합니다. dimm*/size는 DIMM memory stick의 MB size입니다. rank*/size는 DIMM stick 한 rank의 MB size입니다. Single-rank(1R) memory에서는 DIMM total size와 같고 dual-rank(2R) memory에서는 total DIMM memory size의 절반입니다.
UnitMegabytes
DIMM and rank size relationship
Memory organizationrank*/sizedimm*/size
Single rank (1R)Total DIMM sizeTotal DIMM size
Dual rank (2R)Half of total DIMM sizeTotal DIMM size

rank*/size가 DIMM total에서 차지하는 비율입니다.

DIMM DRAM device width

97-103
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_dev_type
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
Description이 DIMM에서 사용하는 DRAM device type을 표시합니다. 예: x1, x2, x4, x8 등.

DIMM error detection and correction mode

104-111
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_edac_mode
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
Description사용 중인 Error detection and correction type을 표시합니다. 예를 들어 S4ECD4ED는 x4 DRAM을 사용하는 Chipkill을 뜻합니다.

Userspace-assigned physical DIMM label

112-126
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_label
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
DescriptionDIMM에 label을 assign할 수 있는 control file입니다. Module에 label이 있으면 error 발생 시 system log에 DIMM label을 출력할 수 있으며 panic event에서 UE 원인을 isolate하는 데 매우 중요합니다. DIMM label은 boot 뒤 physical slot의 silk-screen label을 정확히 식별하는 정보로 assign해야 합니다. 이 정보는 motherboard마다 매우 달라 현재 userspace에서 결정해야 합니다.
AccessControl file

DIMM or rank location

127-133
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_location
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
DescriptionDIMM 또는 rank location을 표시합니다. 형식은 csrow/channel, branch/channel/slot 또는 channel/slot입니다.

DIMM memory type

134-141
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_mem_type
Date2012년 4월
ContactMauro Carvalho Chehab <mchehab+samsung@kernel.org>, linux-edac@vger.kernel.org
Description현재 이 csrow에 있는 memory type을 표시합니다. 일반적으로 buffered 또는 unbuffered memory입니다. 예: Unbuffered-DDR3.
EDAC DIMM/rank metadata
Attribute내용
sizeDIMM total 또는 one-rank size
dimm_dev_typeDRAM width: x1, x2, x4, x8...
dimm_edac_modeError detection/correction mode
dimm_labelUserspace-assigned physical silk-screen label
dimm_locationcsrow/channel 등 topology location
dimm_mem_typeBuffered/unbuffered generation type

Physical replacement과 error diagnosis에 필요한 identity surface입니다.

Per-DIMM correctable-error count

142-150
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ce_count
Date2016년 10월
Contactlinux-edac@vger.kernel.org
Description이 DIMM에서 발생한 correctable error total count를 표시합니다. CE는 DIMM failure의 조기 신호이므로 non-zero value를 감시하고 system administrator에게 보고해야 합니다.

Per-DIMM uncorrectable-error count

151-157
항목한국어 전문 번역
What/sys/devices/system/edac/mc/mc*/(dimm|rank)*/dimm_ue_count
Date2016년 10월
Contactlinux-edac@vger.kernel.org
Description이 DIMM에서 발생한 uncorrectable error total count를 표시합니다. panic_on_ue가 set되어 있으면 EDAC가 system을 panic시키므로 counter가 증가할 기회를 얻지 못합니다.
Per-DIMM diagnosis
dimm_ce_count 또는 dimm_ue_count 증가dimm_label 확인dimm_location topology 확인System log와 physical silk-screen mapping 대조Failing DIMM isolate

Counter를 physical label과 location에 결합해 failing memory를 교체 대상으로 식별합니다.