Documentation/driver-api/auxiliary_bus.rst GitHub 원문 ↗

Linux 6.18.37 · Driver API / Device Model

Auxiliary Bus

Auxiliary Bus의 목적과 사용 조건, 장치 생성 및 수명, 드라이버 등록과 사용 예를 연결합니다.

Source pathDocumentation/driver-api/auxiliary_bus.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

auxiliary_bus.rst:1-49

Auxiliary Bus의 목적과 사용 조건, 장치 생성 및 수명, 드라이버 등록과 사용 예를 연결합니다. 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, directive, C 구조체, 함수명, 심볼, 소스 경로와 원문 줄 좌표를 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-only
2
3 .. _auxiliary_bus:
4
5 =============
6 Auxiliary Bus
7 =============
8
9 .. kernel-doc:: drivers/base/auxiliary.c
10 :doc: PURPOSE
11
12 When Should the Auxiliary Bus Be Used
13 =====================================
14
15 .. kernel-doc:: drivers/base/auxiliary.c
16 :doc: USAGE
17
18
19 Auxiliary Device Creation
20 =========================
21
22 .. kernel-doc:: include/linux/auxiliary_bus.h
23 :identifiers: auxiliary_device
24
25 .. kernel-doc:: drivers/base/auxiliary.c
26 :identifiers: auxiliary_device_init __auxiliary_device_add
27
28 Auxiliary Device Memory Model and Lifespan
29 ------------------------------------------
30
31 .. kernel-doc:: include/linux/auxiliary_bus.h
32 :doc: DEVICE_LIFESPAN
33
34
35 Auxiliary Drivers
36 =================
37
38 .. kernel-doc:: include/linux/auxiliary_bus.h
39 :identifiers: auxiliary_driver module_auxiliary_driver
40
41 .. kernel-doc:: drivers/base/auxiliary.c
42 :identifiers: __auxiliary_driver_register auxiliary_driver_unregister
43
44 Example Usage
45 =============
46
47 .. kernel-doc:: drivers/base/auxiliary.c
48 :doc: EXAMPLE
49
50

3. 한국어 전문 번역

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

Auxiliary Bus의 목적

1-11 
.. SPDX-License-Identifier: GPL-2.0-only

.. _auxiliary_bus:

이 절은 Auxiliary Bus의 목적을 설명하는 `drivers/base/auxiliary.c`의 `PURPOSE` kernel-doc 문단을 포함합니다.

.. kernel-doc:: drivers/base/auxiliary.c
   :doc: PURPOSE

Auxiliary Bus를 사용해야 하는 경우

12-18

이 절은 Auxiliary Bus의 사용 조건과 적용 방식을 설명하는 `drivers/base/auxiliary.c`의 `USAGE` kernel-doc 문단을 포함합니다.

.. kernel-doc:: drivers/base/auxiliary.c
   :doc: USAGE

Auxiliary 장치 생성

19-27

Auxiliary 장치 생성 절은 `include/linux/auxiliary_bus.h`의 `auxiliary_device` 자료 구조와 `drivers/base/auxiliary.c`의 `auxiliary_device_init`, `__auxiliary_device_add` 함수 문서를 포함합니다.

.. kernel-doc:: include/linux/auxiliary_bus.h
   :identifiers: auxiliary_device

.. kernel-doc:: drivers/base/auxiliary.c
   :identifiers: auxiliary_device_init __auxiliary_device_add

Auxiliary 장치 메모리 모델과 수명

28-34

이 절은 Auxiliary 장치의 메모리 소유권과 수명 규칙을 설명하는 `include/linux/auxiliary_bus.h`의 `DEVICE_LIFESPAN` kernel-doc 문단을 포함합니다.

.. kernel-doc:: include/linux/auxiliary_bus.h
   :doc: DEVICE_LIFESPAN

Auxiliary 드라이버

35-43

Auxiliary 드라이버 절은 `auxiliary_driver`, `module_auxiliary_driver`, `__auxiliary_driver_register`, `auxiliary_driver_unregister`의 문서를 헤더와 구현 소스에서 가져옵니다.

.. kernel-doc:: include/linux/auxiliary_bus.h
   :identifiers: auxiliary_driver module_auxiliary_driver

.. kernel-doc:: drivers/base/auxiliary.c
   :identifiers: __auxiliary_driver_register auxiliary_driver_unregister

Auxiliary Bus 사용 예

44-49

마지막 절은 `drivers/base/auxiliary.c`의 `EXAMPLE` kernel-doc 문단을 통해 Auxiliary Bus 사용 예를 제공합니다.

.. kernel-doc:: drivers/base/auxiliary.c
   :doc: EXAMPLE