Skip to content

Commit 8f0f814

Browse files
committed
AES: Document that the XTS, SIV, WRAP modes do not support streaming
Reviewed-by: Shane Lontis <[email protected]> Reviewed-by: Tom Cosgrove <[email protected]> (Merged from openssl#23028)
1 parent e2f9c2d commit 8f0f814

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

doc/man7/EVP_CIPHER-AES.pod

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -63,6 +63,19 @@ FIPS provider:
6363
This implementation supports the parameters described in
6464
L<EVP_EncryptInit(3)/PARAMETERS>.
6565

66+
=head1 NOTES
67+
68+
The AES-SIV and AES-WRAP mode implementations do not support streaming. That
69+
means to obtain correct results there can be only one L<EVP_EncryptUpdate(3)>
70+
or L<EVP_DecryptUpdate(3)> call after the initialization of the context.
71+
72+
The AES-XTS implementations allow streaming to be performed, but each
73+
L<EVP_EncryptUpdate(3)> or L<EVP_DecryptUpdate(3)> call requires each input
74+
to be a multiple of the blocksize. Only the final EVP_EncryptUpdate() or
75+
EVP_DecryptUpdate() call can optionally have an input that is not a multiple
76+
of the blocksize but is larger than one block. In that case ciphertext
77+
stealing (CTS) is used to fill the block.
78+
6679
=head1 SEE ALSO
6780

6881
L<provider-cipher(7)>, L<OSSL_PROVIDER-FIPS(7)>, L<OSSL_PROVIDER-default(7)>

0 commit comments

Comments
 (0)