요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
VFS iomap 문서 색인
1-13이 문서는 GPL-2.0으로 배포되는 VFS iomap 문서군의 색인입니다.
번호가 붙고 최대 깊이가 2인 `toctree`는 library의 기본 설계를 설명하는 `design`, 지원 file operation을 설명하는 `operations`, 기존 파일시스템을 iomap으로 전환하는 방법을 설명하는 `porting` 순서로 연결됩니다.
`design`: iterator·mapping·locking 모델→`operations`: buffered·direct·DAX·seek 연산→`porting`: 기존 filesystem의 iomap 전환
설계에서 연산 계약을 거쳐 이식 지침으로 이어집니다.
.. SPDX-License-Identifier: GPL-2.0
=======================
VFS iomap Documentation
=======================
.. toctree::
:maxdepth: 2
:numbered:
design
operations
porting
요약·해설
index.rst:1-13iomap 문서군은 설계 원칙, operation별 API 계약, 기존 파일시스템의 전환 지침으로 구성됩니다. `design`을 먼저 읽고 `operations`에서 실제 callback과 flag를 확인한 뒤 `porting`을 적용하는 순서입니다.
세 문서가 개념, 구현, 전환을 담당합니다.