Commit d5abbf43 authored by enkore's avatar enkore Committed by Rich Salz
Browse files

EVP docs: chacha20, chacha20-poly1305 



CLA: trivial

Reviewed-by: default avatarAndy Polyakov <appro@openssl.org>
Reviewed-by: default avatarRich Salz <rsalz@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/1909)
(cherry picked from commit 625b9d6b)
parent fadfc8ec

doc/crypto/EVP_EncryptInit.pod

+15 −3
Original line number Diff line number Diff line
@@ -29,12 +29,13 @@ EVP_aes_128_cbc, EVP_aes_128_ecb, EVP_aes_128_cfb, EVP_aes_128_ofb, 
EVP_aes_192_cbc, EVP_aes_192_ecb, EVP_aes_192_cfb, EVP_aes_192_ofb,

EVP_aes_256_cbc, EVP_aes_256_ecb, EVP_aes_256_cfb, EVP_aes_256_ofb,

EVP_aes_128_gcm, EVP_aes_192_gcm, EVP_aes_256_gcm,

EVP_aes_128_ccm, EVP_aes_192_ccm, EVP_aes_256_ccm - EVP cipher routines



=for comment generic

EVP_aes_128_ccm, EVP_aes_192_ccm, EVP_aes_256_ccm,

EVP_chacha20, EVP_chacha20_poly1305 - EVP cipher routines



=head1 SYNOPSIS



=for comment generic



 #include <openssl/evp.h>



 EVP_CIPHER_CTX *EVP_CIPHER_CTX_new(void);
@@ -400,6 +401,17 @@ AES Counter with CBC-MAC Mode (CCM) for 128, 192 and 256 bit keys respectively. 
These ciphers require additional control operations to function correctly: see

CCM mode section below for details.



=item EVP_chacha20()



The ChaCha20 stream cipher. The key length is 256 bits, the IV is 96 bits long.



=item EVP_chacha20_poly1305()



Authenticated encryption with ChaCha20-Poly1305. Like EVP_chacha20() the key is

256 bits and the IV is 96 bits. This supports additional authenticated

data (AAD) and produces a 128 bit authentication tag. The L</GCM and OCB modes>

section below applies.



=back



=head1 GCM and OCB Modes