요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
================================
2
Misc AMDGPU driver information
3
================================
5
GPU Product Information
6
=======================
8
Information about the GPU can be obtained on certain cards
9
via sysfs
11
product_name
12
------------
14
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
15
:doc: product_name
17
product_number
18
--------------
20
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
21
:doc: product_number
23
serial_number
24
-------------
26
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
27
:doc: serial_number
29
fru_id
30
-------------
32
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
33
:doc: fru_id
35
manufacturer
36
-------------
38
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
39
:doc: manufacturer
41
unique_id
42
---------
44
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
45
:doc: unique_id
47
board_info
48
----------
50
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
51
:doc: board_info
53
GPU Memory Usage Information
54
============================
56
Various memory accounting can be accessed via sysfs
58
mem_info_vram_total
59
-------------------
61
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
62
:doc: mem_info_vram_total
64
mem_info_vram_used
65
------------------
67
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
68
:doc: mem_info_vram_used
70
mem_info_vis_vram_total
71
-----------------------
73
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
74
:doc: mem_info_vis_vram_total
76
mem_info_vis_vram_used
77
----------------------
79
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
80
:doc: mem_info_vis_vram_used
82
mem_info_gtt_total
83
------------------
85
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
86
:doc: mem_info_gtt_total
88
mem_info_gtt_used
89
-----------------
91
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
92
:doc: mem_info_gtt_used
94
PCIe Accounting Information
95
===========================
97
pcie_bw
98
-------
100
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
101
:doc: pcie_bw
103
pcie_replay_count
104
-----------------
106
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
107
:doc: pcie_replay_count
109
GPU SmartShift Information
110
==========================
112
GPU SmartShift information via sysfs
114
smartshift_apu_power
115
--------------------
117
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
118
:doc: smartshift_apu_power
120
smartshift_dgpu_power
121
---------------------
123
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
124
:doc: smartshift_dgpu_power
126
smartshift_bias
127
---------------
129
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
130
:doc: smartshift_bias
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
GPU product와 board 식별 정보
1-52일부 GPU card에서는 sysfs를 통해 product와 board 식별 정보를 얻을 수 있습니다. 어떤 항목이 실제로 존재하고 어떤 값을 반환하는지는 해당 card와 source의 kernel-doc 계약에 따릅니다.
Attribute의미Kernel-doc source
product_nameFRU가 제공하는 product 이름amdgpu_fru_eeprom.c
product_numberFRU가 제공하는 product 번호amdgpu_fru_eeprom.c
serial_numberFRU serial 번호amdgpu_fru_eeprom.c
fru_idField Replaceable Unit 식별자amdgpu_fru_eeprom.c
manufacturerFRU manufacturer 정보amdgpu_fru_eeprom.c
unique_idAMDGPU power-management 경로가 제공하는 GPU unique IDamdgpu_pm.c
board_infoAMDGPU device가 제공하는 board 정보amdgpu_device.c
원문 attribute 이름과 의미 범위를 보존했습니다.
FRU EEPROM 지원 여부 확인→product_name, product_number, serial_number, fru_id, manufacturer는 amdgpu_fru_eeprom.c→unique_id는 drivers/gpu/drm/amd/pm/amdgpu_pm.c→board_info는 drivers/gpu/drm/amd/amdgpu/amdgpu_device.c→각 :doc: key의 kernel-doc가 실제 sysfs 형식과 지원 조건 정의
Attribute가 모두 한 file에 있지 않으므로 값의 출처를 구분합니다.
================================
Misc AMDGPU driver information
================================
GPU Product Information
=======================
Information about the GPU can be obtained on certain cards
via sysfs
product_name
------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
:doc: product_name
product_number
--------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
:doc: product_number
serial_number
-------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
:doc: serial_number
fru_id
-------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
:doc: fru_id
manufacturer
-------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_fru_eeprom.c
:doc: manufacturer
unique_id
---------
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
:doc: unique_id
board_info
----------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
:doc: board_info
VRAM, visible VRAM과 GTT accounting
53-93여러 GPU memory accounting 값은 sysfs에서 읽을 수 있습니다. `total`과 `used`를 짝으로 보고, VRAM 전체, CPU에서 visible한 VRAM 영역, GTT라는 서로 다른 memory pool을 구분해야 합니다.
Memory poolTotal attributeUsed attributeSource
VRAMmem_info_vram_totalmem_info_vram_usedamdgpu_vram_mgr.c
Visible VRAMmem_info_vis_vram_totalmem_info_vis_vram_usedamdgpu_vram_mgr.c
GTTmem_info_gtt_totalmem_info_gtt_usedamdgpu_gtt_mgr.c
이 문서는 attribute와 source를 연결하며 구체적 출력 형식은 연결된 kernel-doc에 정의됩니다.
mem_info_vram_total로 전체 VRAM accounting 범위 확인→mem_info_vram_used로 현재 VRAM 사용량 확인→mem_info_vis_vram_total로 visible VRAM 범위 확인→mem_info_vis_vram_used로 visible 영역 사용량 확인→mem_info_gtt_total과 mem_info_gtt_used로 GTT pool 확인→정확한 단위와 지원 조건은 각 :doc: kernel-doc 계약 확인
Pool 이름이 비슷해도 accounting 대상이 다릅니다.
Source path담당 attribute조사 범위
drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.cVRAM total/used, visible VRAM total/usedVRAM allocation과 visible aperture accounting
drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.cGTT total/usedGTT memory manager accounting
VRAM 계열과 GTT 계열의 manager가 다릅니다.
GPU Memory Usage Information
============================
Various memory accounting can be accessed via sysfs
mem_info_vram_total
-------------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
:doc: mem_info_vram_total
mem_info_vram_used
------------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
:doc: mem_info_vram_used
mem_info_vis_vram_total
-----------------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
:doc: mem_info_vis_vram_total
mem_info_vis_vram_used
----------------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
:doc: mem_info_vis_vram_used
mem_info_gtt_total
------------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
:doc: mem_info_gtt_total
mem_info_gtt_used
-----------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
:doc: mem_info_gtt_used
PCIe bandwidth와 replay accounting
94-108PCIe accounting section은 `pcie_bw`와 `pcie_replay_count` 두 sysfs 항목을 연결합니다. 전자는 power-management source가 제공하는 PCIe bandwidth 정보이고, 후자는 AMDGPU device source가 제공하는 PCIe replay count입니다.
Attribute의미 범위Source
pcie_bwPCIe bandwidth accounting 정보drivers/gpu/drm/amd/pm/amdgpu_pm.c
pcie_replay_countPCIe replay event countdrivers/gpu/drm/amd/amdgpu/amdgpu_device.c
서로 다른 source subsystem이 값을 제공하므로 문제 조사 위치도 다릅니다.
Bandwidth 관찰이 필요하면 pcie_bw 확인→Link retry 또는 replay 징후는 pcie_replay_count 확인→pcie_bw 형식과 수집 조건은 amdgpu_pm.c의 :doc: pcie_bw 확인→Replay count 정의는 amdgpu_device.c의 :doc: pcie_replay_count 확인
값의 이상을 발견했을 때 source ownership을 따라갑니다.
PCIe Accounting Information
===========================
pcie_bw
-------
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
:doc: pcie_bw
pcie_replay_count
-----------------
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
:doc: pcie_replay_count
SmartShift power와 bias 정보
109-130GPU SmartShift 정보도 sysfs를 통해 제공됩니다. APU와 dGPU의 power 항목을 분리하고, 두 component 사이의 power 배분 방향을 나타내는 bias 항목을 함께 확인합니다. 실제 값의 형식과 지원 조건은 `amdgpu_pm.c`의 각 kernel-doc가 정의합니다.
Attribute의미 범위Source
smartshift_apu_powerSmartShift에서 관찰하는 APU power 정보drivers/gpu/drm/amd/pm/amdgpu_pm.c
smartshift_dgpu_powerSmartShift에서 관찰하는 dGPU power 정보drivers/gpu/drm/amd/pm/amdgpu_pm.c
smartshift_biasAPU와 dGPU 사이 SmartShift power 배분 biasdrivers/gpu/drm/amd/pm/amdgpu_pm.c
세 항목은 모두 AMDGPU power-management source가 소유합니다.
Platform과 GPU가 SmartShift sysfs를 지원하는지 확인→smartshift_apu_power로 APU 측 power 정보 확인→smartshift_dgpu_power로 discrete GPU 측 power 정보 확인→smartshift_bias로 현재 power 배분 방향 확인→정확한 출력과 변경 가능 여부는 amdgpu_pm.c kernel-doc 기준 적용
Power 두 값과 bias를 같은 시점의 policy 정보로 함께 읽습니다.
GPU SmartShift Information
==========================
GPU SmartShift information via sysfs
smartshift_apu_power
--------------------
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
:doc: smartshift_apu_power
smartshift_dgpu_power
---------------------
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
:doc: smartshift_dgpu_power
smartshift_bias
---------------
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
:doc: smartshift_bias
요약·해설
driver-misc.rst:1-130AMDGPU의 sysfs 기반 product·memory·PCIe·SmartShift 정보를 18개 kernel-doc 항목과 source path에 연결합니다. 이 페이지 자체에 없는 값의 단위나 지원 조건은 추정하지 않고, 각 `:doc:` 계약으로 이동할 수 있는 정확한 탐색표를 제공합니다.
관찰 목적에 따라 attribute group과 source를 선택합니다.