요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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로의 방향입니다.