요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
ABI testing symbols
4
===================
6
Documents interfaces that are felt to be stable,
7
as the main development of this interface has been completed.
9
The interface can be changed to add new features, but the
10
current interface will not break by doing this, unless grave
11
errors or security problems are found in them.
13
Userspace programs can start to rely on these interfaces, but they must
14
be aware of changes that can occur before these interfaces move to
15
be marked stable.
17
Programs that use these interfaces are strongly encouraged to add their
18
name to the description of these interfaces, so that the kernel
19
developers can easily notify them if any changes occur.
21
.. kernel-abi:: testing
22
:no-files:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
시험 ABI symbol
1-22이 GPL-2.0 문서는 주요 개발이 끝나 안정적이라고 여겨지는 testing interface를 설명합니다. 새 기능을 추가할 수 있지만, 중대한 오류나 보안 문제가 발견되지 않는 한 기존 interface는 깨뜨리지 않아야 합니다.
Userspace program은 이 interface에 의존하기 시작할 수 있으나 stable로 승격되기 전에는 변경될 수 있음을 알아야 합니다.
이 interface를 사용하는 program은 설명에 자신의 이름을 추가할 것을 강하게 권장합니다. 그러면 변경이 생길 때 kernel developer가 사용자를 쉽게 통지할 수 있습니다.
.. kernel-abi:: testing
:no-files:Main development complete→Expose as testing→Userspace starts relying on it→Register users in description→Notify changes→Move to stable
Grave error or security issue→Existing interface may change→Notify registered users
기능 개발 종료 뒤 userspace가 의존성을 알리고 stable 승격을 기다리는 흐름입니다.
Testing adoption
abi-testing.rst:1-22Stable 전 단계 interface의 호환성 기대와 변경 통지 방법을 정리합니다.