blob: 18d327152cb42c58b988ce18e71c80c50ee8c048 [file] [log] [blame] [view]
Manuel Pégourié-Gonnardee57ebe2021-05-31 12:25:01 +02001Calling `mbedtls_cipher_finish()` is mandatory for all multi-part operations
2----------------------------------------------------------------------------
3
Manuel Pégourié-Gonnardc01b87b2021-06-01 09:40:53 +02004This only affects people who use the cipher module to perform AEAD operations
Manuel Pégourié-Gonnardee57ebe2021-05-31 12:25:01 +02005using the multi-part API.
6
7Previously, the documentation didn't state explicitly if it was OK to call
8`mbedtls_cipher_check_tag()` or `mbedtls_cipher_write_tag()` directly after
9the last call to `mbedtls_cipher_update()` - that is, without calling
10`mbedtls_cipher_finish()` in-between. If you code was missing that call,
11please add it and be prepared to get as much as 15 bytes of output.
12
13Currently the output is always 0 bytes, but it may be more when alternative
14implementations of the underlying primitives are in use, or with future
15versions of the library.