PCI Support Library | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

pci.rst:1-56

PCI Support Library는 core·I/O mapping·managed resource·driver·remove·search·MSI·bus·configuration access·IRQ·probe·slot·ROM·IOV·sysfs·TPH와 hotplug core의 kernel-doc을 한 API 페이지로 집계합니다.

문서 구성

원문 줄내용

1-18Core, iomap, devres, driver와 remove

19-36Search, MSI, bus, access, IRQ와 probe

37-51Slot, ROM, IOV, internal sysfs와 TPH

52-56PCI Hotplug core

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기

1 PCI Support Library

2 -------------------

4 .. kernel-doc:: drivers/pci/pci.c

5 :export:

7 .. kernel-doc:: drivers/pci/iomap.c

8 :export:

10 .. kernel-doc:: drivers/pci/devres.c

11 :export:

13 .. kernel-doc:: drivers/pci/pci-driver.c

14 :export:

16 .. kernel-doc:: drivers/pci/remove.c

17 :export:

19 .. kernel-doc:: drivers/pci/search.c

20 :export:

22 .. kernel-doc:: drivers/pci/msi/msi.c

23 :export:

25 .. kernel-doc:: drivers/pci/bus.c

26 :export:

28 .. kernel-doc:: drivers/pci/access.c

29 :export:

31 .. kernel-doc:: drivers/pci/irq.c

32 :export:

34 .. kernel-doc:: drivers/pci/probe.c

35 :export:

37 .. kernel-doc:: drivers/pci/slot.c

38 :export:

40 .. kernel-doc:: drivers/pci/rom.c

41 :export:

43 .. kernel-doc:: drivers/pci/iov.c

44 :export:

46 .. kernel-doc:: drivers/pci/pci-sysfs.c

47 :internal:

49 .. kernel-doc:: drivers/pci/tph.c

50 :export:

52 PCI Hotplug Support Library

53 ---------------------------

55 .. kernel-doc:: drivers/pci/hotplug/pci_hotplug_core.c

56 :export:

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

PCI core, I/O mapping과 managed resource

1-18

PCI Support Library는 여러 PCI subsystem source file의 export된 kernel-doc을 한 페이지에 모읍니다. `drivers/pci/pci.c`는 PCI core 지원 항목을, `drivers/pci/iomap.c`는 PCI I/O mapping 항목을 제공합니다.

`drivers/pci/devres.c`는 device-managed PCI resource 항목을, `drivers/pci/pci-driver.c`는 PCI driver 연결 항목을, `drivers/pci/remove.c`는 장치 제거 경로의 export된 API를 포함합니다.

PCI 지원 source path 1

Source path문서 범위Directive

`drivers/pci/pci.c`PCI core`:export:`

`drivers/pci/iomap.c`I/O mapping`:export:`

`drivers/pci/devres.c`Managed resources`:export:`

`drivers/pci/pci-driver.c`PCI driver core`:export:`

`drivers/pci/remove.c`Device removal`:export:`

PCI Support Library
-------------------

.. kernel-doc:: drivers/pci/pci.c
   :export:

.. kernel-doc:: drivers/pci/iomap.c
   :export:

.. kernel-doc:: drivers/pci/devres.c
   :export:

.. kernel-doc:: drivers/pci/pci-driver.c
   :export:

.. kernel-doc:: drivers/pci/remove.c
   :export:

검색, MSI, bus, config access와 probe

19-36

이 구간은 `drivers/pci/search.c`의 장치 검색, `drivers/pci/msi/msi.c`의 MSI 관리, `drivers/pci/bus.c`의 PCI bus 지원 API를 export된 kernel-doc으로 포함합니다.

또한 `drivers/pci/access.c`의 configuration space 접근, `drivers/pci/irq.c`의 IRQ 지원, `drivers/pci/probe.c`의 장치 탐색과 probe 관련 export 항목을 연결합니다.

PCI 지원 source path 2

Source path문서 범위Directive

`drivers/pci/search.c`Device search`:export:`

`drivers/pci/msi/msi.c`MSI`:export:`

`drivers/pci/bus.c`PCI bus`:export:`

`drivers/pci/access.c`Configuration access`:export:`

`drivers/pci/irq.c`IRQ`:export:`

`drivers/pci/probe.c`Probe and discovery`:export:`

.. kernel-doc:: drivers/pci/search.c
   :export:

.. kernel-doc:: drivers/pci/msi/msi.c
   :export:

.. kernel-doc:: drivers/pci/bus.c
   :export:

.. kernel-doc:: drivers/pci/access.c
   :export:

.. kernel-doc:: drivers/pci/irq.c
   :export:

.. kernel-doc:: drivers/pci/probe.c
   :export:

Slot, ROM, SR-IOV, sysfs와 TPH

37-51

`drivers/pci/slot.c`는 PCI slot, `drivers/pci/rom.c`는 option ROM, `drivers/pci/iov.c`는 I/O virtualization 관련 export된 kernel-doc을 제공합니다.

`drivers/pci/pci-sysfs.c`는 다른 항목과 달리 `:internal:` directive를 사용하여 내부 kernel-doc을 포함합니다. `drivers/pci/tph.c`는 TPH, 즉 TLP Processing Hints 관련 export된 API를 연결합니다.

PCI 지원 source path 3

Source path문서 범위노출

`drivers/pci/slot.c`PCI slotExport

`drivers/pci/rom.c`PCI ROMExport

`drivers/pci/iov.c`SR-IOV and IOVExport

`drivers/pci/pci-sysfs.c`PCI sysfs implementationInternal

`drivers/pci/tph.c`TLP Processing HintsExport

.. kernel-doc:: drivers/pci/slot.c
   :export:

.. kernel-doc:: drivers/pci/rom.c
   :export:

.. kernel-doc:: drivers/pci/iov.c
   :export:

.. kernel-doc:: drivers/pci/pci-sysfs.c
   :internal:

.. kernel-doc:: drivers/pci/tph.c
   :export:

PCI Hotplug 지원 라이브러리

52-56

마지막 절은 PCI Hotplug Support Library입니다. `drivers/pci/hotplug/pci_hotplug_core.c`에서 export된 kernel-doc을 포함하여 hotplug core의 공개 API를 이 페이지에 연결합니다.

Hotplug kernel-doc

Source path범위Directive

`drivers/pci/hotplug/pci_hotplug_core.c`PCI Hotplug core`:export:`

PCI Hotplug Support Library
---------------------------

.. kernel-doc:: drivers/pci/hotplug/pci_hotplug_core.c
   :export: