← Documents Documentation/gpu/rfc/index.rst GitHub 원문 ↗

Linux 6.18.37 · GPU·DRM·RFC

GPU RFC Section

GPU uAPI·설계 RFC의 작성·검토·이관 원칙과 문서 목록입니다.

Source pathDocumentation/gpu/rfc/index.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약·해설

index.rst:1-37

GPU uAPI·설계 RFC의 작성·검토·이관 원칙과 문서 목록입니다.

문서 위치
항목
SourceDocumentation/gpu/rfc/index.rst
분량37 source lines
관련gpusvm · i915_vm_bind · i915_scheduler

Source와 관련 symbol입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 ===============
2 GPU RFC Section
3 ===============
4
5 For complex work, especially new uapi, it is often good to nail the high level
6 design issues before getting lost in the code details. This section is meant to
7 host such documentation:
8
9 * Each RFC should be a section in this file, explaining the goal and main design
10 considerations. Especially for uapi make sure you Cc: all relevant project
11 mailing lists and involved people outside of dri-devel.
12
13 * For uapi structures add a file to this directory with and then pull the
14 kerneldoc in like with real uapi headers.
15
16 * Once the code has landed move all the documentation to the right places in
17 the main core, helper or driver sections.
18
19 .. toctree::
20
21 gpusvm.rst
22
23 .. toctree::
24
25 i915_gem_lmem.rst
26
27 .. toctree::
28
29 i915_scheduler.rst
30
31 .. toctree::
32
33 i915_small_bar.rst
34
35 .. toctree::
36
37 i915_vm_bind.rst
38

3. 한국어 전문 번역

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

GPU RFC 작성·이관 원칙

1-37

복잡한 작업, 특히 새 uAPI는 code detail에 빠지기 전에 high-level design issue를 확정하는 편이 좋습니다. 이 section은 그런 RFC 문서를 모읍니다.

각 RFC는 목표와 주요 design consideration을 설명하는 section이어야 합니다. uAPI라면 dri-devel 외에도 관련 project mailing list와 관계자를 모두 CC해야 합니다.

uAPI structure는 이 directory에 별도 file을 추가하고 실제 uAPI header처럼 kernel-doc을 포함합니다.

Code가 merge되면 문서를 main core, helper, driver section의 올바른 위치로 옮깁니다.

Toctree는 `gpusvm.rst`, `i915_gem_lmem.rst`, `i915_scheduler.rst`, `i915_small_bar.rst`, `i915_vm_bind.rst`를 연결합니다.

GPU RFC index
문서주제
gpusvm.rstGPU SVM·MM locking
i915_gem_lmem.rstDG1 local memory·TTM
i915_scheduler.rstGuC submission·DRM scheduler
i915_small_bar.rstCPU-visible device memory
i915_vm_bind.rstPersistent GPU VA mapping

현재 index의 다섯 설계 문서입니다.

RFC lifecycle
Goal·design issue를 RFC로 작성관련 mailing list·사람을 CCUAPI structure와 kernel-doc 추가Review 뒤 code merge문서를 core/helper/driver 정식 section으로 이관

High-level design에서 main documentation으로 이동합니다.

===============
GPU RFC Section
===============

For complex work, especially new uapi, it is often good to nail the high level
design issues before getting lost in the code details. This section is meant to
host such documentation:

* Each RFC should be a section in this file, explaining the goal and main design
  considerations. Especially for uapi make sure you Cc: all relevant project
  mailing lists and involved people outside of dri-devel.

* For uapi structures add a file to this directory with and then pull the
  kerneldoc in like with real uapi headers.

* Once the code has landed move all the documentation to the right places in
  the main core, helper or driver sections.

.. toctree::

    gpusvm.rst

.. toctree::

    i915_gem_lmem.rst

.. toctree::

    i915_scheduler.rst

.. toctree::

    i915_small_bar.rst

.. toctree::

    i915_vm_bind.rst