xref: /freebsd/crypto/openssl/doc/man3/EVP_chacha20.pod (revision 6829dae12bb055451fa467da4589c43bd03b1e64)
1=pod
2
3=head1 NAME
4
5EVP_chacha20,
6EVP_chacha20_poly1305
7- EVP ChaCha20 stream cipher
8
9=head1 SYNOPSIS
10
11 #include <openssl/evp.h>
12
13 const EVP_CIPHER *EVP_chacha20(void)
14 const EVP_CIPHER *EVP_chacha20_poly1305(void)
15
16=head1 DESCRIPTION
17
18The ChaCha20 stream cipher for EVP.
19
20=over 4
21
22=item EVP_chacha20()
23
24The ChaCha20 stream cipher. The key length is 256 bits, the IV is 96 bits long.
25
26=item EVP_chacha20_poly1305()
27
28Authenticated encryption with ChaCha20-Poly1305. Like EVP_chacha20(), the key
29is 256 bits and the IV is 96 bits. This supports additional authenticated data
30(AAD) and produces a 128-bit authentication tag. See the
31L<EVP_EncryptInit(3)/AEAD Interface> section for more information.
32
33=back
34
35=head1 RETURN VALUES
36
37These functions return an B<EVP_CIPHER> structure that contains the
38implementation of the symmetric cipher. See L<EVP_CIPHER_meth_new(3)> for
39details of the B<EVP_CIPHER> structure.
40
41=head1 SEE ALSO
42
43L<evp(7)>,
44L<EVP_EncryptInit(3)>,
45L<EVP_CIPHER_meth_new(3)>
46
47=head1 COPYRIGHT
48
49Copyright 2017 The OpenSSL Project Authors. All Rights Reserved.
50
51Licensed under the OpenSSL license (the "License").  You may not use
52this file except in compliance with the License.  You can obtain a copy
53in the file LICENSE in the source distribution or at
54L<https://www.openssl.org/source/license.html>.
55
56=cut
57
58