AMDGPU RAS Support | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

ras.rst:1-62

AMDGPU RAS 문서는 sysfs 정보 조회와 debugfs 오류 주입을 구분하고, 제어·복구 불가능 오류의 재부팅·오류 계수·EEPROM table reset·VRAM bad page 계약을 `amdgpu_ras.c`의 kernel-doc에 연결합니다. libdrm의 `ras_tests.c`는 Basic, Query, Inject, Disable 네 시험 모음을 제공합니다.

RAS 문서 빠른 지도

영역주요 내용

sysfs정보 조회, Error Count, gpu_vram_bad_pages

debugfs오류 주입 제어, EEPROM table reset

오류 복구Unrecoverable Error의 재부팅 동작

libdrm testBasic, Query, Inject, Disable

인터페이스와 시험 목적을 한눈에 구분합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 ====================

2 AMDGPU RAS Support

3 ====================

5 The AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and

6 debugfs (for error injection).

8 RAS debugfs/sysfs Control and Error Injection Interfaces

9 ========================================================

11 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c

12 :doc: AMDGPU RAS debugfs control interface

14 RAS Reboot Behavior for Unrecoverable Errors

15 ============================================

17 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c

18 :doc: AMDGPU RAS Reboot Behavior for Unrecoverable Errors

20 RAS Error Count sysfs Interface

21 ===============================

23 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c

24 :doc: AMDGPU RAS sysfs Error Count Interface

26 RAS EEPROM debugfs Interface

27 ============================

29 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c

30 :doc: AMDGPU RAS debugfs EEPROM table reset interface

32 RAS VRAM Bad Pages sysfs Interface

33 ==================================

35 .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c

36 :doc: AMDGPU RAS sysfs gpu_vram_bad_pages Interface

38 Sample Code

39 ===========

40 Sample code for testing error injection can be found here:

41 https://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c

43 This is part of the libdrm amdgpu unit tests which cover several areas of the GPU.

44 There are four sets of tests:

46 RAS Basic Test

48 The test verifies the RAS feature enabled status and makes sure the necessary sysfs and debugfs files

49 are present.

51 RAS Query Test

53 This test checks the RAS availability and enablement status for each supported IP block as well as

54 the error counts.

56 RAS Inject Test

58 This test injects errors for each IP.

60 RAS Disable Test

62 This test tests disabling of RAS features for each IP block.

3. 한국어 전문 번역

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

RAS 제어와 복구 불가능 오류의 재부팅 동작

1-18

AMDGPU RAS 인터페이스는 정보 조회를 위한 sysfs와 오류 주입을 위한 debugfs를 통해 노출됩니다. 조회와 시험용 오류 주입은 목적과 인터페이스가 다르므로 구분해서 사용합니다.

RAS debugfs/sysfs 제어 및 오류 주입 인터페이스의 세부 계약은 `drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c`의 `AMDGPU RAS debugfs control interface` kernel-doc에서 가져옵니다.

복구할 수 없는 오류가 발생했을 때의 RAS 재부팅 동작은 같은 소스의 `AMDGPU RAS Reboot Behavior for Unrecoverable Errors` kernel-doc가 정의합니다. 이 RST는 해당 계약을 연결하며, 원문에 없는 재부팅 정책은 추가로 추정하지 않습니다.

RAS 인터페이스의 최상위 구분

인터페이스목적

sysfs정보 조회

debugfs오류 주입

원문이 명시한 접근 목적을 sysfs와 debugfs로 나눕니다.

RAS 제어 문서 연결

AMDGPU RAS Support 페이지debugfs/sysfs control and error injection 절amdgpu_ras.c의 AMDGPU RAS debugfs control interface 문서복구 불가능 오류 재부팅 절amdgpu_ras.c의 Reboot Behavior for Unrecoverable Errors 문서

RST 절과 amdgpu_ras.c의 kernel-doc 계약이 연결되는 구조입니다.

====================
 AMDGPU RAS Support
====================

The AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and
debugfs (for error injection).

RAS debugfs/sysfs Control and Error Injection Interfaces
========================================================

.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
   :doc: AMDGPU RAS debugfs control interface

RAS Reboot Behavior for Unrecoverable Errors
============================================

.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
   :doc: AMDGPU RAS Reboot Behavior for Unrecoverable Errors

오류 계수, EEPROM, VRAM bad page 인터페이스

19-36

RAS 오류 계수 sysfs 인터페이스는 `AMDGPU RAS sysfs Error Count Interface` kernel-doc에서 가져옵니다. 이 항목은 RAS 오류 수를 조회하는 sysfs 계약의 소유 위치를 지정합니다.

RAS EEPROM debugfs 인터페이스는 `AMDGPU RAS debugfs EEPROM table reset interface` kernel-doc에 연결됩니다. 이름 그대로 EEPROM table reset에 관한 debugfs 계약이며, 구체적인 쓰기 형식은 연결된 소스 문서가 정의합니다.

RAS VRAM bad page sysfs 인터페이스는 `AMDGPU RAS sysfs gpu_vram_bad_pages Interface` kernel-doc에 연결됩니다. `gpu_vram_bad_pages` 이름과 소스 경로를 그대로 보존하여 실제 구현 문서를 찾을 수 있게 합니다.

RAS 세부 인터페이스 지도

문서 절인터페이스:doc: 선택자

RAS Error CountsysfsAMDGPU RAS sysfs Error Count Interface

RAS EEPROM table resetdebugfsAMDGPU RAS debugfs EEPROM table reset interface

RAS VRAM Bad PagessysfsAMDGPU RAS sysfs gpu_vram_bad_pages Interface

각 문서 절과 kernel-doc 선택자를 정확히 대응시킵니다.

세부 정의 확인 경로

drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c 열기Error Count Interface 문서에서 오류 계수 sysfs 확인EEPROM table reset interface 문서에서 reset용 debugfs 확인gpu_vram_bad_pages Interface 문서에서 VRAM bad page sysfs 확인

모든 계약은 같은 구현 파일 안의 서로 다른 문서 블록에서 가져옵니다.


RAS Error Count sysfs Interface
===============================

.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
   :doc: AMDGPU RAS sysfs Error Count Interface

RAS EEPROM debugfs Interface
============================

.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
   :doc: AMDGPU RAS debugfs EEPROM table reset interface

RAS VRAM Bad Pages sysfs Interface
==================================

.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
   :doc: AMDGPU RAS sysfs gpu_vram_bad_pages Interface

오류 주입 sample code와 Basic Test

37-49

오류 주입 시험용 sample code는 `https://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c`에서 찾을 수 있습니다. 이 코드는 GPU의 여러 영역을 다루는 libdrm amdgpu unit test의 일부입니다.

RAS Basic Test는 RAS 기능의 활성 상태를 검증하고, 필요한 sysfs 및 debugfs 파일이 존재하는지 확인합니다.

Sample code 위치와 소속

항목값

파일tests/amdgpu/ras_tests.c

전체 URLhttps://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c

소속libdrm amdgpu unit tests

범위GPU의 여러 영역

외부 코드 경로와 테스트 모음의 관계를 보존합니다.

RAS Basic Test 확인 범위

RAS 기능 enabled status 확인필요한 sysfs 파일 존재 확인필요한 debugfs 파일 존재 확인

기능 상태와 인터페이스 파일 존재를 순서대로 검사합니다.


Sample Code
===========
Sample code for testing error injection can be found here:
https://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c

This is part of the libdrm amdgpu unit tests which cover several areas of the GPU.
There are four sets of tests:

RAS Basic Test

The test verifies the RAS feature enabled status and makes sure the necessary sysfs and debugfs files
are present.

Query, Inject, Disable Test

50-62

RAS Query Test는 지원되는 각 IP block의 RAS 사용 가능 여부와 활성 상태를 확인하고 오류 계수도 검사합니다.

RAS Inject Test는 각 IP에 오류를 주입합니다. RAS Disable Test는 각 IP block의 RAS 기능 비활성화를 시험합니다.

libdrm RAS 네 테스트

테스트검증 대상

RAS Basic TestRAS 활성 상태와 필요한 sysfs/debugfs 파일 존재

RAS Query Test지원되는 각 IP block의 RAS availability, enablement status, error count

RAS Inject Test각 IP에 대한 오류 주입

RAS Disable Test각 IP block의 RAS 기능 비활성화

원문에 열거된 네 test set과 검증 대상을 모두 정리합니다.

RAS unit test 관점

Basic Test로 기능 및 파일 준비 상태 확인Query Test로 IP block별 availability와 enablement 및 error count 확인Inject Test로 각 IP 오류 주입 동작 시험Disable Test로 각 IP block의 RAS 비활성화 시험

조회, 주입, 비활성화가 서로 다른 검증 목적을 가집니다.


RAS Query Test

This test checks the RAS availability and enablement status for each supported IP block as well as
the error counts.

RAS Inject Test

This test injects errors for each IP.

RAS Disable Test

This test tests disabling of RAS features for each IP block.