Device drivers infrastructure | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

infrastructure.rst:1-103

Driver infrastructure page는 device·bus·class·driver object 선언과 base implementation, DMA mapping, PnP, UIO API의 source map입니다. 같은 identifier가 여러 section에서 중복되지 않도록 kernel-doc include·exclude directive도 그대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Device drivers infrastructure

2 =============================

4 The Basic Device Driver-Model Structures

5 ----------------------------------------

7 .. kernel-doc:: include/linux/device.h

8 :internal:

9 :no-identifiers: device_link_state

11 .. kernel-doc:: include/linux/device/bus.h

12 :identifiers: bus_type bus_notifier_event

14 .. kernel-doc:: include/linux/device/class.h

15 :identifiers: class

17 .. kernel-doc:: include/linux/device/driver.h

18 :identifiers: probe_type device_driver

20 Device Drivers Base

21 -------------------

23 .. kernel-doc:: drivers/base/init.c

24 :internal:

26 .. kernel-doc:: include/linux/device/driver.h

27 :no-identifiers: probe_type device_driver

29 .. kernel-doc:: drivers/base/driver.c

30 :export:

32 .. kernel-doc:: drivers/base/core.c

33 :export:

35 .. kernel-doc:: drivers/base/syscore.c

36 :export:

38 .. kernel-doc:: include/linux/device/class.h

39 :no-identifiers: class

41 .. kernel-doc:: drivers/base/class.c

42 :export:

44 .. kernel-doc:: include/linux/device/faux.h

45 :internal:

47 .. kernel-doc:: drivers/base/faux.c

48 :export:

50 .. kernel-doc:: drivers/base/node.c

51 :internal:

53 .. kernel-doc:: drivers/base/transport_class.c

54 :export:

56 .. kernel-doc:: drivers/base/dd.c

57 :export:

59 .. kernel-doc:: include/linux/platform_device.h

60 :internal:

62 .. kernel-doc:: drivers/base/platform.c

63 :export:

65 .. kernel-doc:: include/linux/device/bus.h

66 :no-identifiers: bus_type bus_notifier_event

68 .. kernel-doc:: drivers/base/bus.c

69 :export:

71 Device Drivers DMA Management

72 -----------------------------

74 .. kernel-doc:: kernel/dma/mapping.c

75 :export:

77 Device drivers PnP support

78 --------------------------

80 .. kernel-doc:: drivers/pnp/core.c

81 :internal:

83 .. kernel-doc:: drivers/pnp/card.c

84 :export:

86 .. kernel-doc:: drivers/pnp/driver.c

87 :internal:

89 .. kernel-doc:: drivers/pnp/manager.c

90 :export:

92 .. kernel-doc:: drivers/pnp/support.c

93 :export:

95 Userspace IO devices

96 --------------------

98 .. kernel-doc:: drivers/uio/uio.c

99 :export:

100

101 .. kernel-doc:: include/linux/uio_driver.h

102 :internal:

103

104

3. 한국어 전문 번역

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

기본 driver-model structure

1-19

문서 제목은 `Device drivers infrastructure`입니다. 기본 device driver-model structure section은 `device`, `bus_type`, `bus_notifier_event`, `class`, `probe_type`, `device_driver` 선언을 header별로 문서화합니다. `device_link_state`는 이 internal kernel-doc 범위에서 제외합니다.

.. kernel-doc:: include/linux/device.h
   :internal:
   :no-identifiers: device_link_state

.. kernel-doc:: include/linux/device/bus.h
   :identifiers: bus_type bus_notifier_event

.. kernel-doc:: include/linux/device/class.h
   :identifiers: class

.. kernel-doc:: include/linux/device/driver.h
   :identifiers: probe_type device_driver

Driver-model 기본 header

Source pathIdentifier·범위

include/linux/device.hinternal, device_link_state 제외

include/linux/device/bus.hbus_type, bus_notifier_event

include/linux/device/class.hclass

include/linux/device/driver.hprobe_type, device_driver

핵심 object와 source header를 연결합니다.

Device Drivers Base

20-70

Device Drivers Base section은 base initialization, driver·core·syscore, class, faux device, NUMA node, transport class, device-driver binding, platform device와 bus implementation을 다룹니다.

Header kernel-doc을 다시 포함할 때 이미 기본 structure section에서 문서화한 `probe_type`, `device_driver`, `class`, `bus_type`, `bus_notifier_event`는 `:no-identifiers:`로 제외합니다. Source implementation은 internal 또는 exported 범위를 원문 directive대로 보존합니다.

.. kernel-doc:: drivers/base/init.c
   :internal:

.. kernel-doc:: include/linux/device/driver.h
   :no-identifiers: probe_type device_driver

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

.. kernel-doc:: drivers/base/core.c
   :export:

.. kernel-doc:: drivers/base/syscore.c
   :export:

.. kernel-doc:: include/linux/device/class.h
   :no-identifiers: class

.. kernel-doc:: drivers/base/class.c
   :export:

.. kernel-doc:: include/linux/device/faux.h
   :internal:

.. kernel-doc:: drivers/base/faux.c
   :export:

.. kernel-doc:: drivers/base/node.c
   :internal:

.. kernel-doc:: drivers/base/transport_class.c
   :export:

.. kernel-doc:: drivers/base/dd.c
   :export:

.. kernel-doc:: include/linux/platform_device.h
   :internal:

.. kernel-doc:: drivers/base/platform.c
   :export:

.. kernel-doc:: include/linux/device/bus.h
   :no-identifiers: bus_type bus_notifier_event

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

Driver base source group

영역Source

Initialization·coredrivers/base/init.c, core.c, syscore.c

Driver bindinginclude/linux/device/driver.h, driver.c, dd.c

Class·fauxclass.h, class.c, faux.h, faux.c

Topology·transportnode.c, transport_class.c

Platformplatform_device.h, platform.c

Busdevice/bus.h, drivers/base/bus.c

Base infrastructure를 lifecycle·class·bus 영역으로 묶었습니다.

Device driver DMA management

71-76

Device driver DMA management의 exported kernel-doc source는 `kernel/dma/mapping.c`입니다.

.. kernel-doc:: kernel/dma/mapping.c
   :export:

DMA management source

범위Source path

Exported DMA mappingkernel/dma/mapping.c

DMA mapping exported API 위치입니다.

PnP support

77-94

Device driver Plug and Play support는 PnP core internal API, card exported API, driver internal API, manager·support exported API를 문서화합니다.

.. kernel-doc:: drivers/pnp/core.c
   :internal:

.. kernel-doc:: drivers/pnp/card.c
   :export:

.. kernel-doc:: drivers/pnp/driver.c
   :internal:

.. kernel-doc:: drivers/pnp/manager.c
   :export:

.. kernel-doc:: drivers/pnp/support.c
   :export:

PnP source

Source범위

drivers/pnp/core.cinternal

drivers/pnp/card.cexport

drivers/pnp/driver.cinternal

drivers/pnp/manager.cexport

drivers/pnp/support.cexport

PnP 구성요소별 kernel-doc 범위입니다.

Userspace I/O device

95-103

Userspace I/O device section은 `drivers/uio/uio.c`의 exported implementation과 `include/linux/uio_driver.h`의 internal declaration을 문서화합니다.

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

.. kernel-doc:: include/linux/uio_driver.h
   :internal:

UIO source

Source범위

drivers/uio/uio.cexport

include/linux/uio_driver.hinternal

Core implementation과 driver header입니다.