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