Key-agreement Protocol Primitives (KPP) | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

api-kpp.rst:1-41

KPP API는 key-agreement transform을 할당하고 secret을 설정한 뒤 public key를 생성하거나 shared secret을 계산하는 asynchronous request interface를 제공합니다.

ECDH와 DH helper는 algorithm별 secret structure의 길이 계산과 binary key encode·decode를 지원합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 Key-agreement Protocol Primitives (KPP)

2 =======================================

4 Key-agreement Protocol Primitives (KPP) Cipher Algorithm Definitions

5 --------------------------------------------------------------------

7 .. kernel-doc:: include/crypto/kpp.h

8 :functions: kpp_request crypto_kpp kpp_alg kpp_secret

10 Key-agreement Protocol Primitives (KPP) Cipher API

11 --------------------------------------------------

13 .. kernel-doc:: include/crypto/kpp.h

14 :doc: Generic Key-agreement Protocol Primitives API

16 .. kernel-doc:: include/crypto/kpp.h

   :functions: crypto_alloc_kpp crypto_free_kpp crypto_kpp_set_secret crypto_kpp_generate_public_key crypto_kpp_compute_shared_secret crypto_kpp_maxsize

19 Key-agreement Protocol Primitives (KPP) Cipher Request Handle

20 -------------------------------------------------------------

22 .. kernel-doc:: include/crypto/kpp.h

23 :functions: kpp_request_alloc kpp_request_free kpp_request_set_callback kpp_request_set_input kpp_request_set_output

25 ECDH Helper Functions

26 ---------------------

28 .. kernel-doc:: include/crypto/ecdh.h

29 :doc: ECDH Helper Functions

31 .. kernel-doc:: include/crypto/ecdh.h

32 :functions: ecdh crypto_ecdh_key_len crypto_ecdh_encode_key crypto_ecdh_decode_key

34 DH Helper Functions

35 -------------------

37 .. kernel-doc:: include/crypto/dh.h

38 :doc: DH Helper Functions

40 .. kernel-doc:: include/crypto/dh.h

41 :functions: dh crypto_dh_key_len crypto_dh_encode_key crypto_dh_decode_key

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Key-agreement Protocol Primitive

1-3

Key-agreement Protocol Primitive(KPP, key 합의 protocol primitive)

KPP cipher algorithm 정의

4-9

Key-agreement Protocol Primitive(KPP) cipher algorithm 정의

`include/crypto/kpp.h`의 `kpp_request`, `crypto_kpp`, `kpp_alg`, `kpp_secret` kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/kpp.h
   :functions: kpp_request crypto_kpp kpp_alg kpp_secret

KPP cipher API

10-18

Key-agreement Protocol Primitive(KPP) cipher API

Generic KPP API 설명과 transform 할당·해제, secret 설정, public key 생성, shared secret 계산, maximum size 조회 API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/kpp.h
   :doc: Generic Key-agreement Protocol Primitives API

.. kernel-doc:: include/crypto/kpp.h
   :functions: crypto_alloc_kpp crypto_free_kpp crypto_kpp_set_secret crypto_kpp_generate_public_key crypto_kpp_compute_shared_secret crypto_kpp_maxsize

KPP cipher request handle

19-24

Key-agreement Protocol Primitive(KPP) cipher request handle

Request 할당·해제, callback 설정, input과 output buffer 연결 API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/kpp.h
   :functions: kpp_request_alloc kpp_request_free kpp_request_set_callback kpp_request_set_input kpp_request_set_output

ECDH helper 함수

25-33

ECDH helper 함수

`include/crypto/ecdh.h`의 ECDH helper 설명과 `ecdh`, key length 조회, key encode·decode API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/ecdh.h
   :doc: ECDH Helper Functions

.. kernel-doc:: include/crypto/ecdh.h
   :functions: ecdh crypto_ecdh_key_len crypto_ecdh_encode_key crypto_ecdh_decode_key

DH helper 함수

34-41

DH helper 함수

`include/crypto/dh.h`의 DH helper 설명과 `dh`, key length 조회, key encode·decode API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/dh.h
   :doc: DH Helper Functions

.. kernel-doc:: include/crypto/dh.h
   :functions: dh crypto_dh_key_len crypto_dh_encode_key crypto_dh_decode_key