← Documents Documentation/ABI/testing/sysfs-driver-qat_ras GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Intel QAT RAS error-counter sysfs ABI

Intel QAT device가 감지한 correctable·non-fatal·fatal error counters를 읽고 write-only control로 세 counters를 함께 reset하는 방법을 설명합니다.

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

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

1. 요약·해설

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

Correctable, non-fatal and fatal counters

sysfs-driver-qat_ras:1-24

qat_ras directory는 device가 감지한 correctable, non-fatal, fatal errors의 누적 개수를 세 read-only attributes로 구분합니다.

Reset all error counters

sysfs-driver-qat_ras:25-41

reset_error_counters에 쓰면 세 error counter를 모두 0으로 reset하며 qat_4xxx와 qat_6xxx에서만 사용할 수 있습니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
2 Date: January 2024
3 KernelVersion: 6.7
4 Contact: qat-linux@intel.com
5 Description: (RO) Reports the number of correctable errors detected by the device.
6
7 This attribute is only available for qat_4xxx and qat_6xxx devices.
8
9 What: /sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
10 Date: January 2024
11 KernelVersion: 6.7
12 Contact: qat-linux@intel.com
13 Description: (RO) Reports the number of non fatal errors detected by the device.
14
15 This attribute is only available for qat_4xxx and qat_6xxx devices.
16
17 What: /sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
18 Date: January 2024
19 KernelVersion: 6.7
20 Contact: qat-linux@intel.com
21 Description: (RO) Reports the number of fatal errors detected by the device.
22
23 This attribute is only available for qat_4xxx and qat_6xxx devices.
24
25 What: /sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
26 Date: January 2024
27 KernelVersion: 6.7
28 Contact: qat-linux@intel.com
29 Description: (WO) Write to resets all error counters of a device.
30
31 The following example reports how to reset the counters::
32
33 # echo 1 > /sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
34 # cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
35 0
36 # cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
37 0
38 # cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
39 0
40
41 This attribute is only available for qat_4xxx and qat_6xxx devices.
42

3. 한국어 전문 번역

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

Correctable error count

1-8
항목한국어 전문 번역
What/sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
Date2024년 1월
KernelVersion6.7
Contactqat-linux@intel.com
DescriptionDevice가 감지한 correctable errors의 수를 보고합니다. 이 attribute는 qat_4xxx와 qat_6xxx devices에서만 사용할 수 있습니다.
AccessRead-only
QAT RAS error counters
AttributeDetected errorsAccess
errors_correctableCorrectableRead-only
errors_nonfatalNon-fatalRead-only
errors_fatalFatalRead-only
reset_error_countersReset all three countersWrite-only

세 severity classes와 공통 reset control을 정리했습니다.

Non-fatal error count

9-16
항목한국어 전문 번역
What/sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
Date2024년 1월
KernelVersion6.7
Contactqat-linux@intel.com
DescriptionDevice가 감지한 non-fatal errors의 수를 보고합니다. 이 attribute는 qat_4xxx와 qat_6xxx devices에서만 사용할 수 있습니다.
AccessRead-only

Fatal error count

17-24
항목한국어 전문 번역
What/sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
Date2024년 1월
KernelVersion6.7
Contactqat-linux@intel.com
DescriptionDevice가 감지한 fatal errors의 수를 보고합니다. 이 attribute는 qat_4xxx와 qat_6xxx devices에서만 사용할 수 있습니다.
AccessRead-only

Reset all QAT RAS counters

25-41
항목한국어 전문 번역
What/sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
Date2024년 1월
KernelVersion6.7
Contactqat-linux@intel.com
Description이 attribute에 쓰면 device의 모든 error counters를 reset합니다. 아래 example은 1을 쓴 뒤 correctable, non-fatal, fatal counters가 모두 0임을 확인합니다. 이 attribute는 qat_4xxx와 qat_6xxx devices에서만 사용할 수 있습니다.
AccessWrite-only
# echo 1 > /sys/bus/pci/devices/<BDF>/qat_ras/reset_error_counters
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_correctable
0
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_nonfatal
0
# cat /sys/bus/pci/devices/<BDF>/qat_ras/errors_fatal
0