PCI Support Library | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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: