요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Core subsystem
subsystem-apis.rst:13-25- core-api: 여러 subsystem이 함께 사용하는 기반 API
- driver-api: driver core와 bus, class, power-management framework
- mm: page allocator, virtual memory, reclaim, page cache
- power: suspend, hibernation, runtime PM
- scheduler: task 선택, scheduling class, CPU affinity
- timers: timekeeping, timer wheel, high-resolution timer
- locking: mutual exclusion, memory ordering, lock dependency
Human interface
subsystem-apis.rst:27-38사람이 직접 사용하는 입력과 출력 장치에 가까운 subsystem이다. input, HID, sound, GPU, framebuffer, LED 문서가 포함된다.
Networking interface
subsystem-apis.rst:40-50networking core와 protocol, NetLabel, InfiniBand, ISDN, MHI subsystem을 다룬다. network driver뿐 아니라 packet 처리 경로와 control plane API도 이 범주에서 찾는다.
Storage interface
subsystem-apis.rst:52-63file system, block layer, CD-ROM, SCSI, target mode와 NVMe 문서를 묶는다. file system의 논리적 객체에서 block request와 실제 storage protocol까지 계층을 따라갈 수 있다.
기타 subsystem
subsystem-apis.rst:65-97원문은 이 부분에 조직 작업이 더 필요하다고 명시한다. 아래 목록은 중요도가 낮다는 뜻이 아니라, 아직 더 세밀한 상위 분류가 마련되지 않았다는 뜻이다.
- accounting, CPU frequency, EDAC, FPGA
- I2C, IIO, PCMCIA, SPI, 1-wire
- watchdog, virtualization, hardware monitoring, accelerator
- security, crypto, BPF, USB, PCI
- misc device, PECI, WMI, TEE
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
==============================
Kernel subsystem documentation
==============================
These books get into the details of how specific kernel subsystems work
from the point of view of a kernel developer. Much of the information here
is taken directly from the kernel source, with supplemental material added
as needed (or at least as we managed to add it — probably *not* all that is
needed).
Core subsystems
---------------
.. toctree::
:maxdepth: 1
core-api/index
driver-api/index
mm/index
power/index
scheduler/index
timers/index
locking/index
Human interfaces
----------------
.. toctree::
:maxdepth: 1
input/index
hid/index
sound/index
gpu/index
fb/index
leds/index
Networking interfaces
---------------------
.. toctree::
:maxdepth: 1
networking/index
netlabel/index
infiniband/index
isdn/index
mhi/index
Storage interfaces
------------------
.. toctree::
:maxdepth: 1
filesystems/index
block/index
cdrom/index
scsi/index
target/index
nvme/index
Other subsystems
----------------
**Fixme**: much more organizational work is needed here.
.. toctree::
:maxdepth: 1
accounting/index
cpu-freq/index
edac/index
fpga/index
i2c/index
iio/index
pcmcia/index
spi/index
w1/index
watchdog/index
virt/index
hwmon/index
accel/index
security/index
crypto/index
bpf/index
usb/index
PCI/index
misc-devices/index
peci/index
wmi/index
tee/index
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Kernel subsystem 문서
1-11이 문서 묶음은 kernel 개발자의 관점에서 특정 kernel subsystem이 동작하는 방식을 자세히 설명한다. 많은 내용은 kernel source에서 직접 가져왔고 필요에 따라 보충 설명을 더했다. 다만 필요한 내용이 모두 포함되었다고 보기는 어렵다.
Core subsystem
13-25- Core API
- Driver API
- Memory management
- Power management
- Scheduler
- Timer
- Locking
Human interface
27-38- Input
- HID
- Sound
- GPU
- Framebuffer
- LED
Networking interface
40-50- Networking
- NetLabel
- InfiniBand
- ISDN
- MHI
Storage interface
52-63- Filesystem
- Block layer
- CD-ROM
- SCSI
- Target
- NVMe
그 밖의 subsystem
65-93이 영역은 훨씬 더 많은 분류 작업이 필요하다. 현재 accounting, CPU frequency, EDAC, FPGA, I2C, IIO, PCMCIA, SPI, 1-Wire, watchdog, virtualization, hardware monitoring, accelerator, security, crypto, BPF, USB, PCI, misc device, PECI, WMI, TEE 문서를 포함한다.
Subsystem 문서가 다루는 범위
subsystem-apis.rst:1-11이 문서 묶음은 특정 커널 subsystem이 내부에서 어떻게 동작하는지를 커널 개발자의 관점에서 설명한다. 상당한 내용은 source code에서 직접 추출되며, 필요한 곳에는 별도의 설명이 보충된다.
다만 보충 설명이 필요한 모든 부분을 이미 채웠다는 뜻은 아니다. source와 문서 사이에 차이가 있다면 source와 해당 subsystem maintainer의 설명을 함께 확인해야 한다.