GPU Driver Documentation | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

drivers.rst:1-35

Linux kernel의 GPU·DRM·display driver 문서 21개를 `toctree`로 연결하는 최상위 색인입니다. `:maxdepth: 3`, 모든 source path, HTML 하위 프로젝트에서만 나타나는 `genindex` 조건을 원문 그대로 보존해 각 문서군의 시작점을 빠르게 찾을 수 있게 합니다.

문서군 찾기

탐색 목적시작 경로

AMD GPU 문서군amdgpu/index

Intel GPU 문서군i915, xe/index

가상 DRM/KMSvkms, xen-front

GPU·display driverv3d, vc4, panfrost, panthor, komeda-kms

Bridge·compressionbridge/dw-hdmi, afbc

대표적인 탐색 목적과 이 색인에서 확인할 source path입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

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

2 GPU Driver Documentation

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

5 .. toctree::

6 :maxdepth: 3

8 amdgpu/index

9 i915

10 imagination/index

11 mcde

12 meson

13 nouveau

14 pl111

15 tegra

16 tve200

17 v3d

18 vc4

19 vkms

20 bridge/dw-hdmi

21 xen-front

22 xe/index

23 afbc

24 komeda-kms

25 panfrost

26 panthor

27 zynqmp

28 nova/index

30 .. only:: subproject and html

32 Indices

33 =======

35 * :ref:`genindex`

3. 한국어 전문 번역

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

GPU 드라이버 문서와 목차 깊이

1-7

이 페이지는 Linux kernel의 “GPU Driver Documentation”을 한곳에 모으는 최상위 색인입니다. `.. toctree::` 뒤에 나열된 각 경로를 Sphinx 하위 문서로 연결하며, 페이지 자체가 개별 driver의 동작이나 API를 정의하지는 않습니다.

`:maxdepth: 3`은 이 색인에 표시되는 하위 heading의 깊이를 최대 3단계로 제한합니다. 이 값은 문서 파일의 내용이나 경로를 바꾸지 않고 생성되는 목차의 표시 범위만 제어합니다.

GPU 드라이버 색인 설정

요소원문 값의미

페이지 제목GPU Driver DocumentationGPU driver 문서군의 최상위 제목

목차 지시어.. toctree::뒤따르는 source path를 하위 문서로 연결

목차 깊이:maxdepth: 3표시할 하위 heading 깊이를 3단계로 제한

원문 1–7줄에 선언된 제목과 Sphinx option입니다.

========================
GPU Driver Documentation
========================

.. toctree::
   :maxdepth: 3

GPU·디스플레이 드라이버 하위 문서

8-28

목차에는 AMD·Intel·Imagination 계열의 문서 색인과 여러 DRM, GPU, display, bridge driver 문서가 원문 순서대로 포함됩니다. `/index`가 붙은 항목은 해당 driver 문서군의 별도 색인으로 연결되고, 나머지 항목은 같은 이름의 단일 reStructuredText 문서로 연결됩니다.

아래 표는 21개 `toctree` 항목의 source path를 한 글자도 바꾸지 않고 보존합니다. 오른쪽 설명은 경로를 찾기 쉽게 하는 한국어 안내이며, 실제 생성 대상은 왼쪽 원문 경로입니다.

GPU driver toctree 항목

Source path문서 범위

amdgpu/indexAMD GPU 드라이버 문서 색인

i915Intel i915 그래픽 드라이버

imagination/indexImagination GPU 드라이버 문서 색인

mcdeMCDE 디스플레이 드라이버

mesonMeson DRM 드라이버

nouveauNouveau DRM 드라이버

pl111PL111 디스플레이 드라이버

tegraTegra DRM 드라이버

tve200TVE200 디스플레이 드라이버

v3dV3D GPU 드라이버

vc4VC4 DRM 드라이버

vkmsVirtual Kernel Mode-Setting 드라이버

bridge/dw-hdmiDesignWare HDMI bridge

xen-frontXen paravirtualized DRM frontend

xe/indexIntel Xe 드라이버 문서 색인

afbcArm Frame Buffer Compression

komeda-kmsKomeda KMS 드라이버

panfrostPanfrost GPU 드라이버

panthorPanthor GPU 드라이버

zynqmpZynqMP 디스플레이 드라이버

nova/indexNova GPU 드라이버 문서 색인

원문 8–28줄의 순서와 source path를 그대로 유지합니다.

색인의 문서 구성

Vendor GPU driver 문서 색인과 driver별 설계·사용법DRM/KMS display controller와 virtual frontendHDMI bridge와 framebuffer compression 같은 display 구성 요소

하위 문서는 구현 대상과 역할에 따라 다음 범주를 함께 다룹니다.

   amdgpu/index
   i915
   imagination/index
   mcde
   meson
   nouveau
   pl111
   tegra
   tve200
   v3d
   vc4
   vkms
   bridge/dw-hdmi
   xen-front
   xe/index
   afbc
   komeda-kms
   panfrost
   panthor
   zynqmp
   nova/index

HTML 하위 프로젝트의 일반 색인

29-35

`.. only:: subproject and html`은 현재 문서가 Sphinx 하위 프로젝트로 HTML 형식에 빌드될 때만 들여쓴 블록을 포함하라는 조건입니다. 두 조건을 모두 만족하면 “Indices” 절과 일반 색인 링크가 나타납니다.

`genindex` 참조는 Sphinx가 생성한 general index를 가리키는 목록 항목입니다. 따라서 HTML 하위 프로젝트에서는 driver 문서 목차를 읽은 뒤 symbol과 용어의 전체 색인으로 이동할 수 있습니다.

조건부 색인 블록

구문역할

.. only:: subproject and html하위 프로젝트의 HTML 출력에서만 블록 포함

Indices조건부로 표시되는 절 제목

* :ref:`genindex`Sphinx general index로 연결되는 참조

원문 29–35줄의 조건과 참조 대상을 구분합니다.


.. only::  subproject and html

   Indices
   =======

   * :ref:`genindex`