요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Message Digest
==============
Message Digest Algorithm Definitions
------------------------------------
.. kernel-doc:: include/crypto/hash.h
:doc: Message Digest Algorithm Definitions
.. kernel-doc:: include/crypto/hash.h
:functions: hash_alg_common ahash_alg shash_alg
Asynchronous Message Digest API
-------------------------------
.. kernel-doc:: include/crypto/hash.h
:doc: Asynchronous Message Digest API
.. kernel-doc:: include/crypto/hash.h
:functions: crypto_alloc_ahash crypto_free_ahash crypto_ahash_init crypto_ahash_digestsize crypto_ahash_reqtfm crypto_ahash_reqsize crypto_ahash_statesize crypto_ahash_setkey crypto_ahash_finup crypto_ahash_final crypto_ahash_digest crypto_ahash_export crypto_ahash_import
Asynchronous Hash Request Handle
--------------------------------
.. kernel-doc:: include/crypto/hash.h
:doc: Asynchronous Hash Request Handle
.. kernel-doc:: include/crypto/hash.h
:functions: ahash_request_set_tfm ahash_request_alloc ahash_request_free ahash_request_set_callback ahash_request_set_crypt
Synchronous Message Digest API
------------------------------
.. kernel-doc:: include/crypto/hash.h
:doc: Synchronous Message Digest API
.. kernel-doc:: include/crypto/hash.h
:functions: crypto_alloc_shash crypto_free_shash crypto_shash_blocksize crypto_shash_digestsize crypto_shash_descsize crypto_shash_setkey crypto_shash_digest crypto_shash_export crypto_shash_import crypto_shash_init crypto_shash_update crypto_shash_final crypto_shash_finup
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Message Digest
1-3메시지 Digest(Message Digest)
Message Digest algorithm 정의
4-12Message Digest algorithm 정의
`include/crypto/hash.h`의 algorithm 정의 설명과 `hash_alg_common`, `ahash_alg`, `shash_alg` structure를 가져옵니다.
.. kernel-doc:: include/crypto/hash.h
:doc: Message Digest Algorithm Definitions.. kernel-doc:: include/crypto/hash.h
:functions: hash_alg_common ahash_alg shash_algAsynchronous Message Digest API
13-21Asynchronous Message Digest API
Asynchronous hash transform의 할당·해제, 초기화, size 조회, key 설정, finup·final·digest, state export·import API의 kernel-doc을 가져옵니다.
.. kernel-doc:: include/crypto/hash.h
:doc: Asynchronous Message Digest API.. kernel-doc:: include/crypto/hash.h
:functions: crypto_alloc_ahash crypto_free_ahash crypto_ahash_init crypto_ahash_digestsize crypto_ahash_reqtfm crypto_ahash_reqsize crypto_ahash_statesize crypto_ahash_setkey crypto_ahash_finup crypto_ahash_final crypto_ahash_digest crypto_ahash_export crypto_ahash_importAsynchronous Hash request handle
22-30Asynchronous Hash request handle
Request에 transform을 연결하고 request를 할당·해제하며 callback과 crypt buffer를 설정하는 API의 kernel-doc을 가져옵니다.
.. kernel-doc:: include/crypto/hash.h
:doc: Asynchronous Hash Request Handle.. kernel-doc:: include/crypto/hash.h
:functions: ahash_request_set_tfm ahash_request_alloc ahash_request_free ahash_request_set_callback ahash_request_set_cryptSynchronous Message Digest API
31-38Synchronous Message Digest API
Synchronous hash transform의 할당·해제, block·digest·descriptor size 조회, key 설정, digest와 state export·import, init·update·final·finup API의 kernel-doc을 가져옵니다.
.. kernel-doc:: include/crypto/hash.h
:doc: Synchronous Message Digest API.. kernel-doc:: include/crypto/hash.h
:functions: crypto_alloc_shash crypto_free_shash crypto_shash_blocksize crypto_shash_digestsize crypto_shash_descsize crypto_shash_setkey crypto_shash_digest crypto_shash_export crypto_shash_import crypto_shash_init crypto_shash_update crypto_shash_final crypto_shash_finup
요약과 해설
api-digest.rst:1-38Message Digest API는 asynchronous `ahash`와 synchronous `shash` interface를 제공하며 init, update, final, digest, state export·import operation을 포함합니다.