summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EVP_AEAD_CTX_init.3
diff options
context:
space:
mode:
authorreyk <>2015-11-02 15:40:53 +0000
committerreyk <>2015-11-02 15:40:53 +0000
commitb743c75edf0dc70962a2ed0c5221ecb8841d7525 (patch)
tree40446be7b959dce9252457817e67737c7606706c /src/lib/libcrypto/man/EVP_AEAD_CTX_init.3
parent3b76990c68663b08d77297a05a8104c2f1528064 (diff)
downloadopenbsd-b743c75edf0dc70962a2ed0c5221ecb8841d7525.tar.gz
openbsd-b743c75edf0dc70962a2ed0c5221ecb8841d7525.tar.bz2
openbsd-b743c75edf0dc70962a2ed0c5221ecb8841d7525.zip
Add EVP_aead_chacha20_poly1305_ietf() - The informational RFC 7539,
"ChaCha20 and Poly1305 for IETF Protocols", introduced a modified AEAD construction that is incompatible with the common style that has been already used in TLS with EVP_aead_chacha20_poly1305(). The IETF version also adds a constant (salt) that is prepended to the nonce. OK mikeb@ jsing@
Diffstat (limited to 'src/lib/libcrypto/man/EVP_AEAD_CTX_init.3')
-rw-r--r--src/lib/libcrypto/man/EVP_AEAD_CTX_init.333
1 files changed, 30 insertions, 3 deletions
diff --git a/src/lib/libcrypto/man/EVP_AEAD_CTX_init.3 b/src/lib/libcrypto/man/EVP_AEAD_CTX_init.3
index a2b4efea54..e6abc282d3 100644
--- a/src/lib/libcrypto/man/EVP_AEAD_CTX_init.3
+++ b/src/lib/libcrypto/man/EVP_AEAD_CTX_init.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EVP_AEAD_CTX_init.3,v 1.2 2015/10/14 09:11:25 schwarze Exp $ 1.\" $OpenBSD: EVP_AEAD_CTX_init.3,v 1.3 2015/11/02 15:40:53 reyk Exp $
2.\" 2.\"
3.\" Copyright (c) 2014, Google Inc. 3.\" Copyright (c) 2014, Google Inc.
4.\" Parts of the text were written by Adam Langley and David Benjamin. 4.\" Parts of the text were written by Adam Langley and David Benjamin.
@@ -16,7 +16,7 @@
16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18.\" 18.\"
19.Dd $Mdocdate: October 14 2015 $ 19.Dd $Mdocdate: November 2 2015 $
20.Dt EVP_AEAD_CTX_INIT 3 20.Dt EVP_AEAD_CTX_INIT 3
21.Os 21.Os
22.Sh NAME 22.Sh NAME
@@ -30,7 +30,8 @@
30.Nm EVP_AEAD_nonce_length , 30.Nm EVP_AEAD_nonce_length ,
31.Nm EVP_aead_aes_128_gcm , 31.Nm EVP_aead_aes_128_gcm ,
32.Nm EVP_aead_aes_256_gcm , 32.Nm EVP_aead_aes_256_gcm ,
33.Nm EVP_aead_chacha20_poly1305 33.Nm EVP_aead_chacha20_poly1305 ,
34.Nm EVP_aead_chacha20_poly1305_ietf
34.Nd authenticated encryption with additional data 35.Nd authenticated encryption with additional data
35.Sh SYNOPSIS 36.Sh SYNOPSIS
36.In openssl/evp.h 37.In openssl/evp.h
@@ -101,6 +102,10 @@
101.Fo EVP_aead_chacha20_poly1305 102.Fo EVP_aead_chacha20_poly1305
102.Fa void 103.Fa void
103.Fc 104.Fc
105.Ft const EVP_AEAD *
106.Fo EVP_aead_chacha20_poly1305_ietf
107.Fa void
108.Fc
104.Sh DESCRIPTION 109.Sh DESCRIPTION
105AEAD (Authenticated Encryption with Additional Data) couples 110AEAD (Authenticated Encryption with Additional Data) couples
106confidentiality and integrity in a single primitive. 111confidentiality and integrity in a single primitive.
@@ -219,6 +224,11 @@ AES-128 in Galois Counter Mode.
219AES-256 in Galois Counter Mode. 224AES-256 in Galois Counter Mode.
220.It Fn EVP_aead_chacha20_poly1305 225.It Fn EVP_aead_chacha20_poly1305
221ChaCha20 with a Poly1305 authenticator. 226ChaCha20 with a Poly1305 authenticator.
227.It Fn EVP_aead_chacha20_poly1305_ietf
228ChaCha20 with a Poly1305 authenticator for IETF Protocols.
229The IETF standardised variant of the AEAD is incompatible with the
230original version.
231It uses a constant salt that is prepended to the nonce.
222.El 232.El
223.Pp 233.Pp
224Where possible the 234Where possible the
@@ -270,6 +280,23 @@ EVP_AEAD_CTX_cleanup(&ctx);
270.Ed 280.Ed
271.Sh SEE ALSO 281.Sh SEE ALSO
272.Xr evp 3 282.Xr evp 3
283.Sh STANDARDS
284.Rs
285.%A A. Langley
286.%A W. Chang
287.%D November 2013
288.%R draft-agl-tls-chacha20poly1305-04
289.%T ChaCha20 and Poly1305 based Cipher Suites for TLS
290.Re
291.Pp
292.Rs
293.%A Y. Nir
294.%A A. Langley
295.%D May 2015
296.%R RFC 7539
297.%T ChaCha20 and Poly1305 for IETF Protocols
298.Re
299.Pp
273.Sh HISTORY 300.Sh HISTORY
274AEAD is based on the implementation by 301AEAD is based on the implementation by
275.An Adam Langley 302.An Adam Langley