요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Authenticated Encryption With Associated Data (AEAD)
====================================================
Authenticated Encryption With Associated Data (AEAD) Algorithm Definitions
--------------------------------------------------------------------------
.. 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
Authenticated Encryption With Associated Data (AEAD) Cipher API
---------------------------------------------------------------
.. 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
--------------------------------
.. 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
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
AEAD
1-3Associated Data를 사용하는 Authenticated Encryption, 즉 AEAD
AEAD algorithm 정의
4-12Associated 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_algAEAD Cipher API
13-18Associated 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_decryptAsynchronous AEAD request handle
19-26Asynchronous 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
요약과 해설
api-aead.rst:1-26AEAD API는 encryption과 authentication을 결합하고 associated data를 인증합니다. 이 문서는 algorithm 등록, transform operation, asynchronous request 준비 API를 세 묶음으로 제시합니다.