요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Driver Basics
=============
Driver Entry and Exit points
----------------------------
.. kernel-doc:: include/linux/module.h
:internal:
Driver device table
-------------------
.. kernel-doc:: include/linux/mod_devicetable.h
:internal:
:no-identifiers: pci_device_id
Delaying and scheduling routines
--------------------------------
.. kernel-doc:: include/linux/sched.h
:internal:
.. kernel-doc:: kernel/sched/core.c
:export:
.. kernel-doc:: kernel/sched/cpupri.c
:internal:
.. kernel-doc:: kernel/sched/fair.c
:internal:
.. kernel-doc:: include/linux/completion.h
:internal:
Time and timer routines
-----------------------
.. kernel-doc:: include/linux/jiffies.h
:internal:
.. kernel-doc:: kernel/time/time.c
:export:
.. kernel-doc:: kernel/time/timer.c
:export:
High-resolution timers
----------------------
.. kernel-doc:: include/linux/ktime.h
:internal:
.. kernel-doc:: include/linux/hrtimer.h
:internal:
.. kernel-doc:: kernel/time/hrtimer.c
:export:
Wait queues and Wake events
---------------------------
.. kernel-doc:: include/linux/wait.h
:internal:
.. kernel-doc:: kernel/sched/wait.c
:export:
Internal Functions
------------------
.. kernel-doc:: kernel/exit.c
:internal:
.. kernel-doc:: kernel/signal.c
:internal:
.. kernel-doc:: include/linux/kthread.h
:internal:
.. kernel-doc:: kernel/kthread.c
:export:
Reference counting
------------------
.. kernel-doc:: include/linux/refcount.h
:internal:
.. kernel-doc:: lib/refcount.c
:export:
Atomics
-------
.. kernel-doc:: include/linux/atomic/atomic-instrumented.h
:internal:
.. kernel-doc:: include/linux/atomic/atomic-arch-fallback.h
:internal:
.. kernel-doc:: include/linux/atomic/atomic-long.h
:internal:
Kernel objects manipulation
---------------------------
.. kernel-doc:: lib/kobject.c
:export:
.. kernel-doc:: lib/kobject_uevent.c
:export:
Kernel utility functions
------------------------
.. kernel-doc:: include/linux/kernel.h
:internal:
:no-identifiers: kstrtol kstrtoul
.. kernel-doc:: kernel/printk/printk.c
:export:
:no-identifiers: printk
.. kernel-doc:: kernel/panic.c
:export:
Device Resource Management
--------------------------
.. kernel-doc:: drivers/base/devres.c
:export:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
드라이버 진입점과 종료점
1-9드라이버 기본 사항의 첫 절은 `include/linux/module.h`에 정의된 내부 모듈 API 문서를 포함합니다.
.. kernel-doc:: include/linux/module.h
:internal:드라이버 장치 테이블
10-17이 절은 `include/linux/mod_devicetable.h`의 내부 장치 테이블 API를 포함하되, `pci_device_id` 식별자는 제외합니다.
.. kernel-doc:: include/linux/mod_devicetable.h
:internal:
:no-identifiers: pci_device_id지연 및 스케줄링 루틴
18-35지연 및 스케줄링 절은 `include/linux/sched.h`, `kernel/sched/cpupri.c`, `kernel/sched/fair.c`, `include/linux/completion.h`의 내부 API와 `kernel/sched/core.c`의 export API를 포함합니다.
.. kernel-doc:: include/linux/sched.h
:internal:
.. kernel-doc:: kernel/sched/core.c
:export:
.. kernel-doc:: kernel/sched/cpupri.c
:internal:
.. kernel-doc:: kernel/sched/fair.c
:internal:
.. kernel-doc:: include/linux/completion.h
:internal:시간과 타이머 루틴
36-47시간과 타이머 절은 `include/linux/jiffies.h`의 내부 API와 `kernel/time/time.c`, `kernel/time/timer.c`의 export API를 포함합니다.
.. kernel-doc:: include/linux/jiffies.h
:internal:
.. kernel-doc:: kernel/time/time.c
:export:
.. kernel-doc:: kernel/time/timer.c
:export:고해상도 타이머
48-59고해상도 타이머 절은 `include/linux/ktime.h`, `include/linux/hrtimer.h`의 내부 API와 `kernel/time/hrtimer.c`의 export API를 포함합니다.
.. kernel-doc:: include/linux/ktime.h
:internal:
.. kernel-doc:: include/linux/hrtimer.h
:internal:
.. kernel-doc:: kernel/time/hrtimer.c
:export:대기 큐와 깨우기 이벤트
60-68이 절은 `include/linux/wait.h`의 내부 대기 큐 API와 `kernel/sched/wait.c`의 export API를 포함합니다.
.. kernel-doc:: include/linux/wait.h
:internal:
.. kernel-doc:: kernel/sched/wait.c
:export:내부 함수
69-83내부 함수 절은 `kernel/exit.c`, `kernel/signal.c`, `include/linux/kthread.h`의 내부 API와 `kernel/kthread.c`의 export API를 포함합니다.
.. kernel-doc:: kernel/exit.c
:internal:
.. kernel-doc:: kernel/signal.c
:internal:
.. kernel-doc:: include/linux/kthread.h
:internal:
.. kernel-doc:: kernel/kthread.c
:export:참조 횟수 계산
84-92참조 횟수 계산 절은 `include/linux/refcount.h`의 내부 API와 `lib/refcount.c`의 export API를 포함합니다.
.. kernel-doc:: include/linux/refcount.h
:internal:
.. kernel-doc:: lib/refcount.c
:export:원자적 연산
93-104원자적 연산 절은 `include/linux/atomic/atomic-instrumented.h`, `atomic-arch-fallback.h`, `atomic-long.h`의 내부 API를 포함합니다.
.. kernel-doc:: include/linux/atomic/atomic-instrumented.h
:internal:
.. kernel-doc:: include/linux/atomic/atomic-arch-fallback.h
:internal:
.. kernel-doc:: include/linux/atomic/atomic-long.h
:internal:커널 객체 조작
105-113커널 객체 조작 절은 `lib/kobject.c`와 `lib/kobject_uevent.c`의 export API를 포함합니다.
.. kernel-doc:: lib/kobject.c
:export:
.. kernel-doc:: lib/kobject_uevent.c
:export:커널 유틸리티 함수
114-127커널 유틸리티 절은 `include/linux/kernel.h`의 내부 API를 포함하되 `kstrtol`, `kstrtoul`을 제외합니다.
`kernel/printk/printk.c`의 export API에서는 `printk`를 제외하고, `kernel/panic.c`의 export API도 함께 포함합니다.
.. kernel-doc:: include/linux/kernel.h
:internal:
:no-identifiers: kstrtol kstrtoul
.. kernel-doc:: kernel/printk/printk.c
:export:
:no-identifiers: printk
.. kernel-doc:: kernel/panic.c
:export:장치 리소스 관리
128-133마지막 절은 `drivers/base/devres.c`의 장치 리소스 관리 export API 문서를 포함합니다.
.. kernel-doc:: drivers/base/devres.c
:export:
요약과 해설
basics.rst:1-133드라이버가 사용하는 모듈, 스케줄링, 타이머, 대기 큐, 참조 횟수, 원자적 연산, kobject와 devres API 문서를 연결합니다. 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, directive, C 코드, 함수명, 심볼, 수치, 소스 경로와 원문 줄 좌표를 보존합니다.