xref: /openbsd-src/lib/libcrypto/evp/evp.h (revision 50b7afb2c2c0993b0894d4e34bf857cb13ed9c80)
1 /* $OpenBSD: evp.h,v 1.39 2014/07/11 15:28:27 tedu Exp $ */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  *
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  *
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  *
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  *
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  *
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58 
59 #ifndef HEADER_ENVELOPE_H
60 #define HEADER_ENVELOPE_H
61 
62 #include <openssl/opensslconf.h>
63 
64 #include <openssl/ossl_typ.h>
65 
66 #ifndef OPENSSL_NO_BIO
67 #include <openssl/bio.h>
68 #endif
69 
70 /*
71 #define EVP_RC2_KEY_SIZE		16
72 #define EVP_RC4_KEY_SIZE		16
73 #define EVP_BLOWFISH_KEY_SIZE		16
74 #define EVP_CAST5_KEY_SIZE		16
75 #define EVP_RC5_32_12_16_KEY_SIZE	16
76 */
77 #define EVP_MAX_MD_SIZE			64	/* longest known is SHA512 */
78 #define EVP_MAX_KEY_LENGTH		64
79 #define EVP_MAX_IV_LENGTH		16
80 #define EVP_MAX_BLOCK_LENGTH		32
81 
82 #define PKCS5_SALT_LEN			8
83 /* Default PKCS#5 iteration count */
84 #define PKCS5_DEFAULT_ITER		2048
85 
86 #include <openssl/objects.h>
87 
88 #define EVP_PK_RSA	0x0001
89 #define EVP_PK_DSA	0x0002
90 #define EVP_PK_DH	0x0004
91 #define EVP_PK_EC	0x0008
92 #define EVP_PKT_SIGN	0x0010
93 #define EVP_PKT_ENC	0x0020
94 #define EVP_PKT_EXCH	0x0040
95 #define EVP_PKS_RSA	0x0100
96 #define EVP_PKS_DSA	0x0200
97 #define EVP_PKS_EC	0x0400
98 #define EVP_PKT_EXP	0x1000 /* <= 512 bit key */
99 
100 #define EVP_PKEY_NONE	NID_undef
101 #define EVP_PKEY_RSA	NID_rsaEncryption
102 #define EVP_PKEY_RSA2	NID_rsa
103 #define EVP_PKEY_DSA	NID_dsa
104 #define EVP_PKEY_DSA1	NID_dsa_2
105 #define EVP_PKEY_DSA2	NID_dsaWithSHA
106 #define EVP_PKEY_DSA3	NID_dsaWithSHA1
107 #define EVP_PKEY_DSA4	NID_dsaWithSHA1_2
108 #define EVP_PKEY_DH	NID_dhKeyAgreement
109 #define EVP_PKEY_EC	NID_X9_62_id_ecPublicKey
110 #define EVP_PKEY_HMAC	NID_hmac
111 #define EVP_PKEY_CMAC	NID_cmac
112 
113 #ifdef	__cplusplus
114 extern "C" {
115 #endif
116 
117 /* Type needs to be a bit field
118  * Sub-type needs to be for variations on the method, as in, can it do
119  * arbitrary encryption.... */
120 struct evp_pkey_st {
121 	int type;
122 	int save_type;
123 	int references;
124 	const EVP_PKEY_ASN1_METHOD *ameth;
125 	ENGINE *engine;
126 	union	{
127 		char *ptr;
128 #ifndef OPENSSL_NO_RSA
129 		struct rsa_st *rsa;	/* RSA */
130 #endif
131 #ifndef OPENSSL_NO_DSA
132 		struct dsa_st *dsa;	/* DSA */
133 #endif
134 #ifndef OPENSSL_NO_DH
135 		struct dh_st *dh;	/* DH */
136 #endif
137 #ifndef OPENSSL_NO_EC
138 		struct ec_key_st *ec;	/* ECC */
139 #endif
140 	} pkey;
141 	int save_parameters;
142 	STACK_OF(X509_ATTRIBUTE) *attributes; /* [ 0 ] */
143 } /* EVP_PKEY */;
144 
145 #define EVP_PKEY_MO_SIGN	0x0001
146 #define EVP_PKEY_MO_VERIFY	0x0002
147 #define EVP_PKEY_MO_ENCRYPT	0x0004
148 #define EVP_PKEY_MO_DECRYPT	0x0008
149 
150 #ifndef EVP_MD
151 struct env_md_st {
152 	int type;
153 	int pkey_type;
154 	int md_size;
155 	unsigned long flags;
156 	int (*init)(EVP_MD_CTX *ctx);
157 	int (*update)(EVP_MD_CTX *ctx, const void *data, size_t count);
158 	int (*final)(EVP_MD_CTX *ctx, unsigned char *md);
159 	int (*copy)(EVP_MD_CTX *to, const EVP_MD_CTX *from);
160 	int (*cleanup)(EVP_MD_CTX *ctx);
161 
162 	/* FIXME: prototype these some day */
163 	int (*sign)(int type, const unsigned char *m, unsigned int m_length,
164 	    unsigned char *sigret, unsigned int *siglen, void *key);
165 	int (*verify)(int type, const unsigned char *m, unsigned int m_length,
166 	    const unsigned char *sigbuf, unsigned int siglen,
167 	    void *key);
168 	int required_pkey_type[5]; /*EVP_PKEY_xxx */
169 	int block_size;
170 	int ctx_size; /* how big does the ctx->md_data need to be */
171 	/* control function */
172 	int (*md_ctrl)(EVP_MD_CTX *ctx, int cmd, int p1, void *p2);
173 } /* EVP_MD */;
174 
175 typedef int evp_sign_method(int type, const unsigned char *m,
176     unsigned int m_length, unsigned char *sigret, unsigned int *siglen,
177     void *key);
178 typedef int evp_verify_method(int type, const unsigned char *m,
179     unsigned int m_length, const unsigned char *sigbuf, unsigned int siglen,
180     void *key);
181 
182 #define EVP_MD_FLAG_ONESHOT	0x0001 /* digest can only handle a single
183 					* block */
184 
185 #define EVP_MD_FLAG_PKEY_DIGEST	0x0002 /* digest is a "clone" digest used
186 					* which is a copy of an existing
187 					* one for a specific public key type.
188 					* EVP_dss1() etc */
189 
190 /* Digest uses EVP_PKEY_METHOD for signing instead of MD specific signing */
191 
192 #define EVP_MD_FLAG_PKEY_METHOD_SIGNATURE	0x0004
193 
194 /* DigestAlgorithmIdentifier flags... */
195 
196 #define EVP_MD_FLAG_DIGALGID_MASK		0x0018
197 
198 /* NULL or absent parameter accepted. Use NULL */
199 
200 #define EVP_MD_FLAG_DIGALGID_NULL		0x0000
201 
202 /* NULL or absent parameter accepted. Use NULL for PKCS#1 otherwise absent */
203 
204 #define EVP_MD_FLAG_DIGALGID_ABSENT		0x0008
205 
206 /* Custom handling via ctrl */
207 
208 #define EVP_MD_FLAG_DIGALGID_CUSTOM		0x0018
209 
210 #define EVP_MD_FLAG_FIPS	0x0400 /* Note if suitable for use in FIPS mode */
211 
212 /* Digest ctrls */
213 
214 #define	EVP_MD_CTRL_DIGALGID			0x1
215 #define	EVP_MD_CTRL_MICALG			0x2
216 
217 /* Minimum Algorithm specific ctrl value */
218 
219 #define	EVP_MD_CTRL_ALG_CTRL			0x1000
220 
221 #define EVP_PKEY_NULL_method	NULL,NULL,{0,0,0,0}
222 
223 #ifndef OPENSSL_NO_DSA
224 #define EVP_PKEY_DSA_method	(evp_sign_method *)DSA_sign, \
225 				(evp_verify_method *)DSA_verify, \
226 				{EVP_PKEY_DSA,EVP_PKEY_DSA2,EVP_PKEY_DSA3, \
227 					EVP_PKEY_DSA4,0}
228 #else
229 #define EVP_PKEY_DSA_method	EVP_PKEY_NULL_method
230 #endif
231 
232 #ifndef OPENSSL_NO_ECDSA
233 #define EVP_PKEY_ECDSA_method   (evp_sign_method *)ECDSA_sign, \
234 				(evp_verify_method *)ECDSA_verify, \
235                                  {EVP_PKEY_EC,0,0,0}
236 #else
237 #define EVP_PKEY_ECDSA_method   EVP_PKEY_NULL_method
238 #endif
239 
240 #ifndef OPENSSL_NO_RSA
241 #define EVP_PKEY_RSA_method	(evp_sign_method *)RSA_sign, \
242 				(evp_verify_method *)RSA_verify, \
243 				{EVP_PKEY_RSA,EVP_PKEY_RSA2,0,0}
244 #define EVP_PKEY_RSA_ASN1_OCTET_STRING_method \
245 				(evp_sign_method *)RSA_sign_ASN1_OCTET_STRING, \
246 				(evp_verify_method *)RSA_verify_ASN1_OCTET_STRING, \
247 				{EVP_PKEY_RSA,EVP_PKEY_RSA2,0,0}
248 #else
249 #define EVP_PKEY_RSA_method	EVP_PKEY_NULL_method
250 #define EVP_PKEY_RSA_ASN1_OCTET_STRING_method EVP_PKEY_NULL_method
251 #endif
252 
253 #endif /* !EVP_MD */
254 
255 struct env_md_ctx_st {
256 	const EVP_MD *digest;
257 	ENGINE *engine; /* functional reference if 'digest' is ENGINE-provided */
258 	unsigned long flags;
259 	void *md_data;
260 	/* Public key context for sign/verify */
261 	EVP_PKEY_CTX *pctx;
262 	/* Update function: usually copied from EVP_MD */
263 	int (*update)(EVP_MD_CTX *ctx, const void *data, size_t count);
264 } /* EVP_MD_CTX */;
265 
266 /* values for EVP_MD_CTX flags */
267 
268 #define EVP_MD_CTX_FLAG_ONESHOT		0x0001 /* digest update will be called
269 						* once only */
270 #define EVP_MD_CTX_FLAG_CLEANED		0x0002 /* context has already been
271 						* cleaned */
272 #define EVP_MD_CTX_FLAG_REUSE		0x0004 /* Don't free up ctx->md_data
273 						* in EVP_MD_CTX_cleanup */
274 /* FIPS and pad options are ignored in 1.0.0, definitions are here
275  * so we don't accidentally reuse the values for other purposes.
276  */
277 
278 #define EVP_MD_CTX_FLAG_NON_FIPS_ALLOW	0x0008	/* Allow use of non FIPS digest
279 						 * in FIPS mode */
280 
281 /* The following PAD options are also currently ignored in 1.0.0, digest
282  * parameters are handled through EVP_DigestSign*() and EVP_DigestVerify*()
283  * instead.
284  */
285 #define EVP_MD_CTX_FLAG_PAD_MASK	0xF0	/* RSA mode to use */
286 #define EVP_MD_CTX_FLAG_PAD_PKCS1	0x00	/* PKCS#1 v1.5 mode */
287 #define EVP_MD_CTX_FLAG_PAD_X931	0x10	/* X9.31 mode */
288 #define EVP_MD_CTX_FLAG_PAD_PSS		0x20	/* PSS mode */
289 
290 #define EVP_MD_CTX_FLAG_NO_INIT		0x0100 /* Don't initialize md_data */
291 
292 struct evp_cipher_st {
293 	int nid;
294 	int block_size;
295 	int key_len;		/* Default value for variable length ciphers */
296 	int iv_len;
297 	unsigned long flags;	/* Various flags */
298 	int (*init)(EVP_CIPHER_CTX *ctx, const unsigned char *key,
299 	    const unsigned char *iv, int enc);	/* init key */
300 	int (*do_cipher)(EVP_CIPHER_CTX *ctx, unsigned char *out,
301 	    const unsigned char *in, size_t inl);/* encrypt/decrypt data */
302 	int (*cleanup)(EVP_CIPHER_CTX *); /* cleanup ctx */
303 	int ctx_size;		/* how big ctx->cipher_data needs to be */
304 	int (*set_asn1_parameters)(EVP_CIPHER_CTX *, ASN1_TYPE *); /* Populate a ASN1_TYPE with parameters */
305 	int (*get_asn1_parameters)(EVP_CIPHER_CTX *, ASN1_TYPE *); /* Get parameters from a ASN1_TYPE */
306 	int (*ctrl)(EVP_CIPHER_CTX *, int type, int arg, void *ptr); /* Miscellaneous operations */
307 	void *app_data;		/* Application data */
308 } /* EVP_CIPHER */;
309 
310 /* Values for cipher flags */
311 
312 /* Modes for ciphers */
313 
314 #define		EVP_CIPH_STREAM_CIPHER		0x0
315 #define		EVP_CIPH_ECB_MODE		0x1
316 #define		EVP_CIPH_CBC_MODE		0x2
317 #define		EVP_CIPH_CFB_MODE		0x3
318 #define		EVP_CIPH_OFB_MODE		0x4
319 #define		EVP_CIPH_CTR_MODE		0x5
320 #define		EVP_CIPH_GCM_MODE		0x6
321 #define		EVP_CIPH_CCM_MODE		0x7
322 #define		EVP_CIPH_XTS_MODE		0x10001
323 #define 	EVP_CIPH_MODE			0xF0007
324 /* Set if variable length cipher */
325 #define 	EVP_CIPH_VARIABLE_LENGTH	0x8
326 /* Set if the iv handling should be done by the cipher itself */
327 #define 	EVP_CIPH_CUSTOM_IV		0x10
328 /* Set if the cipher's init() function should be called if key is NULL */
329 #define 	EVP_CIPH_ALWAYS_CALL_INIT	0x20
330 /* Call ctrl() to init cipher parameters */
331 #define 	EVP_CIPH_CTRL_INIT		0x40
332 /* Don't use standard key length function */
333 #define 	EVP_CIPH_CUSTOM_KEY_LENGTH	0x80
334 /* Don't use standard block padding */
335 #define 	EVP_CIPH_NO_PADDING		0x100
336 /* cipher handles random key generation */
337 #define 	EVP_CIPH_RAND_KEY		0x200
338 /* cipher has its own additional copying logic */
339 #define 	EVP_CIPH_CUSTOM_COPY		0x400
340 /* Allow use default ASN1 get/set iv */
341 #define		EVP_CIPH_FLAG_DEFAULT_ASN1	0x1000
342 /* Buffer length in bits not bytes: CFB1 mode only */
343 #define		EVP_CIPH_FLAG_LENGTH_BITS	0x2000
344 /* Note if suitable for use in FIPS mode */
345 #define		EVP_CIPH_FLAG_FIPS		0x4000
346 /* Allow non FIPS cipher in FIPS mode */
347 #define		EVP_CIPH_FLAG_NON_FIPS_ALLOW	0x8000
348 /* Cipher handles any and all padding logic as well
349  * as finalisation.
350  */
351 #define 	EVP_CIPH_FLAG_CUSTOM_CIPHER	0x100000
352 #define		EVP_CIPH_FLAG_AEAD_CIPHER	0x200000
353 
354 /* ctrl() values */
355 
356 #define		EVP_CTRL_INIT			0x0
357 #define 	EVP_CTRL_SET_KEY_LENGTH		0x1
358 #define 	EVP_CTRL_GET_RC2_KEY_BITS	0x2
359 #define 	EVP_CTRL_SET_RC2_KEY_BITS	0x3
360 #define 	EVP_CTRL_GET_RC5_ROUNDS		0x4
361 #define 	EVP_CTRL_SET_RC5_ROUNDS		0x5
362 #define 	EVP_CTRL_RAND_KEY		0x6
363 #define 	EVP_CTRL_PBE_PRF_NID		0x7
364 #define 	EVP_CTRL_COPY			0x8
365 #define 	EVP_CTRL_GCM_SET_IVLEN		0x9
366 #define 	EVP_CTRL_GCM_GET_TAG		0x10
367 #define 	EVP_CTRL_GCM_SET_TAG		0x11
368 #define		EVP_CTRL_GCM_SET_IV_FIXED	0x12
369 #define		EVP_CTRL_GCM_IV_GEN		0x13
370 #define		EVP_CTRL_CCM_SET_IVLEN		EVP_CTRL_GCM_SET_IVLEN
371 #define		EVP_CTRL_CCM_GET_TAG		EVP_CTRL_GCM_GET_TAG
372 #define		EVP_CTRL_CCM_SET_TAG		EVP_CTRL_GCM_SET_TAG
373 #define		EVP_CTRL_CCM_SET_L		0x14
374 #define		EVP_CTRL_CCM_SET_MSGLEN		0x15
375 /* AEAD cipher deduces payload length and returns number of bytes
376  * required to store MAC and eventual padding. Subsequent call to
377  * EVP_Cipher even appends/verifies MAC.
378  */
379 #define		EVP_CTRL_AEAD_TLS1_AAD		0x16
380 /* Used by composite AEAD ciphers, no-op in GCM, CCM... */
381 #define		EVP_CTRL_AEAD_SET_MAC_KEY	0x17
382 /* Set the GCM invocation field, decrypt only */
383 #define		EVP_CTRL_GCM_SET_IV_INV		0x18
384 
385 /* GCM TLS constants */
386 /* Length of fixed part of IV derived from PRF */
387 #define EVP_GCM_TLS_FIXED_IV_LEN			4
388 /* Length of explicit part of IV part of TLS records */
389 #define EVP_GCM_TLS_EXPLICIT_IV_LEN			8
390 /* Length of tag for TLS */
391 #define EVP_GCM_TLS_TAG_LEN				16
392 
393 typedef struct evp_cipher_info_st {
394 	const EVP_CIPHER *cipher;
395 	unsigned char iv[EVP_MAX_IV_LENGTH];
396 } EVP_CIPHER_INFO;
397 
398 struct evp_cipher_ctx_st {
399 	const EVP_CIPHER *cipher;
400 	ENGINE *engine;	/* functional reference if 'cipher' is ENGINE-provided */
401 	int encrypt;		/* encrypt or decrypt */
402 	int buf_len;		/* number we have left */
403 
404 	unsigned char  oiv[EVP_MAX_IV_LENGTH];	/* original iv */
405 	unsigned char  iv[EVP_MAX_IV_LENGTH];	/* working iv */
406 	unsigned char buf[EVP_MAX_BLOCK_LENGTH];/* saved partial block */
407 	int num;				/* used by cfb/ofb/ctr mode */
408 
409 	void *app_data;		/* application stuff */
410 	int key_len;		/* May change for variable length cipher */
411 	unsigned long flags;	/* Various flags */
412 	void *cipher_data; /* per EVP data */
413 	int final_used;
414 	int block_mask;
415 	unsigned char final[EVP_MAX_BLOCK_LENGTH];/* possible final block */
416 } /* EVP_CIPHER_CTX */;
417 
418 typedef struct evp_Encode_Ctx_st {
419 	int num;	/* number saved in a partial encode/decode */
420 	int length;	/* The length is either the output line length
421 			 * (in input bytes) or the shortest input line
422 			 * length that is ok.  Once decoding begins,
423 			 * the length is adjusted up each time a longer
424 			 * line is decoded */
425 	unsigned char enc_data[80];	/* data to encode */
426 	int line_num;	/* number read on current line */
427 	int expect_nl;
428 } EVP_ENCODE_CTX;
429 
430 /* Password based encryption function */
431 typedef int (EVP_PBE_KEYGEN)(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
432     ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md, int en_de);
433 
434 #ifndef OPENSSL_NO_RSA
435 #define EVP_PKEY_assign_RSA(pkey,rsa) EVP_PKEY_assign((pkey),EVP_PKEY_RSA,\
436 					(char *)(rsa))
437 #endif
438 
439 #ifndef OPENSSL_NO_DSA
440 #define EVP_PKEY_assign_DSA(pkey,dsa) EVP_PKEY_assign((pkey),EVP_PKEY_DSA,\
441 					(char *)(dsa))
442 #endif
443 
444 #ifndef OPENSSL_NO_DH
445 #define EVP_PKEY_assign_DH(pkey,dh) EVP_PKEY_assign((pkey),EVP_PKEY_DH,\
446 					(char *)(dh))
447 #endif
448 
449 #ifndef OPENSSL_NO_EC
450 #define EVP_PKEY_assign_EC_KEY(pkey,eckey) EVP_PKEY_assign((pkey),EVP_PKEY_EC,\
451                                         (char *)(eckey))
452 #endif
453 
454 /* Add some extra combinations */
455 #define EVP_get_digestbynid(a) EVP_get_digestbyname(OBJ_nid2sn(a))
456 #define EVP_get_digestbyobj(a) EVP_get_digestbynid(OBJ_obj2nid(a))
457 #define EVP_get_cipherbynid(a) EVP_get_cipherbyname(OBJ_nid2sn(a))
458 #define EVP_get_cipherbyobj(a) EVP_get_cipherbynid(OBJ_obj2nid(a))
459 
460 int EVP_MD_type(const EVP_MD *md);
461 #define EVP_MD_nid(e)			EVP_MD_type(e)
462 #define EVP_MD_name(e)			OBJ_nid2sn(EVP_MD_nid(e))
463 int EVP_MD_pkey_type(const EVP_MD *md);
464 int EVP_MD_size(const EVP_MD *md);
465 int EVP_MD_block_size(const EVP_MD *md);
466 unsigned long EVP_MD_flags(const EVP_MD *md);
467 
468 const EVP_MD *EVP_MD_CTX_md(const EVP_MD_CTX *ctx);
469 #define EVP_MD_CTX_size(e)		EVP_MD_size(EVP_MD_CTX_md(e))
470 #define EVP_MD_CTX_block_size(e)	EVP_MD_block_size(EVP_MD_CTX_md(e))
471 #define EVP_MD_CTX_type(e)		EVP_MD_type(EVP_MD_CTX_md(e))
472 
473 int EVP_CIPHER_nid(const EVP_CIPHER *cipher);
474 #define EVP_CIPHER_name(e)		OBJ_nid2sn(EVP_CIPHER_nid(e))
475 int EVP_CIPHER_block_size(const EVP_CIPHER *cipher);
476 int EVP_CIPHER_key_length(const EVP_CIPHER *cipher);
477 int EVP_CIPHER_iv_length(const EVP_CIPHER *cipher);
478 unsigned long EVP_CIPHER_flags(const EVP_CIPHER *cipher);
479 #define EVP_CIPHER_mode(e)		(EVP_CIPHER_flags(e) & EVP_CIPH_MODE)
480 
481 const EVP_CIPHER * EVP_CIPHER_CTX_cipher(const EVP_CIPHER_CTX *ctx);
482 int EVP_CIPHER_CTX_nid(const EVP_CIPHER_CTX *ctx);
483 int EVP_CIPHER_CTX_block_size(const EVP_CIPHER_CTX *ctx);
484 int EVP_CIPHER_CTX_key_length(const EVP_CIPHER_CTX *ctx);
485 int EVP_CIPHER_CTX_iv_length(const EVP_CIPHER_CTX *ctx);
486 int EVP_CIPHER_CTX_copy(EVP_CIPHER_CTX *out, const EVP_CIPHER_CTX *in);
487 void * EVP_CIPHER_CTX_get_app_data(const EVP_CIPHER_CTX *ctx);
488 void EVP_CIPHER_CTX_set_app_data(EVP_CIPHER_CTX *ctx, void *data);
489 #define EVP_CIPHER_CTX_type(c)         EVP_CIPHER_type(EVP_CIPHER_CTX_cipher(c))
490 unsigned long EVP_CIPHER_CTX_flags(const EVP_CIPHER_CTX *ctx);
491 #define EVP_CIPHER_CTX_mode(e)		(EVP_CIPHER_CTX_flags(e) & EVP_CIPH_MODE)
492 
493 #define EVP_ENCODE_LENGTH(l)	(((l+2)/3*4)+(l/48+1)*2+80)
494 #define EVP_DECODE_LENGTH(l)	((l+3)/4*3+80)
495 
496 #define EVP_SignInit_ex(a,b,c)		EVP_DigestInit_ex(a,b,c)
497 #define EVP_SignInit(a,b)		EVP_DigestInit(a,b)
498 #define EVP_SignUpdate(a,b,c)		EVP_DigestUpdate(a,b,c)
499 #define	EVP_VerifyInit_ex(a,b,c)	EVP_DigestInit_ex(a,b,c)
500 #define	EVP_VerifyInit(a,b)		EVP_DigestInit(a,b)
501 #define	EVP_VerifyUpdate(a,b,c)		EVP_DigestUpdate(a,b,c)
502 #define EVP_OpenUpdate(a,b,c,d,e)	EVP_DecryptUpdate(a,b,c,d,e)
503 #define EVP_SealUpdate(a,b,c,d,e)	EVP_EncryptUpdate(a,b,c,d,e)
504 #define EVP_DigestSignUpdate(a,b,c)	EVP_DigestUpdate(a,b,c)
505 #define EVP_DigestVerifyUpdate(a,b,c)	EVP_DigestUpdate(a,b,c)
506 
507 #define BIO_set_md(b,md)		BIO_ctrl(b,BIO_C_SET_MD,0,(char *)md)
508 #define BIO_get_md(b,mdp)		BIO_ctrl(b,BIO_C_GET_MD,0,(char *)mdp)
509 #define BIO_get_md_ctx(b,mdcp)     BIO_ctrl(b,BIO_C_GET_MD_CTX,0,(char *)mdcp)
510 #define BIO_set_md_ctx(b,mdcp)     BIO_ctrl(b,BIO_C_SET_MD_CTX,0,(char *)mdcp)
511 #define BIO_get_cipher_status(b)	BIO_ctrl(b,BIO_C_GET_CIPHER_STATUS,0,NULL)
512 #define BIO_get_cipher_ctx(b,c_pp)	BIO_ctrl(b,BIO_C_GET_CIPHER_CTX,0,(char *)c_pp)
513 
514 int EVP_Cipher(EVP_CIPHER_CTX *c, unsigned char *out, const unsigned char *in,
515     unsigned int inl);
516 
517 #define EVP_add_cipher_alias(n,alias) \
518 	OBJ_NAME_add((alias),OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS,(n))
519 #define EVP_add_digest_alias(n,alias) \
520 	OBJ_NAME_add((alias),OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS,(n))
521 #define EVP_delete_cipher_alias(alias) \
522 	OBJ_NAME_remove(alias,OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS);
523 #define EVP_delete_digest_alias(alias) \
524 	OBJ_NAME_remove(alias,OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS);
525 
526 void EVP_MD_CTX_init(EVP_MD_CTX *ctx);
527 int EVP_MD_CTX_cleanup(EVP_MD_CTX *ctx);
528 EVP_MD_CTX *EVP_MD_CTX_create(void);
529 void EVP_MD_CTX_destroy(EVP_MD_CTX *ctx);
530 int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out, const EVP_MD_CTX *in);
531 void EVP_MD_CTX_set_flags(EVP_MD_CTX *ctx, int flags);
532 void EVP_MD_CTX_clear_flags(EVP_MD_CTX *ctx, int flags);
533 int EVP_MD_CTX_test_flags(const EVP_MD_CTX *ctx, int flags);
534 int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, ENGINE *impl);
535 int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *d, size_t cnt);
536 int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s);
537 int EVP_Digest(const void *data, size_t count, unsigned char *md,
538     unsigned int *size, const EVP_MD *type, ENGINE *impl);
539 
540 int EVP_MD_CTX_copy(EVP_MD_CTX *out, const EVP_MD_CTX *in);
541 int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type);
542 int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s);
543 
544 int EVP_read_pw_string(char *buf, int length, const char *prompt, int verify);
545 int EVP_read_pw_string_min(char *buf, int minlen, int maxlen,
546     const char *prompt, int verify);
547 void EVP_set_pw_prompt(const char *prompt);
548 char *EVP_get_pw_prompt(void);
549 
550 int EVP_BytesToKey(const EVP_CIPHER *type, const EVP_MD *md,
551     const unsigned char *salt, const unsigned char *data, int datal, int count,
552     unsigned char *key, unsigned char *iv);
553 
554 void EVP_CIPHER_CTX_set_flags(EVP_CIPHER_CTX *ctx, int flags);
555 void EVP_CIPHER_CTX_clear_flags(EVP_CIPHER_CTX *ctx, int flags);
556 int EVP_CIPHER_CTX_test_flags(const EVP_CIPHER_CTX *ctx, int flags);
557 
558 int EVP_EncryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
559     const unsigned char *key, const unsigned char *iv);
560 int EVP_EncryptInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
561     ENGINE *impl, const unsigned char *key, const unsigned char *iv);
562 int EVP_EncryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
563     const unsigned char *in, int inl);
564 int EVP_EncryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
565 int EVP_EncryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
566 
567 int EVP_DecryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
568     const unsigned char *key, const unsigned char *iv);
569 int EVP_DecryptInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
570     ENGINE *impl, const unsigned char *key, const unsigned char *iv);
571 int EVP_DecryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
572     const unsigned char *in, int inl);
573 int EVP_DecryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
574 int EVP_DecryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
575 
576 int EVP_CipherInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
577     const unsigned char *key, const unsigned char *iv, int enc);
578 int EVP_CipherInit_ex(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
579     ENGINE *impl, const unsigned char *key, const unsigned char *iv, int enc);
580 int EVP_CipherUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl,
581     const unsigned char *in, int inl);
582 int EVP_CipherFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
583 int EVP_CipherFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
584 
585 int EVP_SignFinal(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s,
586     EVP_PKEY *pkey);
587 
588 int EVP_VerifyFinal(EVP_MD_CTX *ctx, const unsigned char *sigbuf,
589     unsigned int siglen, EVP_PKEY *pkey);
590 
591 int EVP_DigestSignInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx,
592     const EVP_MD *type, ENGINE *e, EVP_PKEY *pkey);
593 int EVP_DigestSignFinal(EVP_MD_CTX *ctx, unsigned char *sigret, size_t *siglen);
594 
595 int EVP_DigestVerifyInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx,
596     const EVP_MD *type, ENGINE *e, EVP_PKEY *pkey);
597 int EVP_DigestVerifyFinal(EVP_MD_CTX *ctx, unsigned char *sig, size_t siglen);
598 
599 int EVP_OpenInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type,
600     const unsigned char *ek, int ekl, const unsigned char *iv, EVP_PKEY *priv);
601 int EVP_OpenFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
602 
603 int EVP_SealInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type,
604     unsigned char **ek, int *ekl, unsigned char *iv, EVP_PKEY **pubk,
605     int npubk);
606 int EVP_SealFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
607 
608 void EVP_EncodeInit(EVP_ENCODE_CTX *ctx);
609 void EVP_EncodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl,
610     const unsigned char *in, int inl);
611 void EVP_EncodeFinal(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl);
612 int EVP_EncodeBlock(unsigned char *t, const unsigned char *f, int n);
613 
614 void EVP_DecodeInit(EVP_ENCODE_CTX *ctx);
615 int EVP_DecodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl,
616     const unsigned char *in, int inl);
617 int EVP_DecodeFinal(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl);
618 int EVP_DecodeBlock(unsigned char *t, const unsigned char *f, int n);
619 
620 void EVP_CIPHER_CTX_init(EVP_CIPHER_CTX *a);
621 int EVP_CIPHER_CTX_cleanup(EVP_CIPHER_CTX *a);
622 EVP_CIPHER_CTX *EVP_CIPHER_CTX_new(void);
623 void EVP_CIPHER_CTX_free(EVP_CIPHER_CTX *a);
624 int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *x, int keylen);
625 int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *c, int pad);
626 int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *ctx, int type, int arg, void *ptr);
627 int EVP_CIPHER_CTX_rand_key(EVP_CIPHER_CTX *ctx, unsigned char *key);
628 
629 #ifndef OPENSSL_NO_BIO
630 BIO_METHOD *BIO_f_md(void);
631 BIO_METHOD *BIO_f_base64(void);
632 BIO_METHOD *BIO_f_cipher(void);
633 void BIO_set_cipher(BIO *b, const EVP_CIPHER *c, const unsigned char *k,
634     const unsigned char *i, int enc);
635 #endif
636 
637 const EVP_MD *EVP_md_null(void);
638 #ifndef OPENSSL_NO_MD4
639 const EVP_MD *EVP_md4(void);
640 #endif
641 #ifndef OPENSSL_NO_MD5
642 const EVP_MD *EVP_md5(void);
643 #endif
644 #ifndef OPENSSL_NO_SHA
645 const EVP_MD *EVP_sha(void);
646 const EVP_MD *EVP_sha1(void);
647 const EVP_MD *EVP_dss(void);
648 const EVP_MD *EVP_dss1(void);
649 const EVP_MD *EVP_ecdsa(void);
650 #endif
651 #ifndef OPENSSL_NO_SHA256
652 const EVP_MD *EVP_sha224(void);
653 const EVP_MD *EVP_sha256(void);
654 #endif
655 #ifndef OPENSSL_NO_SHA512
656 const EVP_MD *EVP_sha384(void);
657 const EVP_MD *EVP_sha512(void);
658 #endif
659 #ifndef OPENSSL_NO_MDC2
660 const EVP_MD *EVP_mdc2(void);
661 #endif
662 #ifndef OPENSSL_NO_RIPEMD
663 const EVP_MD *EVP_ripemd160(void);
664 #endif
665 #ifndef OPENSSL_NO_WHIRLPOOL
666 const EVP_MD *EVP_whirlpool(void);
667 #endif
668 const EVP_CIPHER *EVP_enc_null(void);		/* does nothing :-) */
669 #ifndef OPENSSL_NO_DES
670 const EVP_CIPHER *EVP_des_ecb(void);
671 const EVP_CIPHER *EVP_des_ede(void);
672 const EVP_CIPHER *EVP_des_ede3(void);
673 const EVP_CIPHER *EVP_des_ede_ecb(void);
674 const EVP_CIPHER *EVP_des_ede3_ecb(void);
675 const EVP_CIPHER *EVP_des_cfb64(void);
676 # define EVP_des_cfb EVP_des_cfb64
677 const EVP_CIPHER *EVP_des_cfb1(void);
678 const EVP_CIPHER *EVP_des_cfb8(void);
679 const EVP_CIPHER *EVP_des_ede_cfb64(void);
680 # define EVP_des_ede_cfb EVP_des_ede_cfb64
681 #if 0
682 const EVP_CIPHER *EVP_des_ede_cfb1(void);
683 const EVP_CIPHER *EVP_des_ede_cfb8(void);
684 #endif
685 const EVP_CIPHER *EVP_des_ede3_cfb64(void);
686 # define EVP_des_ede3_cfb EVP_des_ede3_cfb64
687 const EVP_CIPHER *EVP_des_ede3_cfb1(void);
688 const EVP_CIPHER *EVP_des_ede3_cfb8(void);
689 const EVP_CIPHER *EVP_des_ofb(void);
690 const EVP_CIPHER *EVP_des_ede_ofb(void);
691 const EVP_CIPHER *EVP_des_ede3_ofb(void);
692 const EVP_CIPHER *EVP_des_cbc(void);
693 const EVP_CIPHER *EVP_des_ede_cbc(void);
694 const EVP_CIPHER *EVP_des_ede3_cbc(void);
695 const EVP_CIPHER *EVP_desx_cbc(void);
696 #endif
697 #ifndef OPENSSL_NO_RC4
698 const EVP_CIPHER *EVP_rc4(void);
699 const EVP_CIPHER *EVP_rc4_40(void);
700 #ifndef OPENSSL_NO_MD5
701 const EVP_CIPHER *EVP_rc4_hmac_md5(void);
702 #endif
703 #endif
704 #ifndef OPENSSL_NO_IDEA
705 const EVP_CIPHER *EVP_idea_ecb(void);
706 const EVP_CIPHER *EVP_idea_cfb64(void);
707 # define EVP_idea_cfb EVP_idea_cfb64
708 const EVP_CIPHER *EVP_idea_ofb(void);
709 const EVP_CIPHER *EVP_idea_cbc(void);
710 #endif
711 #ifndef OPENSSL_NO_RC2
712 const EVP_CIPHER *EVP_rc2_ecb(void);
713 const EVP_CIPHER *EVP_rc2_cbc(void);
714 const EVP_CIPHER *EVP_rc2_40_cbc(void);
715 const EVP_CIPHER *EVP_rc2_64_cbc(void);
716 const EVP_CIPHER *EVP_rc2_cfb64(void);
717 # define EVP_rc2_cfb EVP_rc2_cfb64
718 const EVP_CIPHER *EVP_rc2_ofb(void);
719 #endif
720 #ifndef OPENSSL_NO_BF
721 const EVP_CIPHER *EVP_bf_ecb(void);
722 const EVP_CIPHER *EVP_bf_cbc(void);
723 const EVP_CIPHER *EVP_bf_cfb64(void);
724 # define EVP_bf_cfb EVP_bf_cfb64
725 const EVP_CIPHER *EVP_bf_ofb(void);
726 #endif
727 #ifndef OPENSSL_NO_CAST
728 const EVP_CIPHER *EVP_cast5_ecb(void);
729 const EVP_CIPHER *EVP_cast5_cbc(void);
730 const EVP_CIPHER *EVP_cast5_cfb64(void);
731 # define EVP_cast5_cfb EVP_cast5_cfb64
732 const EVP_CIPHER *EVP_cast5_ofb(void);
733 #endif
734 #ifndef OPENSSL_NO_RC5
735 const EVP_CIPHER *EVP_rc5_32_12_16_cbc(void);
736 const EVP_CIPHER *EVP_rc5_32_12_16_ecb(void);
737 const EVP_CIPHER *EVP_rc5_32_12_16_cfb64(void);
738 # define EVP_rc5_32_12_16_cfb EVP_rc5_32_12_16_cfb64
739 const EVP_CIPHER *EVP_rc5_32_12_16_ofb(void);
740 #endif
741 #ifndef OPENSSL_NO_AES
742 const EVP_CIPHER *EVP_aes_128_ecb(void);
743 const EVP_CIPHER *EVP_aes_128_cbc(void);
744 const EVP_CIPHER *EVP_aes_128_cfb1(void);
745 const EVP_CIPHER *EVP_aes_128_cfb8(void);
746 const EVP_CIPHER *EVP_aes_128_cfb128(void);
747 # define EVP_aes_128_cfb EVP_aes_128_cfb128
748 const EVP_CIPHER *EVP_aes_128_ofb(void);
749 const EVP_CIPHER *EVP_aes_128_ctr(void);
750 const EVP_CIPHER *EVP_aes_128_ccm(void);
751 const EVP_CIPHER *EVP_aes_128_gcm(void);
752 const EVP_CIPHER *EVP_aes_128_xts(void);
753 const EVP_CIPHER *EVP_aes_192_ecb(void);
754 const EVP_CIPHER *EVP_aes_192_cbc(void);
755 const EVP_CIPHER *EVP_aes_192_cfb1(void);
756 const EVP_CIPHER *EVP_aes_192_cfb8(void);
757 const EVP_CIPHER *EVP_aes_192_cfb128(void);
758 # define EVP_aes_192_cfb EVP_aes_192_cfb128
759 const EVP_CIPHER *EVP_aes_192_ofb(void);
760 const EVP_CIPHER *EVP_aes_192_ctr(void);
761 const EVP_CIPHER *EVP_aes_192_ccm(void);
762 const EVP_CIPHER *EVP_aes_192_gcm(void);
763 const EVP_CIPHER *EVP_aes_256_ecb(void);
764 const EVP_CIPHER *EVP_aes_256_cbc(void);
765 const EVP_CIPHER *EVP_aes_256_cfb1(void);
766 const EVP_CIPHER *EVP_aes_256_cfb8(void);
767 const EVP_CIPHER *EVP_aes_256_cfb128(void);
768 # define EVP_aes_256_cfb EVP_aes_256_cfb128
769 const EVP_CIPHER *EVP_aes_256_ofb(void);
770 const EVP_CIPHER *EVP_aes_256_ctr(void);
771 const EVP_CIPHER *EVP_aes_256_ccm(void);
772 const EVP_CIPHER *EVP_aes_256_gcm(void);
773 const EVP_CIPHER *EVP_aes_256_xts(void);
774 #if !defined(OPENSSL_NO_SHA) && !defined(OPENSSL_NO_SHA1)
775 const EVP_CIPHER *EVP_aes_128_cbc_hmac_sha1(void);
776 const EVP_CIPHER *EVP_aes_256_cbc_hmac_sha1(void);
777 #endif
778 #endif
779 #ifndef OPENSSL_NO_CAMELLIA
780 const EVP_CIPHER *EVP_camellia_128_ecb(void);
781 const EVP_CIPHER *EVP_camellia_128_cbc(void);
782 const EVP_CIPHER *EVP_camellia_128_cfb1(void);
783 const EVP_CIPHER *EVP_camellia_128_cfb8(void);
784 const EVP_CIPHER *EVP_camellia_128_cfb128(void);
785 # define EVP_camellia_128_cfb EVP_camellia_128_cfb128
786 const EVP_CIPHER *EVP_camellia_128_ofb(void);
787 const EVP_CIPHER *EVP_camellia_192_ecb(void);
788 const EVP_CIPHER *EVP_camellia_192_cbc(void);
789 const EVP_CIPHER *EVP_camellia_192_cfb1(void);
790 const EVP_CIPHER *EVP_camellia_192_cfb8(void);
791 const EVP_CIPHER *EVP_camellia_192_cfb128(void);
792 # define EVP_camellia_192_cfb EVP_camellia_192_cfb128
793 const EVP_CIPHER *EVP_camellia_192_ofb(void);
794 const EVP_CIPHER *EVP_camellia_256_ecb(void);
795 const EVP_CIPHER *EVP_camellia_256_cbc(void);
796 const EVP_CIPHER *EVP_camellia_256_cfb1(void);
797 const EVP_CIPHER *EVP_camellia_256_cfb8(void);
798 const EVP_CIPHER *EVP_camellia_256_cfb128(void);
799 # define EVP_camellia_256_cfb EVP_camellia_256_cfb128
800 const EVP_CIPHER *EVP_camellia_256_ofb(void);
801 #endif
802 
803 #ifndef OPENSSL_NO_CHACHA
804 const EVP_CIPHER *EVP_chacha20(void);
805 #endif
806 
807 void OPENSSL_add_all_algorithms_noconf(void);
808 void OPENSSL_add_all_algorithms_conf(void);
809 
810 #ifdef OPENSSL_LOAD_CONF
811 #define OpenSSL_add_all_algorithms() OPENSSL_add_all_algorithms_conf()
812 #else
813 #define OpenSSL_add_all_algorithms() OPENSSL_add_all_algorithms_noconf()
814 #endif
815 
816 void OpenSSL_add_all_ciphers(void);
817 void OpenSSL_add_all_digests(void);
818 
819 #define SSLeay_add_all_algorithms() OpenSSL_add_all_algorithms()
820 #define SSLeay_add_all_ciphers() OpenSSL_add_all_ciphers()
821 #define SSLeay_add_all_digests() OpenSSL_add_all_digests()
822 
823 int EVP_add_cipher(const EVP_CIPHER *cipher);
824 int EVP_add_digest(const EVP_MD *digest);
825 
826 const EVP_CIPHER *EVP_get_cipherbyname(const char *name);
827 const EVP_MD *EVP_get_digestbyname(const char *name);
828 void EVP_cleanup(void);
829 
830 void EVP_CIPHER_do_all(void (*fn)(const EVP_CIPHER *ciph, const char *from,
831     const char *to, void *x), void *arg);
832 void EVP_CIPHER_do_all_sorted(void (*fn)(const EVP_CIPHER *ciph,
833     const char *from, const char *to, void *x), void *arg);
834 
835 void EVP_MD_do_all(void (*fn)(const EVP_MD *ciph, const char *from,
836     const char *to, void *x), void *arg);
837 void EVP_MD_do_all_sorted(void (*fn)(const EVP_MD *ciph, const char *from,
838     const char *to, void *x), void *arg);
839 
840 int EVP_PKEY_decrypt_old(unsigned char *dec_key, const unsigned char *enc_key,
841     int enc_key_len, EVP_PKEY *private_key);
842 int EVP_PKEY_encrypt_old(unsigned char *enc_key, const unsigned char *key,
843     int key_len, EVP_PKEY *pub_key);
844 int EVP_PKEY_type(int type);
845 int EVP_PKEY_id(const EVP_PKEY *pkey);
846 int EVP_PKEY_base_id(const EVP_PKEY *pkey);
847 int EVP_PKEY_bits(EVP_PKEY *pkey);
848 int EVP_PKEY_size(EVP_PKEY *pkey);
849 int EVP_PKEY_set_type(EVP_PKEY *pkey, int type);
850 int EVP_PKEY_set_type_str(EVP_PKEY *pkey, const char *str, int len);
851 int EVP_PKEY_assign(EVP_PKEY *pkey, int type, void *key);
852 void *EVP_PKEY_get0(EVP_PKEY *pkey);
853 
854 #ifndef OPENSSL_NO_RSA
855 struct rsa_st;
856 int EVP_PKEY_set1_RSA(EVP_PKEY *pkey, struct rsa_st *key);
857 struct rsa_st *EVP_PKEY_get1_RSA(EVP_PKEY *pkey);
858 #endif
859 #ifndef OPENSSL_NO_DSA
860 struct dsa_st;
861 int EVP_PKEY_set1_DSA(EVP_PKEY *pkey, struct dsa_st *key);
862 struct dsa_st *EVP_PKEY_get1_DSA(EVP_PKEY *pkey);
863 #endif
864 #ifndef OPENSSL_NO_DH
865 struct dh_st;
866 int EVP_PKEY_set1_DH(EVP_PKEY *pkey, struct dh_st *key);
867 struct dh_st *EVP_PKEY_get1_DH(EVP_PKEY *pkey);
868 #endif
869 #ifndef OPENSSL_NO_EC
870 struct ec_key_st;
871 int EVP_PKEY_set1_EC_KEY(EVP_PKEY *pkey, struct ec_key_st *key);
872 struct ec_key_st *EVP_PKEY_get1_EC_KEY(EVP_PKEY *pkey);
873 #endif
874 
875 EVP_PKEY *EVP_PKEY_new(void);
876 void EVP_PKEY_free(EVP_PKEY *pkey);
877 
878 EVP_PKEY *d2i_PublicKey(int type, EVP_PKEY **a, const unsigned char **pp,
879     long length);
880 int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp);
881 
882 EVP_PKEY *d2i_PrivateKey(int type, EVP_PKEY **a, const unsigned char **pp,
883     long length);
884 EVP_PKEY *d2i_AutoPrivateKey(EVP_PKEY **a, const unsigned char **pp,
885     long length);
886 int i2d_PrivateKey(EVP_PKEY *a, unsigned char **pp);
887 
888 int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);
889 int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);
890 int EVP_PKEY_save_parameters(EVP_PKEY *pkey, int mode);
891 int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);
892 
893 int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);
894 
895 int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey, int indent,
896     ASN1_PCTX *pctx);
897 int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey, int indent,
898     ASN1_PCTX *pctx);
899 int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey, int indent,
900     ASN1_PCTX *pctx);
901 
902 int EVP_PKEY_get_default_digest_nid(EVP_PKEY *pkey, int *pnid);
903 
904 int EVP_CIPHER_type(const EVP_CIPHER *ctx);
905 
906 /* calls methods */
907 int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
908 int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
909 
910 /* These are used by EVP_CIPHER methods */
911 int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
912 int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
913 
914 /* PKCS5 password based encryption */
915 int PKCS5_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
916     ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md, int en_de);
917 int PKCS5_PBKDF2_HMAC_SHA1(const char *pass, int passlen,
918     const unsigned char *salt, int saltlen, int iter, int keylen,
919     unsigned char *out);
920 int PKCS5_PBKDF2_HMAC(const char *pass, int passlen, const unsigned char *salt,
921     int saltlen, int iter, const EVP_MD *digest, int keylen,
922     unsigned char *out);
923 int PKCS5_v2_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
924     ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md,
925     int en_de);
926 
927 void PKCS5_PBE_add(void);
928 
929 int EVP_PBE_CipherInit (ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
930     ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de);
931 
932 /* PBE type */
933 
934 /* Can appear as the outermost AlgorithmIdentifier */
935 #define EVP_PBE_TYPE_OUTER	0x0
936 /* Is an PRF type OID */
937 #define EVP_PBE_TYPE_PRF	0x1
938 
939 int EVP_PBE_alg_add_type(int pbe_type, int pbe_nid, int cipher_nid, int md_nid,
940     EVP_PBE_KEYGEN *keygen);
941 int EVP_PBE_alg_add(int nid, const EVP_CIPHER *cipher, const EVP_MD *md,
942     EVP_PBE_KEYGEN *keygen);
943 int EVP_PBE_find(int type, int pbe_nid, int *pcnid, int *pmnid,
944     EVP_PBE_KEYGEN **pkeygen);
945 void EVP_PBE_cleanup(void);
946 
947 #define ASN1_PKEY_ALIAS		0x1
948 #define ASN1_PKEY_DYNAMIC	0x2
949 #define ASN1_PKEY_SIGPARAM_NULL	0x4
950 
951 #define ASN1_PKEY_CTRL_PKCS7_SIGN	0x1
952 #define ASN1_PKEY_CTRL_PKCS7_ENCRYPT	0x2
953 #define ASN1_PKEY_CTRL_DEFAULT_MD_NID	0x3
954 #define ASN1_PKEY_CTRL_CMS_SIGN		0x5
955 #define ASN1_PKEY_CTRL_CMS_ENVELOPE	0x7
956 
957 int EVP_PKEY_asn1_get_count(void);
958 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_get0(int idx);
959 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find(ENGINE **pe, int type);
960 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find_str(ENGINE **pe,
961     const char *str, int len);
962 int EVP_PKEY_asn1_add0(const EVP_PKEY_ASN1_METHOD *ameth);
963 int EVP_PKEY_asn1_add_alias(int to, int from);
964 int EVP_PKEY_asn1_get0_info(int *ppkey_id, int *pkey_base_id, int *ppkey_flags,
965     const char **pinfo, const char **ppem_str,
966     const EVP_PKEY_ASN1_METHOD *ameth);
967 
968 const EVP_PKEY_ASN1_METHOD* EVP_PKEY_get0_asn1(EVP_PKEY *pkey);
969 EVP_PKEY_ASN1_METHOD* EVP_PKEY_asn1_new(int id, int flags, const char *pem_str,
970     const char *info);
971 void EVP_PKEY_asn1_copy(EVP_PKEY_ASN1_METHOD *dst,
972     const EVP_PKEY_ASN1_METHOD *src);
973 void EVP_PKEY_asn1_free(EVP_PKEY_ASN1_METHOD *ameth);
974 void EVP_PKEY_asn1_set_public(EVP_PKEY_ASN1_METHOD *ameth,
975     int (*pub_decode)(EVP_PKEY *pk, X509_PUBKEY *pub),
976     int (*pub_encode)(X509_PUBKEY *pub, const EVP_PKEY *pk),
977     int (*pub_cmp)(const EVP_PKEY *a, const EVP_PKEY *b),
978     int (*pub_print)(BIO *out, const EVP_PKEY *pkey, int indent,
979     ASN1_PCTX *pctx),
980     int (*pkey_size)(const EVP_PKEY *pk),
981     int (*pkey_bits)(const EVP_PKEY *pk));
982 void EVP_PKEY_asn1_set_private(EVP_PKEY_ASN1_METHOD *ameth,
983     int (*priv_decode)(EVP_PKEY *pk, PKCS8_PRIV_KEY_INFO *p8inf),
984     int (*priv_encode)(PKCS8_PRIV_KEY_INFO *p8, const EVP_PKEY *pk),
985     int (*priv_print)(BIO *out, const EVP_PKEY *pkey, int indent,
986     ASN1_PCTX *pctx));
987 void EVP_PKEY_asn1_set_param(EVP_PKEY_ASN1_METHOD *ameth,
988     int (*param_decode)(EVP_PKEY *pkey, const unsigned char **pder, int derlen),
989     int (*param_encode)(const EVP_PKEY *pkey, unsigned char **pder),
990     int (*param_missing)(const EVP_PKEY *pk),
991     int (*param_copy)(EVP_PKEY *to, const EVP_PKEY *from),
992     int (*param_cmp)(const EVP_PKEY *a, const EVP_PKEY *b),
993     int (*param_print)(BIO *out, const EVP_PKEY *pkey, int indent,
994     ASN1_PCTX *pctx));
995 
996 void EVP_PKEY_asn1_set_free(EVP_PKEY_ASN1_METHOD *ameth,
997     void (*pkey_free)(EVP_PKEY *pkey));
998 void EVP_PKEY_asn1_set_ctrl(EVP_PKEY_ASN1_METHOD *ameth,
999     int (*pkey_ctrl)(EVP_PKEY *pkey, int op, long arg1, void *arg2));
1000 
1001 #define EVP_PKEY_OP_UNDEFINED		0
1002 #define EVP_PKEY_OP_PARAMGEN		(1<<1)
1003 #define EVP_PKEY_OP_KEYGEN		(1<<2)
1004 #define EVP_PKEY_OP_SIGN		(1<<3)
1005 #define EVP_PKEY_OP_VERIFY		(1<<4)
1006 #define EVP_PKEY_OP_VERIFYRECOVER	(1<<5)
1007 #define EVP_PKEY_OP_SIGNCTX		(1<<6)
1008 #define EVP_PKEY_OP_VERIFYCTX		(1<<7)
1009 #define EVP_PKEY_OP_ENCRYPT		(1<<8)
1010 #define EVP_PKEY_OP_DECRYPT		(1<<9)
1011 #define EVP_PKEY_OP_DERIVE		(1<<10)
1012 
1013 #define EVP_PKEY_OP_TYPE_SIG	\
1014 	(EVP_PKEY_OP_SIGN | EVP_PKEY_OP_VERIFY | EVP_PKEY_OP_VERIFYRECOVER \
1015 		| EVP_PKEY_OP_SIGNCTX | EVP_PKEY_OP_VERIFYCTX)
1016 
1017 #define EVP_PKEY_OP_TYPE_CRYPT \
1018 	(EVP_PKEY_OP_ENCRYPT | EVP_PKEY_OP_DECRYPT)
1019 
1020 #define EVP_PKEY_OP_TYPE_NOGEN \
1021 	(EVP_PKEY_OP_SIG | EVP_PKEY_OP_CRYPT | EVP_PKEY_OP_DERIVE)
1022 
1023 #define EVP_PKEY_OP_TYPE_GEN \
1024 		(EVP_PKEY_OP_PARAMGEN | EVP_PKEY_OP_KEYGEN)
1025 
1026 #define	 EVP_PKEY_CTX_set_signature_md(ctx, md)	\
1027 		EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_TYPE_SIG,  \
1028 					EVP_PKEY_CTRL_MD, 0, (void *)md)
1029 
1030 #define EVP_PKEY_CTRL_MD		1
1031 #define EVP_PKEY_CTRL_PEER_KEY		2
1032 
1033 #define EVP_PKEY_CTRL_PKCS7_ENCRYPT	3
1034 #define EVP_PKEY_CTRL_PKCS7_DECRYPT	4
1035 
1036 #define EVP_PKEY_CTRL_PKCS7_SIGN	5
1037 
1038 #define EVP_PKEY_CTRL_SET_MAC_KEY	6
1039 
1040 #define EVP_PKEY_CTRL_DIGESTINIT	7
1041 
1042 /* Used by GOST key encryption in TLS */
1043 #define EVP_PKEY_CTRL_SET_IV 		8
1044 
1045 #define EVP_PKEY_CTRL_CMS_ENCRYPT	9
1046 #define EVP_PKEY_CTRL_CMS_DECRYPT	10
1047 #define EVP_PKEY_CTRL_CMS_SIGN		11
1048 
1049 #define EVP_PKEY_CTRL_CIPHER		12
1050 
1051 #define EVP_PKEY_ALG_CTRL		0x1000
1052 
1053 
1054 #define EVP_PKEY_FLAG_AUTOARGLEN	2
1055 /* Method handles all operations: don't assume any digest related
1056  * defaults.
1057  */
1058 #define EVP_PKEY_FLAG_SIGCTX_CUSTOM	4
1059 
1060 const EVP_PKEY_METHOD *EVP_PKEY_meth_find(int type);
1061 EVP_PKEY_METHOD* EVP_PKEY_meth_new(int id, int flags);
1062 void EVP_PKEY_meth_get0_info(int *ppkey_id, int *pflags,
1063     const EVP_PKEY_METHOD *meth);
1064 void EVP_PKEY_meth_copy(EVP_PKEY_METHOD *dst, const EVP_PKEY_METHOD *src);
1065 void EVP_PKEY_meth_free(EVP_PKEY_METHOD *pmeth);
1066 int EVP_PKEY_meth_add0(const EVP_PKEY_METHOD *pmeth);
1067 
1068 EVP_PKEY_CTX *EVP_PKEY_CTX_new(EVP_PKEY *pkey, ENGINE *e);
1069 EVP_PKEY_CTX *EVP_PKEY_CTX_new_id(int id, ENGINE *e);
1070 EVP_PKEY_CTX *EVP_PKEY_CTX_dup(EVP_PKEY_CTX *ctx);
1071 void EVP_PKEY_CTX_free(EVP_PKEY_CTX *ctx);
1072 
1073 int EVP_PKEY_CTX_ctrl(EVP_PKEY_CTX *ctx, int keytype, int optype, int cmd,
1074     int p1, void *p2);
1075 int EVP_PKEY_CTX_ctrl_str(EVP_PKEY_CTX *ctx, const char *type,
1076     const char *value);
1077 
1078 int EVP_PKEY_CTX_get_operation(EVP_PKEY_CTX *ctx);
1079 void EVP_PKEY_CTX_set0_keygen_info(EVP_PKEY_CTX *ctx, int *dat, int datlen);
1080 
1081 EVP_PKEY *EVP_PKEY_new_mac_key(int type, ENGINE *e, const unsigned char *key,
1082     int keylen);
1083 
1084 void EVP_PKEY_CTX_set_data(EVP_PKEY_CTX *ctx, void *data);
1085 void *EVP_PKEY_CTX_get_data(EVP_PKEY_CTX *ctx);
1086 EVP_PKEY *EVP_PKEY_CTX_get0_pkey(EVP_PKEY_CTX *ctx);
1087 
1088 EVP_PKEY *EVP_PKEY_CTX_get0_peerkey(EVP_PKEY_CTX *ctx);
1089 
1090 void EVP_PKEY_CTX_set_app_data(EVP_PKEY_CTX *ctx, void *data);
1091 void *EVP_PKEY_CTX_get_app_data(EVP_PKEY_CTX *ctx);
1092 
1093 int EVP_PKEY_sign_init(EVP_PKEY_CTX *ctx);
1094 int EVP_PKEY_sign(EVP_PKEY_CTX *ctx, unsigned char *sig, size_t *siglen,
1095     const unsigned char *tbs, size_t tbslen);
1096 int EVP_PKEY_verify_init(EVP_PKEY_CTX *ctx);
1097 int EVP_PKEY_verify(EVP_PKEY_CTX *ctx, const unsigned char *sig, size_t siglen,
1098     const unsigned char *tbs, size_t tbslen);
1099 int EVP_PKEY_verify_recover_init(EVP_PKEY_CTX *ctx);
1100 int EVP_PKEY_verify_recover(EVP_PKEY_CTX *ctx, unsigned char *rout,
1101     size_t *routlen, const unsigned char *sig, size_t siglen);
1102 int EVP_PKEY_encrypt_init(EVP_PKEY_CTX *ctx);
1103 int EVP_PKEY_encrypt(EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen,
1104     const unsigned char *in, size_t inlen);
1105 int EVP_PKEY_decrypt_init(EVP_PKEY_CTX *ctx);
1106 int EVP_PKEY_decrypt(EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen,
1107     const unsigned char *in, size_t inlen);
1108 
1109 int EVP_PKEY_derive_init(EVP_PKEY_CTX *ctx);
1110 int EVP_PKEY_derive_set_peer(EVP_PKEY_CTX *ctx, EVP_PKEY *peer);
1111 int EVP_PKEY_derive(EVP_PKEY_CTX *ctx, unsigned char *key, size_t *keylen);
1112 
1113 typedef int EVP_PKEY_gen_cb(EVP_PKEY_CTX *ctx);
1114 
1115 int EVP_PKEY_paramgen_init(EVP_PKEY_CTX *ctx);
1116 int EVP_PKEY_paramgen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey);
1117 int EVP_PKEY_keygen_init(EVP_PKEY_CTX *ctx);
1118 int EVP_PKEY_keygen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey);
1119 
1120 void EVP_PKEY_CTX_set_cb(EVP_PKEY_CTX *ctx, EVP_PKEY_gen_cb *cb);
1121 EVP_PKEY_gen_cb *EVP_PKEY_CTX_get_cb(EVP_PKEY_CTX *ctx);
1122 
1123 int EVP_PKEY_CTX_get_keygen_info(EVP_PKEY_CTX *ctx, int idx);
1124 
1125 void EVP_PKEY_meth_set_init(EVP_PKEY_METHOD *pmeth,
1126     int (*init)(EVP_PKEY_CTX *ctx));
1127 
1128 void EVP_PKEY_meth_set_copy(EVP_PKEY_METHOD *pmeth,
1129     int (*copy)(EVP_PKEY_CTX *dst, EVP_PKEY_CTX *src));
1130 
1131 void EVP_PKEY_meth_set_cleanup(EVP_PKEY_METHOD *pmeth,
1132     void (*cleanup)(EVP_PKEY_CTX *ctx));
1133 
1134 void EVP_PKEY_meth_set_paramgen(EVP_PKEY_METHOD *pmeth,
1135     int (*paramgen_init)(EVP_PKEY_CTX *ctx),
1136     int (*paramgen)(EVP_PKEY_CTX *ctx, EVP_PKEY *pkey));
1137 
1138 void EVP_PKEY_meth_set_keygen(EVP_PKEY_METHOD *pmeth,
1139     int (*keygen_init)(EVP_PKEY_CTX *ctx),
1140     int (*keygen)(EVP_PKEY_CTX *ctx, EVP_PKEY *pkey));
1141 
1142 void EVP_PKEY_meth_set_sign(EVP_PKEY_METHOD *pmeth,
1143     int (*sign_init)(EVP_PKEY_CTX *ctx),
1144     int (*sign)(EVP_PKEY_CTX *ctx, unsigned char *sig, size_t *siglen,
1145     const unsigned char *tbs, size_t tbslen));
1146 
1147 void EVP_PKEY_meth_set_verify(EVP_PKEY_METHOD *pmeth,
1148     int (*verify_init)(EVP_PKEY_CTX *ctx),
1149     int (*verify)(EVP_PKEY_CTX *ctx, const unsigned char *sig, size_t siglen,
1150     const unsigned char *tbs, size_t tbslen));
1151 
1152 void EVP_PKEY_meth_set_verify_recover(EVP_PKEY_METHOD *pmeth,
1153     int (*verify_recover_init)(EVP_PKEY_CTX *ctx),
1154     int (*verify_recover)(EVP_PKEY_CTX *ctx, unsigned char *sig,
1155     size_t *siglen, const unsigned char *tbs, size_t tbslen));
1156 
1157 void EVP_PKEY_meth_set_signctx(EVP_PKEY_METHOD *pmeth,
1158     int (*signctx_init)(EVP_PKEY_CTX *ctx, EVP_MD_CTX *mctx),
1159     int (*signctx)(EVP_PKEY_CTX *ctx, unsigned char *sig, size_t *siglen,
1160     EVP_MD_CTX *mctx));
1161 
1162 void EVP_PKEY_meth_set_verifyctx(EVP_PKEY_METHOD *pmeth,
1163     int (*verifyctx_init)(EVP_PKEY_CTX *ctx, EVP_MD_CTX *mctx),
1164     int (*verifyctx)(EVP_PKEY_CTX *ctx, const unsigned char *sig, int siglen,
1165     EVP_MD_CTX *mctx));
1166 
1167 void EVP_PKEY_meth_set_encrypt(EVP_PKEY_METHOD *pmeth,
1168     int (*encrypt_init)(EVP_PKEY_CTX *ctx),
1169     int (*encryptfn)(EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen,
1170     const unsigned char *in, size_t inlen));
1171 
1172 void EVP_PKEY_meth_set_decrypt(EVP_PKEY_METHOD *pmeth,
1173     int (*decrypt_init)(EVP_PKEY_CTX *ctx),
1174     int (*decrypt)(EVP_PKEY_CTX *ctx, unsigned char *out, size_t *outlen,
1175     const unsigned char *in, size_t inlen));
1176 
1177 void EVP_PKEY_meth_set_derive(EVP_PKEY_METHOD *pmeth,
1178     int (*derive_init)(EVP_PKEY_CTX *ctx),
1179     int (*derive)(EVP_PKEY_CTX *ctx, unsigned char *key, size_t *keylen));
1180 
1181 void EVP_PKEY_meth_set_ctrl(EVP_PKEY_METHOD *pmeth,
1182     int (*ctrl)(EVP_PKEY_CTX *ctx, int type, int p1, void *p2),
1183     int (*ctrl_str)(EVP_PKEY_CTX *ctx, const char *type, const char *value));
1184 
1185 /* Authenticated Encryption with Additional Data.
1186  *
1187  * AEAD couples confidentiality and integrity in a single primtive. AEAD
1188  * algorithms take a key and then can seal and open individual messages. Each
1189  * message has a unique, per-message nonce and, optionally, additional data
1190  * which is authenticated but not included in the output. */
1191 
1192 struct evp_aead_st;
1193 typedef struct evp_aead_st EVP_AEAD;
1194 
1195 #ifndef OPENSSL_NO_AES
1196 /* EVP_aes_128_gcm is AES-128 in Galois Counter Mode. */
1197 const EVP_AEAD *EVP_aead_aes_128_gcm(void);
1198 /* EVP_aes_256_gcm is AES-256 in Galois Counter Mode. */
1199 const EVP_AEAD *EVP_aead_aes_256_gcm(void);
1200 #endif
1201 
1202 #if !defined(OPENSSL_NO_CHACHA) && !defined(OPENSSL_NO_POLY1305)
1203 /* EVP_aead_chacha20_poly1305 is ChaCha20 with a Poly1305 authenticator. */
1204 const EVP_AEAD *EVP_aead_chacha20_poly1305(void);
1205 #endif
1206 
1207 /* EVP_AEAD_key_length returns the length of the keys used. */
1208 size_t EVP_AEAD_key_length(const EVP_AEAD *aead);
1209 
1210 /* EVP_AEAD_nonce_length returns the length of the per-message nonce. */
1211 size_t EVP_AEAD_nonce_length(const EVP_AEAD *aead);
1212 
1213 /* EVP_AEAD_max_overhead returns the maximum number of additional bytes added
1214  * by the act of sealing data with the AEAD. */
1215 size_t EVP_AEAD_max_overhead(const EVP_AEAD *aead);
1216 
1217 /* EVP_AEAD_max_tag_len returns the maximum tag length when using this AEAD.
1218  * This * is the largest value that can be passed as a tag length to
1219  * EVP_AEAD_CTX_init. */
1220 size_t EVP_AEAD_max_tag_len(const EVP_AEAD *aead);
1221 
1222 /* An EVP_AEAD_CTX represents an AEAD algorithm configured with a specific key
1223  * and message-independent IV. */
1224 typedef struct evp_aead_ctx_st {
1225 	const EVP_AEAD *aead;
1226 	/* aead_state is an opaque pointer to the AEAD specific state. */
1227 	void *aead_state;
1228 } EVP_AEAD_CTX;
1229 
1230 /* EVP_AEAD_MAX_TAG_LENGTH is the maximum tag length used by any AEAD
1231  * defined in this header. */
1232 #define EVP_AEAD_MAX_TAG_LENGTH 16
1233 
1234 /* EVP_AEAD_DEFAULT_TAG_LENGTH is a magic value that can be passed to
1235  * EVP_AEAD_CTX_init to indicate that the default tag length for an AEAD
1236  * should be used. */
1237 #define EVP_AEAD_DEFAULT_TAG_LENGTH 0
1238 
1239 /* EVP_AEAD_init initializes the context for the given AEAD algorithm.
1240  * The implementation argument may be NULL to choose the default implementation.
1241  * Authentication tags may be truncated by passing a tag length. A tag length
1242  * of zero indicates the default tag length should be used. */
1243 int EVP_AEAD_CTX_init(EVP_AEAD_CTX *ctx, const EVP_AEAD *aead,
1244     const unsigned char *key, size_t key_len, size_t tag_len, ENGINE *impl);
1245 
1246 /* EVP_AEAD_CTX_cleanup frees any data allocated for this context. */
1247 void EVP_AEAD_CTX_cleanup(EVP_AEAD_CTX *ctx);
1248 
1249 /* EVP_AEAD_CTX_seal encrypts and authenticates the input and authenticates
1250  * any additional data (AD), the result being written as output. One is
1251  * returned on success, otherwise zero.
1252  *
1253  * This function may be called (with the same EVP_AEAD_CTX) concurrently with
1254  * itself or EVP_AEAD_CTX_open.
1255  *
1256  * At most max_out_len bytes are written as output and, in order to ensure
1257  * success, this value should be the length of the input plus the result of
1258  * EVP_AEAD_overhead. On successful return, out_len is set to the actual
1259  * number of bytes written.
1260  *
1261  * The length of the nonce is must be equal to the result of
1262  * EVP_AEAD_nonce_length for this AEAD.
1263  *
1264  * EVP_AEAD_CTX_seal never results in a partial output. If max_out_len is
1265  * insufficient, zero will be returned and out_len will be set to zero.
1266  *
1267  * If the input and output are aliased then out must be <= in. */
1268 int EVP_AEAD_CTX_seal(const EVP_AEAD_CTX *ctx, unsigned char *out,
1269     size_t *out_len, size_t max_out_len, const unsigned char *nonce,
1270     size_t nonce_len, const unsigned char *in, size_t in_len,
1271     const unsigned char *ad, size_t ad_len);
1272 
1273 /* EVP_AEAD_CTX_open authenticates the input and additional data, decrypting
1274  * the input and writing it as output. One is returned on success, otherwise
1275  * zero.
1276  *
1277  * This function may be called (with the same EVP_AEAD_CTX) concurrently with
1278  * itself or EVP_AEAD_CTX_seal.
1279  *
1280  * At most the number of input bytes are written as output. In order to ensure
1281  * success, max_out_len should be at least the same as the input length. On
1282  * successful return out_len is set to the actual number of bytes written.
1283  *
1284  * The length of nonce must be equal to the result of EVP_AEAD_nonce_length
1285  * for this AEAD.
1286  *
1287  * EVP_AEAD_CTX_open never results in a partial output. If max_out_len is
1288  * insufficient, zero will be returned and out_len will be set to zero.
1289  *
1290  * If the input and output are aliased then out must be <= in. */
1291 int EVP_AEAD_CTX_open(const EVP_AEAD_CTX *ctx, unsigned char *out,
1292     size_t *out_len, size_t max_out_len, const unsigned char *nonce,
1293     size_t nonce_len, const unsigned char *in, size_t in_len,
1294     const unsigned char *ad, size_t ad_len);
1295 
1296 void EVP_add_alg_module(void);
1297 
1298 /* BEGIN ERROR CODES */
1299 /* The following lines are auto generated by the script mkerr.pl. Any changes
1300  * made after this point may be overwritten when the script is next run.
1301  */
1302 void ERR_load_EVP_strings(void);
1303 
1304 /* Error codes for the EVP functions. */
1305 
1306 /* Function codes. */
1307 #define EVP_F_AEAD_AES_GCM_INIT				 187
1308 #define EVP_F_AEAD_AES_GCM_OPEN				 188
1309 #define EVP_F_AEAD_AES_GCM_SEAL				 189
1310 #define EVP_F_AEAD_CHACHA20_POLY1305_INIT		 192
1311 #define EVP_F_AEAD_CHACHA20_POLY1305_OPEN		 193
1312 #define EVP_F_AEAD_CHACHA20_POLY1305_SEAL		 194
1313 #define EVP_F_AEAD_CTX_OPEN				 185
1314 #define EVP_F_AEAD_CTX_SEAL				 186
1315 #define EVP_F_AESNI_INIT_KEY				 165
1316 #define EVP_F_AESNI_XTS_CIPHER				 176
1317 #define EVP_F_AES_INIT_KEY				 133
1318 #define EVP_F_AES_XTS					 172
1319 #define EVP_F_AES_XTS_CIPHER				 175
1320 #define EVP_F_ALG_MODULE_INIT				 177
1321 #define EVP_F_CAMELLIA_INIT_KEY				 159
1322 #define EVP_F_CMAC_INIT					 173
1323 #define EVP_F_D2I_PKEY					 100
1324 #define EVP_F_DO_SIGVER_INIT				 161
1325 #define EVP_F_DSAPKEY2PKCS8				 134
1326 #define EVP_F_DSA_PKEY2PKCS8				 135
1327 #define EVP_F_ECDSA_PKEY2PKCS8				 129
1328 #define EVP_F_ECKEY_PKEY2PKCS8				 132
1329 #define EVP_F_EVP_AEAD_CTX_INIT				 180
1330 #define EVP_F_EVP_AEAD_CTX_OPEN				 190
1331 #define EVP_F_EVP_AEAD_CTX_SEAL				 191
1332 #define EVP_F_EVP_CIPHERINIT_EX				 123
1333 #define EVP_F_EVP_CIPHER_CTX_COPY			 163
1334 #define EVP_F_EVP_CIPHER_CTX_CTRL			 124
1335 #define EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH		 122
1336 #define EVP_F_EVP_DECRYPTFINAL_EX			 101
1337 #define EVP_F_EVP_DIGESTINIT_EX				 128
1338 #define EVP_F_EVP_ENCRYPTFINAL_EX			 127
1339 #define EVP_F_EVP_MD_CTX_COPY_EX			 110
1340 #define EVP_F_EVP_MD_SIZE				 162
1341 #define EVP_F_EVP_OPENINIT				 102
1342 #define EVP_F_EVP_PBE_ALG_ADD				 115
1343 #define EVP_F_EVP_PBE_ALG_ADD_TYPE			 160
1344 #define EVP_F_EVP_PBE_CIPHERINIT			 116
1345 #define EVP_F_EVP_PKCS82PKEY				 111
1346 #define EVP_F_EVP_PKCS82PKEY_BROKEN			 136
1347 #define EVP_F_EVP_PKEY2PKCS8_BROKEN			 113
1348 #define EVP_F_EVP_PKEY_COPY_PARAMETERS			 103
1349 #define EVP_F_EVP_PKEY_CTX_CTRL				 137
1350 #define EVP_F_EVP_PKEY_CTX_CTRL_STR			 150
1351 #define EVP_F_EVP_PKEY_CTX_DUP				 156
1352 #define EVP_F_EVP_PKEY_DECRYPT				 104
1353 #define EVP_F_EVP_PKEY_DECRYPT_INIT			 138
1354 #define EVP_F_EVP_PKEY_DECRYPT_OLD			 151
1355 #define EVP_F_EVP_PKEY_DERIVE				 153
1356 #define EVP_F_EVP_PKEY_DERIVE_INIT			 154
1357 #define EVP_F_EVP_PKEY_DERIVE_SET_PEER			 155
1358 #define EVP_F_EVP_PKEY_ENCRYPT				 105
1359 #define EVP_F_EVP_PKEY_ENCRYPT_INIT			 139
1360 #define EVP_F_EVP_PKEY_ENCRYPT_OLD			 152
1361 #define EVP_F_EVP_PKEY_GET1_DH				 119
1362 #define EVP_F_EVP_PKEY_GET1_DSA				 120
1363 #define EVP_F_EVP_PKEY_GET1_ECDSA			 130
1364 #define EVP_F_EVP_PKEY_GET1_EC_KEY			 131
1365 #define EVP_F_EVP_PKEY_GET1_RSA				 121
1366 #define EVP_F_EVP_PKEY_KEYGEN				 146
1367 #define EVP_F_EVP_PKEY_KEYGEN_INIT			 147
1368 #define EVP_F_EVP_PKEY_NEW				 106
1369 #define EVP_F_EVP_PKEY_PARAMGEN				 148
1370 #define EVP_F_EVP_PKEY_PARAMGEN_INIT			 149
1371 #define EVP_F_EVP_PKEY_SIGN				 140
1372 #define EVP_F_EVP_PKEY_SIGN_INIT			 141
1373 #define EVP_F_EVP_PKEY_VERIFY				 142
1374 #define EVP_F_EVP_PKEY_VERIFY_INIT			 143
1375 #define EVP_F_EVP_PKEY_VERIFY_RECOVER			 144
1376 #define EVP_F_EVP_PKEY_VERIFY_RECOVER_INIT		 145
1377 #define EVP_F_EVP_RIJNDAEL				 126
1378 #define EVP_F_EVP_SIGNFINAL				 107
1379 #define EVP_F_EVP_VERIFYFINAL				 108
1380 #define EVP_F_FIPS_CIPHERINIT				 166
1381 #define EVP_F_FIPS_CIPHER_CTX_COPY			 170
1382 #define EVP_F_FIPS_CIPHER_CTX_CTRL			 167
1383 #define EVP_F_FIPS_CIPHER_CTX_SET_KEY_LENGTH		 171
1384 #define EVP_F_FIPS_DIGESTINIT				 168
1385 #define EVP_F_FIPS_MD_CTX_COPY				 169
1386 #define EVP_F_HMAC_INIT_EX				 174
1387 #define EVP_F_INT_CTX_NEW				 157
1388 #define EVP_F_PKCS5_PBE_KEYIVGEN			 117
1389 #define EVP_F_PKCS5_V2_PBE_KEYIVGEN			 118
1390 #define EVP_F_PKCS5_V2_PBKDF2_KEYIVGEN			 164
1391 #define EVP_F_PKCS8_SET_BROKEN				 112
1392 #define EVP_F_PKEY_SET_TYPE				 158
1393 #define EVP_F_RC2_MAGIC_TO_METH				 109
1394 #define EVP_F_RC5_CTRL					 125
1395 
1396 /* Reason codes. */
1397 #define EVP_R_AES_IV_SETUP_FAILED			 162
1398 #define EVP_R_AES_KEY_SETUP_FAILED			 143
1399 #define EVP_R_ASN1_LIB					 140
1400 #define EVP_R_BAD_BLOCK_LENGTH				 136
1401 #define EVP_R_BAD_DECRYPT				 100
1402 #define EVP_R_BAD_KEY_LENGTH				 137
1403 #define EVP_R_BN_DECODE_ERROR				 112
1404 #define EVP_R_BN_PUBKEY_ERROR				 113
1405 #define EVP_R_BUFFER_TOO_SMALL				 155
1406 #define EVP_R_CAMELLIA_KEY_SETUP_FAILED			 157
1407 #define EVP_R_CIPHER_PARAMETER_ERROR			 122
1408 #define EVP_R_COMMAND_NOT_SUPPORTED			 147
1409 #define EVP_R_CTRL_NOT_IMPLEMENTED			 132
1410 #define EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED		 133
1411 #define EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH		 138
1412 #define EVP_R_DECODE_ERROR				 114
1413 #define EVP_R_DIFFERENT_KEY_TYPES			 101
1414 #define EVP_R_DIFFERENT_PARAMETERS			 153
1415 #define EVP_R_DISABLED_FOR_FIPS				 163
1416 #define EVP_R_ENCODE_ERROR				 115
1417 #define EVP_R_ERROR_LOADING_SECTION			 165
1418 #define EVP_R_ERROR_SETTING_FIPS_MODE			 166
1419 #define EVP_R_EVP_PBE_CIPHERINIT_ERROR			 119
1420 #define EVP_R_EXPECTING_AN_RSA_KEY			 127
1421 #define EVP_R_EXPECTING_A_DH_KEY			 128
1422 #define EVP_R_EXPECTING_A_DSA_KEY			 129
1423 #define EVP_R_EXPECTING_A_ECDSA_KEY			 141
1424 #define EVP_R_EXPECTING_A_EC_KEY			 142
1425 #define EVP_R_FIPS_MODE_NOT_SUPPORTED			 167
1426 #define EVP_R_INITIALIZATION_ERROR			 134
1427 #define EVP_R_INPUT_NOT_INITIALIZED			 111
1428 #define EVP_R_INVALID_DIGEST				 152
1429 #define EVP_R_INVALID_FIPS_MODE				 168
1430 #define EVP_R_INVALID_KEY_LENGTH			 130
1431 #define EVP_R_INVALID_OPERATION				 148
1432 #define EVP_R_IV_TOO_LARGE				 102
1433 #define EVP_R_KEYGEN_FAILURE				 120
1434 #define EVP_R_MESSAGE_DIGEST_IS_NULL			 159
1435 #define EVP_R_METHOD_NOT_SUPPORTED			 144
1436 #define EVP_R_MISSING_PARAMETERS			 103
1437 #define EVP_R_NO_CIPHER_SET				 131
1438 #define EVP_R_NO_DEFAULT_DIGEST				 158
1439 #define EVP_R_NO_DIGEST_SET				 139
1440 #define EVP_R_NO_DSA_PARAMETERS				 116
1441 #define EVP_R_NO_KEY_SET				 154
1442 #define EVP_R_NO_OPERATION_SET				 149
1443 #define EVP_R_NO_SIGN_FUNCTION_CONFIGURED		 104
1444 #define EVP_R_NO_VERIFY_FUNCTION_CONFIGURED		 105
1445 #define EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE	 150
1446 #define EVP_R_OPERATON_NOT_INITIALIZED			 151
1447 #define EVP_R_OUTPUT_ALIASES_INPUT			 172
1448 #define EVP_R_PKCS8_UNKNOWN_BROKEN_TYPE			 117
1449 #define EVP_R_PRIVATE_KEY_DECODE_ERROR			 145
1450 #define EVP_R_PRIVATE_KEY_ENCODE_ERROR			 146
1451 #define EVP_R_PUBLIC_KEY_NOT_RSA			 106
1452 #define EVP_R_TAG_TOO_LARGE				 171
1453 #define EVP_R_TOO_LARGE					 164
1454 #define EVP_R_UNKNOWN_CIPHER				 160
1455 #define EVP_R_UNKNOWN_DIGEST				 161
1456 #define EVP_R_UNKNOWN_OPTION				 169
1457 #define EVP_R_UNKNOWN_PBE_ALGORITHM			 121
1458 #define EVP_R_UNSUPORTED_NUMBER_OF_ROUNDS		 135
1459 #define EVP_R_UNSUPPORTED_ALGORITHM			 156
1460 #define EVP_R_UNSUPPORTED_CIPHER			 107
1461 #define EVP_R_UNSUPPORTED_KEYLENGTH			 123
1462 #define EVP_R_UNSUPPORTED_KEY_DERIVATION_FUNCTION	 124
1463 #define EVP_R_UNSUPPORTED_KEY_SIZE			 108
1464 #define EVP_R_UNSUPPORTED_PRF				 125
1465 #define EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM		 118
1466 #define EVP_R_UNSUPPORTED_SALT_TYPE			 126
1467 #define EVP_R_WRONG_FINAL_BLOCK_LENGTH			 109
1468 #define EVP_R_WRONG_PUBLIC_KEY_TYPE			 110
1469 
1470 #ifdef  __cplusplus
1471 }
1472 #endif
1473 #endif
1474