요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
파일시스템 캐싱 문서 목차
1-12이 문서는 Linux 파일시스템 캐싱 문서군의 최상위 목차입니다. `fscache`는 FS-Cache의 전체 구조와 관찰 인터페이스를, `netfs-api`는 네트워크 파일시스템이 캐시를 사용하는 API를 설명합니다.
`backend-api`는 캐시 백엔드가 구현할 인터페이스를 다루며, `cachefiles`는 로컬 파일시스템을 저장소로 쓰는 CacheFiles 백엔드를 설명합니다. `:maxdepth: 2`는 이 네 문서 아래의 제목을 두 단계까지 목차에 포함하라는 Sphinx 지시입니다.
문서대상핵심 내용
`fscache`사용자·운영자FS-Cache 구조, 통계, 상태와 디버깅
`netfs-api`네트워크 파일시스템volume·cookie 등록, I/O, 일관성, writeback
`backend-api`캐시 백엔드캐시 저장소 구현 계약과 객체 수명
`cachefiles`CacheFiles 운영자로컬 디렉터리 기반 백엔드와 `cachefilesd`
목차 항목과 각 문서가 맡는 인터페이스 경계를 정리합니다.
.. SPDX-License-Identifier: GPL-2.0
Filesystem Caching
==================
.. toctree::
:maxdepth: 2
fscache
netfs-api
backend-api
cachefiles
요약·해설
index.rst:1-12파일시스템 캐싱 문서군은 FS-Cache의 공통 모델, 이를 사용하는 netfs API, 저장소를 구현하는 backend API, 로컬 파일 기반 CacheFiles 구현으로 나뉩니다. 이 목차는 사용 주체별 인터페이스 경계를 찾아가는 출발점입니다.
공통 개념에서 사용 API와 구현 API로 갈라지는 권장 경로입니다.