요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
=================================
2
Linux Security Module Development
3
=================================
5
Based on https://lore.kernel.org/r/[email protected],
6
a new LSM is accepted into the kernel when its intent (a description of
7
what it tries to protect against and in what cases one would expect to
8
use it) has been appropriately documented in ``Documentation/admin-guide/LSM/``.
9
This allows an LSM's code to be easily compared to its goals, and so
10
that end users and distros can make a more informed decision about which
11
LSMs suit their requirements.
13
For extensive documentation on the available LSM hook interfaces, please
14
see ``security/security.c`` and associated structures:
16
.. kernel-doc:: security/security.c
17
:export:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
새 LSM의 문서화와 hook API
1-17새 LSM이 커널에 받아들여지려면 무엇을 방어하려는지, 어떤 상황에서 사용할 것으로 예상하는지에 관한 의도를 `Documentation/admin-guide/LSM/`에 적절히 문서화해야 한다. 이 기준은 lore.kernel.org에 보관된 2007년 논의를 바탕으로 한다.
명확한 목표 문서는 LSM 코드를 그 목표와 쉽게 비교하게 하고, 최종 사용자와 배포판이 요구 사항에 맞는 LSM을 더 잘 선택하게 한다. 사용 가능한 LSM hook 인터페이스의 광범위한 문서는 `security/security.c`와 관련 구조체의 kernel-doc을 `:export:`로 추출해 제공한다.
위협과 사용 사례 정의→admin-guide/LSM에 의도 문서화→구현과 목표 비교→사용자·배포판 적합성 판단→security/security.c hook API 참조
구현 목적을 먼저 문서화해 코드와 정책 목표를 검토할 수 있게 한다.
=================================
Linux Security Module Development
=================================
Based on https://lore.kernel.org/r/[email protected],
a new LSM is accepted into the kernel when its intent (a description of
what it tries to protect against and in what cases one would expect to
use it) has been appropriately documented in ``Documentation/admin-guide/LSM/``.
This allows an LSM's code to be easily compared to its goals, and so
that end users and distros can make a more informed decision about which
LSMs suit their requirements.
For extensive documentation on the available LSM hook interfaces, please
see ``security/security.c`` and associated structures:
.. kernel-doc:: security/security.c
:export:
요약·해설
lsm-development.rst:1-17새 LSM의 위협 모델과 사용 목적 문서화 요건 및 현재 hook API의 기준 소스를 안내합니다.