Documentation/crypto/api-aead.rst GitHub 원문 ↗

Linux 6.18.37 · Crypto

Authenticated Encryption With Associated Data (AEAD)

`include/crypto/aead.h`에서 AEAD algorithm, cipher transform, asynchronous request handle 관련 kernel-doc을 구성하는 API reference입니다.

Source pathDocumentation/crypto/api-aead.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

api-aead.rst:1-26

AEAD API는 encryption과 authentication을 결합하고 associated data를 인증합니다. 이 문서는 algorithm 등록, transform operation, asynchronous request 준비 API를 세 묶음으로 제시합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 Authenticated Encryption With Associated Data (AEAD)
2 ====================================================
3
4 Authenticated Encryption With Associated Data (AEAD) Algorithm Definitions
5 --------------------------------------------------------------------------
6
7 .. kernel-doc:: include/crypto/aead.h
8 :doc: Authenticated Encryption With Associated Data (AEAD) Cipher API
9
10 .. kernel-doc:: include/crypto/aead.h
11 :functions: aead_request aead_alg
12
13 Authenticated Encryption With Associated Data (AEAD) Cipher API
14 ---------------------------------------------------------------
15
16 .. kernel-doc:: include/crypto/aead.h
17 :functions: crypto_alloc_aead crypto_free_aead crypto_aead_ivsize crypto_aead_authsize crypto_aead_blocksize crypto_aead_setkey crypto_aead_setauthsize crypto_aead_encrypt crypto_aead_decrypt
18
19 Asynchronous AEAD Request Handle
20 --------------------------------
21
22 .. kernel-doc:: include/crypto/aead.h
23 :doc: Asynchronous AEAD Request Handle
24
25 .. kernel-doc:: include/crypto/aead.h
26 :functions: crypto_aead_reqsize aead_request_set_tfm aead_request_alloc aead_request_free aead_request_set_callback aead_request_set_crypt aead_request_set_ad
27

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

AEAD

1-3

Associated Data를 사용하는 Authenticated Encryption, 즉 AEAD

AEAD algorithm 정의

4-12

Associated Data를 사용하는 Authenticated Encryption algorithm 정의

`include/crypto/aead.h`의 AEAD Cipher API 설명과 `aead_request`, `aead_alg` structure를 가져옵니다.

.. kernel-doc:: include/crypto/aead.h
   :doc: Authenticated Encryption With Associated Data (AEAD) Cipher API
.. kernel-doc:: include/crypto/aead.h
   :functions: aead_request aead_alg

AEAD Cipher API

13-18

Associated Data를 사용하는 Authenticated Encryption Cipher API

AEAD transform 할당·해제, IV·authentication tag·block size 조회, key와 authsize 설정, encrypt·decrypt API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/aead.h
   :functions: crypto_alloc_aead crypto_free_aead crypto_aead_ivsize crypto_aead_authsize crypto_aead_blocksize crypto_aead_setkey crypto_aead_setauthsize crypto_aead_encrypt crypto_aead_decrypt

Asynchronous AEAD request handle

19-26

Asynchronous AEAD request handle

Request size 조회, transform 연결, request 할당·해제, callback·crypt buffer·associated data 설정 API의 kernel-doc을 가져옵니다.

.. kernel-doc:: include/crypto/aead.h
   :doc: Asynchronous AEAD Request Handle
.. kernel-doc:: include/crypto/aead.h
   :functions: crypto_aead_reqsize aead_request_set_tfm aead_request_alloc aead_request_free aead_request_set_callback aead_request_set_crypt aead_request_set_ad