Skip to content

Commit

Permalink
SM4: Document that the XTS mode does not support streaming
Browse files Browse the repository at this point in the history
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
Reviewed-by: Tom Cosgrove <tom.cosgrove@arm.com>
(Merged from #23028)
  • Loading branch information
t8m committed Dec 22, 2023
1 parent 2462e43 commit e2f9c2d
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions doc/man7/EVP_CIPHER-SM4.pod
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,15 @@ The following algorithms are available in the default provider:
This implementation supports the parameters described in
L<EVP_EncryptInit(3)/PARAMETERS>.

=head1 NOTES

The SM4-XTS implementation allows streaming to be performed, but each
L<EVP_EncryptUpdate(3)> or L<EVP_DecryptUpdate(3)> call requires each input
to be a multiple of the blocksize. Only the final EVP_EncryptUpdate() or
EVP_DecryptUpdate() call can optionally have an input that is not a multiple
of the blocksize but is larger than one block. In that case ciphertext
stealing (CTS) is used to fill the block.

=head1 SEE ALSO

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

0 comments on commit e2f9c2d

Please sign in to comment.