요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
============================================
4
The Linux PCI driver implementer's API guide
5
============================================
7
.. toctree::
8
:caption: Table of contents
9
:maxdepth: 2
11
pci
12
p2pdma
14
.. only:: subproject and html
16
Indices
17
=======
19
* :ref:`genindex`
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Linux PCI 드라이버 구현자 API 안내서
1-13이 문서는 GPL-2.0으로 배포되는 Linux PCI 드라이버 구현자용 API 안내서의 시작 페이지입니다. PCI 코어 지원 라이브러리와 PCI Peer-to-Peer DMA 지원 문서를 하나의 목차로 묶습니다.
Sphinx `toctree`의 caption은 `Table of contents`, 최대 표시 깊이는 2입니다. 하위 문서 `pci`는 PCI 코어와 hotplug kernel-doc API를, `p2pdma`는 장치 사이에서 host memory를 거치지 않는 P2P DMA 설계와 사용법을 다룹니다.
하위 문서범위읽는 목적
`pci`PCI Support Library와 Hotplug코어가 export하는 함수와 source path 확인
`p2pdma`PCI Peer-to-Peer DMAprovider·client·orchestrator 구현
.. SPDX-License-Identifier: GPL-2.0
============================================
The Linux PCI driver implementer's API guide
============================================
.. toctree::
:caption: Table of contents
:maxdepth: 2
pci
p2pdma
HTML 하위 프로젝트의 색인
14-19이 부분은 문서가 HTML 하위 프로젝트로 빌드될 때만 `Indices` 절을 표시합니다. 일반 본문 구조에는 영향을 주지 않으며 생성된 전체 색인 `genindex`로 연결합니다.
Sphinx 조건표시 항목대상
`subproject and html``Indices``genindex`
.. only:: subproject and html
Indices
=======
* :ref:`genindex`
요약과 해설
index.rst:1-19PCI 드라이버 구현자를 위한 시작 페이지로, 코어 지원 라이브러리와 P2P DMA 설계 문서를 깊이 2의 목차로 연결하고 HTML 빌드에서는 전체 색인을 제공합니다.