summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/EVP_EncryptInit.3
diff options
context:
space:
mode:
authorschwarze <>2019-03-18 11:38:16 +0000
committerschwarze <>2019-03-18 11:38:16 +0000
commit4a75df5bf2e18cadd97b58970d202fd74c91f934 (patch)
treeed38361a5fd9719c12a1a47a52fde9926b42cdd4 /src/lib/libcrypto/man/EVP_EncryptInit.3
parent5a7781d16881bbd122cd4f73de96359580aaedad (diff)
downloadopenbsd-4a75df5bf2e18cadd97b58970d202fd74c91f934.tar.gz
openbsd-4a75df5bf2e18cadd97b58970d202fd74c91f934.tar.bz2
openbsd-4a75df5bf2e18cadd97b58970d202fd74c91f934.zip
Split EVP_aes_128_cbc(3) out of EVP_EncryptInit(3):
both resulting pages are still long. Mention a number of missing functions. Add some text from the OpenSSL 1.1.1 EVP_aes.pod manual page, which is still under a free license. Add missing HISTORY information. Triggered by tb@ providing EVP_aes_{128,192,256}_wrap(3) in evp.h rev. 1.74.
Diffstat (limited to 'src/lib/libcrypto/man/EVP_EncryptInit.3')
-rw-r--r--src/lib/libcrypto/man/EVP_EncryptInit.379
1 files changed, 7 insertions, 72 deletions
diff --git a/src/lib/libcrypto/man/EVP_EncryptInit.3 b/src/lib/libcrypto/man/EVP_EncryptInit.3
index 704a2016ed..10d30c4cf0 100644
--- a/src/lib/libcrypto/man/EVP_EncryptInit.3
+++ b/src/lib/libcrypto/man/EVP_EncryptInit.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: EVP_EncryptInit.3,v 1.27 2019/03/18 05:56:24 schwarze Exp $ 1.\" $OpenBSD: EVP_EncryptInit.3,v 1.28 2019/03/18 11:38:16 schwarze Exp $
2.\" full merge up to: OpenSSL 5211e094 Nov 11 14:39:11 2014 -0800 2.\" full merge up to: OpenSSL 5211e094 Nov 11 14:39:11 2014 -0800
3.\" selective merge up to: OpenSSL 16cfc2c9 Mar 8 22:30:28 2018 +0100 3.\" selective merge up to: OpenSSL 16cfc2c9 Mar 8 22:30:28 2018 +0100
4.\" 4.\"
@@ -138,26 +138,6 @@
138.Nm EVP_cast5_ecb , 138.Nm EVP_cast5_ecb ,
139.Nm EVP_cast5_cfb , 139.Nm EVP_cast5_cfb ,
140.Nm EVP_cast5_ofb , 140.Nm EVP_cast5_ofb ,
141.Nm EVP_aes_128_cbc ,
142.Nm EVP_aes_128_ecb ,
143.Nm EVP_aes_128_cfb ,
144.Nm EVP_aes_128_ofb ,
145.Nm EVP_aes_192_cbc ,
146.Nm EVP_aes_192_ecb ,
147.Nm EVP_aes_192_cfb ,
148.Nm EVP_aes_192_ofb ,
149.Nm EVP_aes_256_cbc ,
150.Nm EVP_aes_256_ecb ,
151.Nm EVP_aes_256_cfb ,
152.Nm EVP_aes_256_ofb ,
153.Nm EVP_aes_128_gcm ,
154.Nm EVP_aes_192_gcm ,
155.Nm EVP_aes_256_gcm ,
156.Nm EVP_aes_128_ccm ,
157.Nm EVP_aes_192_ccm ,
158.Nm EVP_aes_256_ccm ,
159.Nm EVP_aes_128_cbc_hmac_sha1 ,
160.Nm EVP_aes_256_cbc_hmac_sha1 ,
161.Nm EVP_chacha20 141.Nm EVP_chacha20
162.Nd EVP cipher routines 142.Nd EVP cipher routines
163.Sh SYNOPSIS 143.Sh SYNOPSIS
@@ -471,7 +451,7 @@ points to an unused object on the stack, it must be initialized with
471before calling this function. 451before calling this function.
472.Fa type 452.Fa type
473is normally supplied by a function such as 453is normally supplied by a function such as
474.Fn EVP_aes_256_cbc . 454.Xr EVP_aes_256_cbc 3 .
475If 455If
476.Fa impl 456.Fa impl
477is 457is
@@ -905,27 +885,6 @@ All algorithms have a fixed key length unless otherwise stated.
905.It Fn EVP_enc_null 885.It Fn EVP_enc_null
906Null cipher: does nothing. 886Null cipher: does nothing.
907.It Xo 887.It Xo
908.Fn EVP_aes_128_cbc ,
909.Fn EVP_aes_128_ecb ,
910.Fn EVP_aes_128_cfb ,
911.Fn EVP_aes_128_ofb
912.Xc
913AES with a 128-bit key in CBC, ECB, CFB and OFB modes respectively.
914.It Xo
915.Fn EVP_aes_192_cbc ,
916.Fn EVP_aes_192_ecb ,
917.Fn EVP_aes_192_cfb ,
918.Fn EVP_aes_192_ofb
919.Xc
920AES with a 192-bit key in CBC, ECB, CFB and OFB modes respectively.
921.It Xo
922.Fn EVP_aes_256_cbc ,
923.Fn EVP_aes_256_ecb ,
924.Fn EVP_aes_256_cfb ,
925.Fn EVP_aes_256_ofb
926.Xc
927AES with a 256-bit key in CBC, ECB, CFB and OFB modes respectively.
928.It Xo
929.Fn EVP_des_cbc , 888.Fn EVP_des_cbc ,
930.Fn EVP_des_ecb , 889.Fn EVP_des_ecb ,
931.Fn EVP_des_cfb , 890.Fn EVP_des_cfb ,
@@ -1004,29 +963,13 @@ This is a variable key length cipher.
1004.Xc 963.Xc
1005CAST encryption algorithm in CBC, ECB, CFB and OFB modes respectively. 964CAST encryption algorithm in CBC, ECB, CFB and OFB modes respectively.
1006This is a variable key length cipher. 965This is a variable key length cipher.
1007.It Xo
1008.Fn EVP_aes_128_gcm ,
1009.Fn EVP_aes_192_gcm ,
1010.Fn EVP_aes_256_gcm
1011.Xc
1012AES Galois Counter Mode (GCM) for 128, 192 and 256 bit keys respectively.
1013These ciphers require additional control operations to function
1014correctly: see the GCM mode section below for details.
1015.It Xo
1016.Fn EVP_aes_128_ccm ,
1017.Fn EVP_aes_192_ccm ,
1018.Fn EVP_aes_256_ccm
1019.Xc
1020AES Counter with CBC-MAC Mode (CCM) for 128, 192 and 256 bit keys
1021respectively.
1022These ciphers require additional control operations to function
1023correctly: see CCM mode section below for details.
1024.It Fn EVP_chacha20
1025The ChaCha20 stream cipher. 966The ChaCha20 stream cipher.
1026The key length is 256 bits, the IV is 96 bits long. 967The key length is 256 bits, the IV is 96 bits long.
1027.El 968.El
1028.Pp 969.Pp
1029See also 970See also
971.Xr EVP_aes_128_cbc 3
972and
1030.Xr EVP_sm4_cbc 3 . 973.Xr EVP_sm4_cbc 3 .
1031.Ss GCM mode 974.Ss GCM mode
1032For GCM mode ciphers, the behaviour of the EVP interface 975For GCM mode ciphers, the behaviour of the EVP interface
@@ -1231,6 +1174,7 @@ do_crypt(FILE *in, FILE *out, int do_encrypt)
1231.Ed 1174.Ed
1232.Sh SEE ALSO 1175.Sh SEE ALSO
1233.Xr evp 3 , 1176.Xr evp 3 ,
1177.Xr EVP_aes_128_cbc 3 ,
1234.Xr EVP_sm4_cbc 3 1178.Xr EVP_sm4_cbc 3
1235.Sh HISTORY 1179.Sh HISTORY
1236.Fn EVP_EncryptInit , 1180.Fn EVP_EncryptInit ,
@@ -1343,17 +1287,8 @@ first appeared in OpenSSL 0.9.8b.
1343These functions have been available since 1287These functions have been available since
1344.Ox 4.5 . 1288.Ox 4.5 .
1345.Pp 1289.Pp
1346.Fn EVP_rc4_hmac_md5 , 1290.Fn EVP_rc4_hmac_md5
1347.Fn EVP_aes_128_gcm , 1291first appeared in OpenSSL 1.0.1 and has been available since
1348.Fn EVP_aes_192_gcm ,
1349.Fn EVP_aes_256_gcm ,
1350.Fn EVP_aes_128_ccm ,
1351.Fn EVP_aes_192_ccm ,
1352.Fn EVP_aes_256_ccm ,
1353.Fn EVP_aes_128_cbc_hmac_sha1 ,
1354and
1355.Fn EVP_aes_256_cbc_hmac_sha1
1356first appeared in OpenSSL 1.0.1 and have been available since
1357.Ox 5.3 . 1292.Ox 5.3 .
1358.Pp 1293.Pp
1359.Fn EVP_CIPHER_CTX_reset 1294.Fn EVP_CIPHER_CTX_reset