요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Cycle-duration range aggregation
sysfs-edac-scrub:44-85Region minimum은 backing-device minima의 maximum, region maximum은 maxima의 minimum으로 계산해 모든 devices가 지원하는 공통 range를 만듭니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/edac/devices/<dev-name>/scrubX
2
Date: March 2025
3
KernelVersion: 6.15
4
Contact: [email protected]
5
Description:
6
The sysfs EDAC bus devices /<dev-name>/scrubX subdirectory
7
belongs to an instance of memory scrub control feature,
8
where <dev-name> directory corresponds to a device/memory
9
region registered with the EDAC device driver for the
10
scrub control feature.
12
The sysfs scrub attr nodes are only present if the parent
13
driver has implemented the corresponding attr callback
14
function and provided the necessary operations to the EDAC
15
device driver during registration.
17
What: /sys/bus/edac/devices/<dev-name>/scrubX/addr
18
Date: March 2025
19
KernelVersion: 6.15
20
Contact: [email protected]
21
Description:
22
(RW) The base address of the memory region to be scrubbed
23
for on-demand scrubbing. Setting address starts scrubbing.
24
The size must be set before that.
26
The readback addr value is non-zero if the requested
27
on-demand scrubbing is in progress, zero otherwise.
29
What: /sys/bus/edac/devices/<dev-name>/scrubX/size
30
Date: March 2025
31
KernelVersion: 6.15
32
Contact: [email protected]
33
Description:
34
(RW) The size of the memory region to be scrubbed
35
(on-demand scrubbing).
37
What: /sys/bus/edac/devices/<dev-name>/scrubX/enable_background
38
Date: March 2025
39
KernelVersion: 6.15
40
Contact: [email protected]
41
Description:
42
(RW) Start/Stop background (patrol) scrubbing if supported.
44
What: /sys/bus/edac/devices/<dev-name>/scrubX/min_cycle_duration
45
Date: March 2025
46
KernelVersion: 6.15
47
Contact: [email protected]
48
Description:
49
(RO) Supported minimum scrub cycle duration in seconds
50
by the memory scrubber.
52
Device-based scrub: returns the minimum scrub cycle
53
supported by the memory device.
55
Region-based scrub: returns the max of minimum scrub cycles
56
supported by individual memory devices that back the region.
58
What: /sys/bus/edac/devices/<dev-name>/scrubX/max_cycle_duration
59
Date: March 2025
60
KernelVersion: 6.15
61
Contact: [email protected]
62
Description:
63
(RO) Supported maximum scrub cycle duration in seconds
64
by the memory scrubber.
66
Device-based scrub: returns the maximum scrub cycle supported
67
by the memory device.
69
Region-based scrub: returns the min of maximum scrub cycles
70
supported by individual memory devices that back the region.
72
If the memory device does not provide maximum scrub cycle
73
information, return the maximum supported value of the scrub
74
cycle field.
76
What: /sys/bus/edac/devices/<dev-name>/scrubX/current_cycle_duration
77
Date: March 2025
78
KernelVersion: 6.15
79
Contact: [email protected]
80
Description:
81
(RW) The current scrub cycle duration in seconds and must be
82
within the supported range by the memory scrubber.
84
Scrub has an overhead when running and that may want to be
85
reduced by taking longer to do it.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
EDAC memory-scrub control directory
1-16| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | `/<dev-name>/scrubX` subdirectory는 memory-scrub control feature instance에 대응합니다. `<dev-name>`은 scrub control을 위해 EDAC driver에 registered된 device 또는 memory region입니다. Parent driver가 corresponding callback과 필요한 operations를 registration 시 제공한 경우에만 scrub attribute nodes가 나타납니다. |
| Access | Attribute subdirectory |
On-demand scrub base address
17-28| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/addr |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | On-demand scrubbing 대상 memory region의 base address입니다. 먼저 `size`를 설정한 뒤 address를 쓰면 scrubbing이 시작됩니다. Readback address가 non-zero이면 requested on-demand scrub가 in progress이고 0이면 진행 중이 아닙니다. |
| Access | Read-write |
Set scrub size→Write base address→Scrubbing starts→Read addr: non-zero while active, zero when inactive
Size 설정이 address trigger보다 먼저 와야 합니다.
On-demand scrub region size
29-36| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/size |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | On-demand scrubbing 대상 memory region의 size입니다. `addr`를 써서 scrub를 시작하기 전에 설정해야 합니다. |
| Access | Read-write |
Background memory-scrub control
37-43| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/enable_background |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | 지원되는 경우 background 또는 patrol scrubbing을 시작하거나 중지합니다. |
| Access | Read-write |
Minimum supported scrub-cycle duration
44-57| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/min_cycle_duration |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | Memory scrubber가 지원하는 minimum scrub-cycle duration을 seconds 단위로 반환합니다. Device-based scrub는 해당 memory device의 minimum을 반환하고 region-based scrub는 region을 backing하는 개별 devices의 minimum values 중 maximum을 반환합니다. |
| Access | Read-only |
ScopeReturned value
DeviceDevice minimum
Regionmax(device minima)
Device와 region scope의 계산 차이입니다.
Maximum supported scrub-cycle duration
58-75| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/max_cycle_duration |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | Memory scrubber가 지원하는 maximum scrub-cycle duration을 seconds 단위로 반환합니다. Device-based scrub는 해당 device maximum을 반환하고 region-based scrub는 backing devices의 maximum values 중 minimum을 반환합니다. Device가 maximum 정보 자체를 제공하지 않으면 scrub-cycle field가 표현할 수 있는 maximum supported value를 반환합니다. |
| Access | Read-only |
ScopeReturned value
DeviceDevice maximum
Regionmin(device maxima)
Information unavailableMaximum field value
Device와 region scope의 계산 및 fallback입니다.
Current scrub-cycle duration
76-85| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/edac/devices/<dev-name>/scrubX/current_cycle_duration |
| Date | 2025년 3월 |
| KernelVersion | 6.15 |
| Contact | [email protected] |
| Description | Current scrub-cycle duration을 seconds 단위로 읽고 설정하며 memory scrubber의 supported range 안이어야 합니다. Scrub operation에는 overhead가 있으므로 cycle을 더 오래 수행하도록 설정해 overhead를 줄일 수 있습니다. |
| Access | Read-write |
SettingEffect
Within min/max rangeAccepted
Longer durationLower scrub overhead
Current duration setting의 constraint와 effect입니다.
On-demand and background scrubbing
sysfs-edac-scrub:1-43On-demand scrub는 size를 먼저 설정하고 address write로 시작하며 background patrol scrub는 별도 enable control을 사용합니다.