요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Buffer head 개요
1-6Linux는 개별 파일시스템 블록의 상태를 유지하기 위해 buffer head를 사용합니다.
buffer head는 폐기 예정이며 새 파일시스템은 대신 `iomap`을 사용해야 합니다.
API상태권장 대상
buffer head폐기 예정기존 구현 유지보수
`iomap`권장새 파일시스템 구현
새 파일시스템이 따라야 할 권장 방향입니다.
Buffer Heads
============
Linux uses buffer heads to maintain state about individual filesystem blocks.
Buffer heads are deprecated and new filesystems should use iomap instead.
함수 문서의 원천
7-12buffer head 관련 함수 문서는 `include/linux/buffer_head.h`와 `fs/buffer.c`의 kernel-doc 주석에서 생성됩니다. `fs/buffer.c`에서는 export 대상으로 표시된 항목을 포함합니다.
`include/linux/buffer_head.h`의 kernel-doc 읽기→`fs/buffer.c`의 kernel-doc 읽기→`:export:` 대상 선택→Buffer Heads 함수 절 생성
헤더와 구현의 주석이 함수 참조 문서로 합쳐집니다.
Functions
---------
.. kernel-doc:: include/linux/buffer_head.h
.. kernel-doc:: fs/buffer.c
:export:
요약·해설
buffer.rst:1-12buffer head는 개별 파일시스템 블록 상태를 나타내는 기존 인터페이스입니다. 새 파일시스템은 폐기 예정인 buffer head 대신 `iomap`을 사용해야 하며, 기존 함수 참조는 헤더와 `fs/buffer.c`의 kernel-doc에서 생성됩니다.
기존 블록 상태 인터페이스에서 권장 API로의 방향입니다.