cuberite/polarssl
1
0
Fork 0
mirror of https://github.com/cuberite/polarssl.git synced 2025-09-15 10:08:30 -04:00
Code Issues Packages Projects Releases Wiki Activity

Reword description of the authentation tag computation stages

Browse Source 
Signed-off-by: Mateusz Starzyk <mateusz.starzyk@mobica.com>
This commit is contained in:
Mateusz Starzyk 2021-06-15 14:26:53 +02:00
parent 25a571e076
commit 3d0bbeef0c
1 changed files with 15 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
library/gcm.c
View File

@ -333,14 +333,21 @@ int mbedtls_gcm_starts( mbedtls_gcm_context *ctx,
} }
/** /**
* mbedtls_gcm_context::buf contains different data type, depending * mbedtls_gcm_context::buf contains the partial state of the computation of
* on the values of mbedtls_gcm_context::::add_len and * the authentication tag.
* mbedtls_gcm_context::len: * mbedtls_gcm_context::::add_len and mbedtls_gcm_context::len indicate
* * When add_len % 16 == 0 and len == 0: initial state. * differenet stages of the computation:
* * When add_len % 16 != 0 and len == 0: the first `add_len % 16` bytes * * len == 0 && add_len == 0: initial state
* of buf have a partial AD block xored in and not yet multiplied in. * * len == 0 && add_len % 16 != 0: the first `add_len % 16` bytes have
* * When len != 0: the first `add_len % 16` bytes of buf have partial * a partial block of AD that has been
* ciphertext xored in and not yet multiplied in. * xored in but not yet multiplied in.
* * len == 0 && add_len % 16 == 0: the authentication tag is correct if
* the data ends now.
* * len % 16 != 0: the first `len % 16` bytes have
* a partial block of ciphertext that has
* been xored in but not yet multiplied in.
* * len > 0 && len % 16 == 0: the authentication tag is correct if
* the data ends now.
*/ */
int mbedtls_gcm_update_ad( mbedtls_gcm_context *ctx, int mbedtls_gcm_update_ad( mbedtls_gcm_context *ctx,
const unsigned char *add, size_t add_len ) const unsigned char *add, size_t add_len )