요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
XFS 파일시스템 문서와 목차 설정
1-9이 문서는 `GPL-2.0`으로 배포되는 “XFS 파일시스템 문서” 색인입니다. 본문 기능을 직접 설명하는 대신 XFS의 logging, 유지보수 절차, metadata 검증, online filesystem check 설계 문서를 하나의 번호 매긴 목차로 묶습니다.
`.. toctree::`는 뒤에 나오는 문서 이름을 Sphinx 목차에 연결합니다. `:maxdepth: 2`는 목차에 표시할 하위 heading 깊이를 2단계로 제한하고, `:numbered:`는 포함된 문서와 절에 번호를 부여합니다. 이 option들은 원문 내용이나 파일 이름을 바꾸지 않고 렌더링되는 목차 구조만 제어합니다.
원문 1–9줄에서 선언하는 요소를 구분합니다.
.. SPDX-License-Identifier: GPL-2.0
============================
XFS Filesystem Documentation
============================
.. toctree::
:maxdepth: 2
:numbered:XFS 설계·유지보수 문서 읽기 순서
10-14첫 항목 `xfs-delayed-logging-design`은 XFS journalling subsystem의 transaction, reservation, relogging, delayed logging 설계를 설명합니다. 두 번째 `xfs-maintainer-entry-profile`은 kernel code, userspace tools, tests, on-disk format 문서의 저장소와 patch 제출·검토 역할을 정리합니다.
세 번째 `xfs-self-describing-metadata`는 대규모 XFS에서 metadata 구조를 식별하고 검증하기 위한 self-describing metadata 설계를 다룹니다. 마지막 `xfs-online-fsck-design`은 filesystem을 online 상태에서 검사하는 기능의 목표, 설계 판단, 구현 시 고려사항을 기록합니다.
색인의 파일 이름과 실제 문서 초점의 대응입니다.
원문 toctree 순서를 그대로 따릅니다.
xfs-delayed-logging-design
xfs-maintainer-entry-profile
xfs-self-describing-metadata
xfs-online-fsck-design
요약·해설
index.rst:1-14XFS의 logging 설계, maintainer workflow, self-describing metadata, online fsck 설계를 번호가 붙는 Sphinx 목차로 연결하는 최상위 색인입니다. 네 파일 이름과 `toctree` option을 원문 그대로 보존하면서 각 문서가 담당하는 범위를 한국어로 안내합니다.
조사하려는 XFS 영역에 맞는 하위 문서를 선택합니다.