요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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 코드, 함수명, 심볼, 수치, 소스 경로와 원문 줄 좌표를 보존합니다.