mirror of
https://github.com/Mbed-TLS/mbedtls.git
synced 2025-04-18 14:42:24 +00:00
Add ChangeLog and migration guide entries
Signed-off-by: Manuel Pégourié-Gonnard <manuel.pegourie-gonnard@arm.com>
This commit is contained in:
parent
42eba1a274
commit
ee57ebe553
6
ChangeLog.d/cipher-delayed-output.txt
Normal file
6
ChangeLog.d/cipher-delayed-output.txt
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
API changes
|
||||||
|
* For multi-part AEAD operations with the Cipher module, calling
|
||||||
|
mbedtls_cipher_finish() is now mandatory. Previously the documentation
|
||||||
|
was unclear on this point, and this function happened to never do
|
||||||
|
anything with the currently implemented AEADs, so in practice is was
|
||||||
|
possible to skip calling it, which is no longer supported.
|
15
docs/3.0-migration-guide.d/cipher-delayed-output.md
Normal file
15
docs/3.0-migration-guide.d/cipher-delayed-output.md
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
Calling `mbedtls_cipher_finish()` is mandatory for all multi-part operations
|
||||||
|
----------------------------------------------------------------------------
|
||||||
|
|
||||||
|
This only affect people who use the Cipher module to perform AEAD operations
|
||||||
|
using the multi-part API.
|
||||||
|
|
||||||
|
Previously, the documentation didn't state explicitly if it was OK to call
|
||||||
|
`mbedtls_cipher_check_tag()` or `mbedtls_cipher_write_tag()` directly after
|
||||||
|
the last call to `mbedtls_cipher_update()` - that is, without calling
|
||||||
|
`mbedtls_cipher_finish()` in-between. If you code was missing that call,
|
||||||
|
please add it and be prepared to get as much as 15 bytes of output.
|
||||||
|
|
||||||
|
Currently the output is always 0 bytes, but it may be more when alternative
|
||||||
|
implementations of the underlying primitives are in use, or with future
|
||||||
|
versions of the library.
|
Loading…
x
Reference in New Issue
Block a user