Skip to content

Commit e2f9c2d

Browse files
committed
SM4: Document that the XTS mode does not support streaming
Reviewed-by: Shane Lontis <[email protected]> Reviewed-by: Tom Cosgrove <[email protected]> (Merged from openssl#23028)
1 parent 2462e43 commit e2f9c2d

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

doc/man7/EVP_CIPHER-SM4.pod

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,15 @@ The following algorithms are available in the default provider:
3737
This implementation supports the parameters described in
3838
L<EVP_EncryptInit(3)/PARAMETERS>.
3939

40+
=head1 NOTES
41+
42+
The SM4-XTS implementation allows streaming to be performed, but each
43+
L<EVP_EncryptUpdate(3)> or L<EVP_DecryptUpdate(3)> call requires each input
44+
to be a multiple of the blocksize. Only the final EVP_EncryptUpdate() or
45+
EVP_DecryptUpdate() call can optionally have an input that is not a multiple
46+
of the blocksize but is larger than one block. In that case ciphertext
47+
stealing (CTS) is used to fill the block.
48+
4049
=head1 SEE ALSO
4150

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

0 commit comments

Comments
 (0)