요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Messages reported to the root port
sysfs-bus-pci-devices-aer:93-120AER-capable root port 또는 root complex event collector는 hierarchy와 내부 root port 장치에서 보고된 ERR_COR·ERR_FATAL·ERR_NONFATAL message 누계를 제공합니다.
Log interval and burst
sysfs-bus-pci-devices-aer:121-163Correctable 및 non-fatal uncorrectable error log의 millisecond interval과 interval당 허용 burst를 읽고 조정합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
PCIe Device AER statistics
2
--------------------------
4
These attributes show up under all the devices that are AER capable. These
5
statistical counters indicate the errors "as seen/reported by the device".
6
Note that this may mean that if an endpoint is causing problems, the AER
7
counters may increment at its link partner (e.g. root port) because the
8
errors may be "seen" / reported by the link partner and not the
9
problematic endpoint itself (which may report all counters as 0 as it never
10
saw any problems).
12
What: /sys/bus/pci/devices/<dev>/aer_dev_correctable
13
Date: July 2018
14
KernelVersion: 4.19.0
15
Contact: linux-pci@vger.kernel.org, rajatja@google.com
16
Description: List of correctable errors seen and reported by this
17
PCI device using ERR_COR. Note that since multiple errors may
18
be reported using a single ERR_COR message, thus
19
TOTAL_ERR_COR at the end of the file may not match the actual
20
total of all the errors in the file. Sample output::
22
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_correctable
23
Receiver Error 2
24
Bad TLP 0
25
Bad DLLP 0
26
RELAY_NUM Rollover 0
27
Replay Timer Timeout 0
28
Advisory Non-Fatal 0
29
Corrected Internal Error 0
30
Header Log Overflow 0
31
TOTAL_ERR_COR 2
33
What: /sys/bus/pci/devices/<dev>/aer_dev_fatal
34
Date: July 2018
35
KernelVersion: 4.19.0
36
Contact: linux-pci@vger.kernel.org, rajatja@google.com
37
Description: List of uncorrectable fatal errors seen and reported by this
38
PCI device using ERR_FATAL. Note that since multiple errors may
39
be reported using a single ERR_FATAL message, thus
40
TOTAL_ERR_FATAL at the end of the file may not match the actual
41
total of all the errors in the file. Sample output::
43
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_fatal
44
Undefined 0
45
Data Link Protocol 0
46
Surprise Down Error 0
47
Poisoned TLP 0
48
Flow Control Protocol 0
49
Completion Timeout 0
50
Completer Abort 0
51
Unexpected Completion 0
52
Receiver Overflow 0
53
Malformed TLP 0
54
ECRC 0
55
Unsupported Request 0
56
ACS Violation 0
57
Uncorrectable Internal Error 0
58
MC Blocked TLP 0
59
AtomicOp Egress Blocked 0
60
TLP Prefix Blocked Error 0
61
TOTAL_ERR_FATAL 0
63
What: /sys/bus/pci/devices/<dev>/aer_dev_nonfatal
64
Date: July 2018
65
KernelVersion: 4.19.0
66
Contact: linux-pci@vger.kernel.org, rajatja@google.com
67
Description: List of uncorrectable nonfatal errors seen and reported by this
68
PCI device using ERR_NONFATAL. Note that since multiple errors
69
may be reported using a single ERR_FATAL message, thus
70
TOTAL_ERR_NONFATAL at the end of the file may not match the
71
actual total of all the errors in the file. Sample output::
73
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_nonfatal
74
Undefined 0
75
Data Link Protocol 0
76
Surprise Down Error 0
77
Poisoned TLP 0
78
Flow Control Protocol 0
79
Completion Timeout 0
80
Completer Abort 0
81
Unexpected Completion 0
82
Receiver Overflow 0
83
Malformed TLP 0
84
ECRC 0
85
Unsupported Request 0
86
ACS Violation 0
87
Uncorrectable Internal Error 0
88
MC Blocked TLP 0
89
AtomicOp Egress Blocked 0
90
TLP Prefix Blocked Error 0
91
TOTAL_ERR_NONFATAL 0
93
PCIe Rootport AER statistics
94
----------------------------
96
These attributes show up under only the rootports (or root complex event
97
collectors) that are AER capable. These indicate the number of error messages as
98
"reported to" the rootport. Please note that the rootports also transmit
99
(internally) the ERR_* messages for errors seen by the internal rootport PCI
100
device, so these counters include them and are thus cumulative of all the error
101
messages on the PCI hierarchy originating at that root port.
103
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_cor
104
Date: July 2018
105
KernelVersion: 4.19.0
106
Contact: linux-pci@vger.kernel.org, rajatja@google.com
107
Description: Total number of ERR_COR messages reported to rootport.
109
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_fatal
110
Date: July 2018
111
KernelVersion: 4.19.0
112
Contact: linux-pci@vger.kernel.org, rajatja@google.com
113
Description: Total number of ERR_FATAL messages reported to rootport.
115
What: /sys/bus/pci/devices/<dev>/aer_rootport_total_err_nonfatal
116
Date: July 2018
117
KernelVersion: 4.19.0
118
Contact: linux-pci@vger.kernel.org, rajatja@google.com
119
Description: Total number of ERR_NONFATAL messages reported to rootport.
121
PCIe AER ratelimits
122
-------------------
124
These attributes show up under all the devices that are AER capable.
125
They represent configurable ratelimits of logs per error type.
127
See Documentation/PCI/pcieaer-howto.rst for more info on ratelimits.
129
What: /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_interval_ms
130
Date: May 2025
131
KernelVersion: 6.16.0
132
Contact: linux-pci@vger.kernel.org
133
Description: Writing 0 disables AER correctable error log ratelimiting.
134
Writing a positive value sets the ratelimit interval in ms.
135
Default is DEFAULT_RATELIMIT_INTERVAL (5000 ms).
137
What: /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_burst
138
Date: May 2025
139
KernelVersion: 6.16.0
140
Contact: linux-pci@vger.kernel.org
141
Description: Ratelimit burst for correctable error logs. Writing a value
142
changes the number of errors (burst) allowed per interval
143
before ratelimiting. Reading gets the current ratelimit
144
burst. Default is DEFAULT_RATELIMIT_BURST (10).
146
What: /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_interval_ms
147
Date: May 2025
148
KernelVersion: 6.16.0
149
Contact: linux-pci@vger.kernel.org
150
Description: Writing 0 disables AER non-fatal uncorrectable error log
151
ratelimiting. Writing a positive value sets the ratelimit
152
interval in ms. Default is DEFAULT_RATELIMIT_INTERVAL
153
(5000 ms).
155
What: /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_burst
156
Date: May 2025
157
KernelVersion: 6.16.0
158
Contact: linux-pci@vger.kernel.org
159
Description: Ratelimit burst for non-fatal uncorrectable error logs.
160
Writing a value changes the number of errors (burst)
161
allowed per interval before ratelimiting. Reading gets the
162
current ratelimit burst. Default is DEFAULT_RATELIMIT_BURST
163
(10).
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
장치가 보고한 correctable error
1-32이 속성들은 모든 AER-capable 장치 아래에 나타납니다. 통계 counter는 "장치가 보거나 보고한" 오류를 나타냅니다. Endpoint가 문제를 일으켜도 오류를 endpoint 자체가 아니라 link partner(예: root port)가 보거나 보고하면 link partner의 AER counter가 증가하고, 문제 endpoint는 오류를 보지 못해 모든 counter를 0으로 보고할 수 있습니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_dev_correctable |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | 이 PCI 장치가 ERR_COR로 보고한 correctable error 목록입니다. 하나의 ERR_COR message로 여러 오류를 보고할 수 있으므로 file 끝의 TOTAL_ERR_COR은 file에 있는 개별 오류 수의 실제 합과 일치하지 않을 수 있습니다. |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_correctable
Receiver Error 2
Bad TLP 0
Bad DLLP 0
RELAY_NUM Rollover 0
Replay Timer Timeout 0
Advisory Non-Fatal 0
Corrected Internal Error 0
Header Log Overflow 0
TOTAL_ERR_COR 2장치가 보고한 fatal error
33-62| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_dev_fatal |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | 이 PCI 장치가 ERR_FATAL로 보고한 uncorrectable fatal error 목록입니다. 하나의 ERR_FATAL message로 여러 오류를 보고할 수 있으므로 file 끝의 TOTAL_ERR_FATAL은 개별 오류 수의 실제 합과 일치하지 않을 수 있습니다. |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_fatal
Undefined 0
Data Link Protocol 0
Surprise Down Error 0
Poisoned TLP 0
Flow Control Protocol 0
Completion Timeout 0
Completer Abort 0
Unexpected Completion 0
Receiver Overflow 0
Malformed TLP 0
ECRC 0
Unsupported Request 0
ACS Violation 0
Uncorrectable Internal Error 0
MC Blocked TLP 0
AtomicOp Egress Blocked 0
TLP Prefix Blocked Error 0
TOTAL_ERR_FATAL 0장치가 보고한 nonfatal error
63-92| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_dev_nonfatal |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | 이 PCI 장치가 ERR_NONFATAL로 보고한 uncorrectable nonfatal error 목록입니다. 여러 오류가 하나의 message로 보고될 수 있어 file 끝의 TOTAL_ERR_NONFATAL은 개별 오류 수의 실제 합과 일치하지 않을 수 있습니다. 원문은 이 설명에서 single ERR_FATAL message라고 표기합니다. |
localhost /sys/devices/pci0000:00/0000:00:1c.0 # cat aer_dev_nonfatal
Undefined 0
Data Link Protocol 0
Surprise Down Error 0
Poisoned TLP 0
Flow Control Protocol 0
Completion Timeout 0
Completer Abort 0
Unexpected Completion 0
Receiver Overflow 0
Malformed TLP 0
ECRC 0
Unsupported Request 0
ACS Violation 0
Uncorrectable Internal Error 0
MC Blocked TLP 0
AtomicOp Egress Blocked 0
TLP Prefix Blocked Error 0
TOTAL_ERR_NONFATAL 0Root port ERR_COR message 누계
93-108이 속성들은 AER-capable root port 또는 root complex event collector에만 나타나며 root port에 "보고된" error message 수를 나타냅니다. Root port 자체의 내부 PCI 장치가 본 오류에 대한 ERR_* message도 내부적으로 전송하므로 counter는 해당 root port에서 시작하는 PCI hierarchy의 모든 error message 누계입니다.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_rootport_total_err_cor |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | Root port에 보고된 ERR_COR message의 전체 수입니다. |
Root port ERR_FATAL message 누계
109-114| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_rootport_total_err_fatal |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | Root port에 보고된 ERR_FATAL message의 전체 수입니다. |
Root port ERR_NONFATAL message 누계
115-120| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer_rootport_total_err_nonfatal |
| Date | 2018년 7월 |
| KernelVersion | 4.19.0 |
| Contact | linux-pci@vger.kernel.org, rajatja@google.com |
| Description | Root port에 보고된 ERR_NONFATAL message의 전체 수입니다. |
Correctable error log ratelimit interval
121-136이 속성들은 모든 AER-capable 장치 아래에 나타나며 error 유형별 log ratelimit를 구성합니다. 자세한 내용은 Documentation/PCI/pcieaer-howto.rst를 참조하십시오.
| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_interval_ms |
| Date | 2025년 5월 |
| KernelVersion | 6.16.0 |
| Contact | linux-pci@vger.kernel.org |
| Description | 0을 쓰면 AER correctable error log ratelimiting을 비활성화합니다. 양수를 쓰면 ratelimit interval을 millisecond 단위로 설정합니다. 기본값은 DEFAULT_RATELIMIT_INTERVAL(5000 ms)입니다. |
Correctable error log burst
137-145| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer/correctable_ratelimit_burst |
| Date | 2025년 5월 |
| KernelVersion | 6.16.0 |
| Contact | linux-pci@vger.kernel.org |
| Description | Correctable error log의 ratelimit burst입니다. 쓰면 ratelimiting 전에 interval당 허용할 error 수를 바꾸고 읽으면 현재 burst를 반환합니다. 기본값은 DEFAULT_RATELIMIT_BURST(10)입니다. |
Nonfatal error log ratelimit interval
146-154| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_interval_ms |
| Date | 2025년 5월 |
| KernelVersion | 6.16.0 |
| Contact | linux-pci@vger.kernel.org |
| Description | 0을 쓰면 AER non-fatal uncorrectable error log ratelimiting을 비활성화합니다. 양수를 쓰면 interval을 millisecond 단위로 설정합니다. 기본값은 DEFAULT_RATELIMIT_INTERVAL(5000 ms)입니다. |
Nonfatal error log burst
155-163| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/devices/<dev>/aer/nonfatal_ratelimit_burst |
| Date | 2025년 5월 |
| KernelVersion | 6.16.0 |
| Contact | linux-pci@vger.kernel.org |
| Description | Non-fatal uncorrectable error log의 ratelimit burst입니다. 쓰면 ratelimiting 전에 interval당 허용할 error 수를 바꾸고 읽으면 현재 burst를 반환합니다. 기본값은 DEFAULT_RATELIMIT_BURST(10)입니다. |
Errors seen by the device
sysfs-bus-pci-devices-aer:1-92장치 counter는 장치가 직접 보거나 보고한 오류를 세므로 문제 endpoint 대신 link partner에서 증가할 수 있습니다. Correctable·fatal·nonfatal 목록과 TOTAL counter를 제공합니다.