Import OpenSSL-0.9.8i.
[dragonfly.git] / crypto / openssl-0.9.7d / crypto / evp / evp.h
blob4801d8eaa3b5b8290003d5578d0025bd045e6455
1 /* crypto/evp/evp.h */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3 * All rights reserved.
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).
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.
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)"
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.
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.]
59 #ifndef HEADER_ENVELOPE_H
60 #define HEADER_ENVELOPE_H
62 #ifdef OPENSSL_ALGORITHM_DEFINES
63 # include <openssl/opensslconf.h>
64 #else
65 # define OPENSSL_ALGORITHM_DEFINES
66 # include <openssl/opensslconf.h>
67 # undef OPENSSL_ALGORITHM_DEFINES
68 #endif
70 #include <openssl/ossl_typ.h>
72 #include <openssl/symhacks.h>
74 #ifndef OPENSSL_NO_BIO
75 #include <openssl/bio.h>
76 #endif
77 #ifndef OPENSSL_NO_MD2
78 #include <openssl/md2.h>
79 #endif
80 #ifndef OPENSSL_NO_MD4
81 #include <openssl/md4.h>
82 #endif
83 #ifndef OPENSSL_NO_MD5
84 #include <openssl/md5.h>
85 #endif
86 #ifndef OPENSSL_NO_SHA
87 #include <openssl/sha.h>
88 #endif
89 #ifndef OPENSSL_NO_RIPEMD
90 #include <openssl/ripemd.h>
91 #endif
92 #ifndef OPENSSL_NO_DES
93 #include <openssl/des.h>
94 #endif
95 #ifndef OPENSSL_NO_RC4
96 #include <openssl/rc4.h>
97 #endif
98 #ifndef OPENSSL_NO_RC2
99 #include <openssl/rc2.h>
100 #endif
101 #ifndef OPENSSL_NO_RC5
102 #include <openssl/rc5.h>
103 #endif
104 #ifndef OPENSSL_NO_BF
105 #include <openssl/blowfish.h>
106 #endif
107 #ifndef OPENSSL_NO_CAST
108 #include <openssl/cast.h>
109 #endif
110 #ifndef OPENSSL_NO_IDEA
111 #include <openssl/idea.h>
112 #endif
113 #ifndef OPENSSL_NO_MDC2
114 #include <openssl/mdc2.h>
115 #endif
116 #ifndef OPENSSL_NO_AES
117 #include <openssl/aes.h>
118 #endif
121 #define EVP_RC2_KEY_SIZE 16
122 #define EVP_RC4_KEY_SIZE 16
123 #define EVP_BLOWFISH_KEY_SIZE 16
124 #define EVP_CAST5_KEY_SIZE 16
125 #define EVP_RC5_32_12_16_KEY_SIZE 16
127 #define EVP_MAX_MD_SIZE (16+20) /* The SSLv3 md5+sha1 type */
128 #define EVP_MAX_KEY_LENGTH 32
129 #define EVP_MAX_IV_LENGTH 16
130 #define EVP_MAX_BLOCK_LENGTH 32
132 #define PKCS5_SALT_LEN 8
133 /* Default PKCS#5 iteration count */
134 #define PKCS5_DEFAULT_ITER 2048
136 #ifndef OPENSSL_NO_RSA
137 #include <openssl/rsa.h>
138 #endif
140 #ifndef OPENSSL_NO_DSA
141 #include <openssl/dsa.h>
142 #endif
144 #ifndef OPENSSL_NO_DH
145 #include <openssl/dh.h>
146 #endif
148 #include <openssl/objects.h>
150 #define EVP_PK_RSA 0x0001
151 #define EVP_PK_DSA 0x0002
152 #define EVP_PK_DH 0x0004
153 #define EVP_PKT_SIGN 0x0010
154 #define EVP_PKT_ENC 0x0020
155 #define EVP_PKT_EXCH 0x0040
156 #define EVP_PKS_RSA 0x0100
157 #define EVP_PKS_DSA 0x0200
158 #define EVP_PKT_EXP 0x1000 /* <= 512 bit key */
160 #define EVP_PKEY_NONE NID_undef
161 #define EVP_PKEY_RSA NID_rsaEncryption
162 #define EVP_PKEY_RSA2 NID_rsa
163 #define EVP_PKEY_DSA NID_dsa
164 #define EVP_PKEY_DSA1 NID_dsa_2
165 #define EVP_PKEY_DSA2 NID_dsaWithSHA
166 #define EVP_PKEY_DSA3 NID_dsaWithSHA1
167 #define EVP_PKEY_DSA4 NID_dsaWithSHA1_2
168 #define EVP_PKEY_DH NID_dhKeyAgreement
170 #ifdef __cplusplus
171 extern "C" {
172 #endif
174 /* Type needs to be a bit field
175 * Sub-type needs to be for variations on the method, as in, can it do
176 * arbitrary encryption.... */
177 struct evp_pkey_st
179 int type;
180 int save_type;
181 int references;
182 union {
183 char *ptr;
184 #ifndef OPENSSL_NO_RSA
185 struct rsa_st *rsa; /* RSA */
186 #endif
187 #ifndef OPENSSL_NO_DSA
188 struct dsa_st *dsa; /* DSA */
189 #endif
190 #ifndef OPENSSL_NO_DH
191 struct dh_st *dh; /* DH */
192 #endif
193 } pkey;
194 int save_parameters;
195 STACK_OF(X509_ATTRIBUTE) *attributes; /* [ 0 ] */
196 } /* EVP_PKEY */;
198 #define EVP_PKEY_MO_SIGN 0x0001
199 #define EVP_PKEY_MO_VERIFY 0x0002
200 #define EVP_PKEY_MO_ENCRYPT 0x0004
201 #define EVP_PKEY_MO_DECRYPT 0x0008
203 #if 0
204 /* This structure is required to tie the message digest and signing together.
205 * The lookup can be done by md/pkey_method, oid, oid/pkey_method, or
206 * oid, md and pkey.
207 * This is required because for various smart-card perform the digest and
208 * signing/verification on-board. To handle this case, the specific
209 * EVP_MD and EVP_PKEY_METHODs need to be closely associated.
210 * When a PKEY is created, it will have a EVP_PKEY_METHOD associated with it.
211 * This can either be software or a token to provide the required low level
212 * routines.
214 typedef struct evp_pkey_md_st
216 int oid;
217 EVP_MD *md;
218 EVP_PKEY_METHOD *pkey;
219 } EVP_PKEY_MD;
221 #define EVP_rsa_md2() \
222 EVP_PKEY_MD_add(NID_md2WithRSAEncryption,\
223 EVP_rsa_pkcs1(),EVP_md2())
224 #define EVP_rsa_md5() \
225 EVP_PKEY_MD_add(NID_md5WithRSAEncryption,\
226 EVP_rsa_pkcs1(),EVP_md5())
227 #define EVP_rsa_sha0() \
228 EVP_PKEY_MD_add(NID_shaWithRSAEncryption,\
229 EVP_rsa_pkcs1(),EVP_sha())
230 #define EVP_rsa_sha1() \
231 EVP_PKEY_MD_add(NID_sha1WithRSAEncryption,\
232 EVP_rsa_pkcs1(),EVP_sha1())
233 #define EVP_rsa_ripemd160() \
234 EVP_PKEY_MD_add(NID_ripemd160WithRSA,\
235 EVP_rsa_pkcs1(),EVP_ripemd160())
236 #define EVP_rsa_mdc2() \
237 EVP_PKEY_MD_add(NID_mdc2WithRSA,\
238 EVP_rsa_octet_string(),EVP_mdc2())
239 #define EVP_dsa_sha() \
240 EVP_PKEY_MD_add(NID_dsaWithSHA,\
241 EVP_dsa(),EVP_sha())
242 #define EVP_dsa_sha1() \
243 EVP_PKEY_MD_add(NID_dsaWithSHA1,\
244 EVP_dsa(),EVP_sha1())
246 typedef struct evp_pkey_method_st
248 char *name;
249 int flags;
250 int type; /* RSA, DSA, an SSLeay specific constant */
251 int oid; /* For the pub-key type */
252 int encrypt_oid; /* pub/priv key encryption */
254 int (*sign)();
255 int (*verify)();
256 struct {
257 int (*set)(); /* get and/or set the underlying type */
258 int (*get)();
259 int (*encrypt)();
260 int (*decrypt)();
261 int (*i2d)();
262 int (*d2i)();
263 int (*dup)();
264 } pub,priv;
265 int (*set_asn1_parameters)();
266 int (*get_asn1_parameters)();
267 } EVP_PKEY_METHOD;
268 #endif
270 #ifndef EVP_MD
271 struct env_md_st
273 int type;
274 int pkey_type;
275 int md_size;
276 unsigned long flags;
277 int (*init)(EVP_MD_CTX *ctx);
278 int (*update)(EVP_MD_CTX *ctx,const void *data,unsigned long count);
279 int (*final)(EVP_MD_CTX *ctx,unsigned char *md);
280 int (*copy)(EVP_MD_CTX *to,const EVP_MD_CTX *from);
281 int (*cleanup)(EVP_MD_CTX *ctx);
283 /* FIXME: prototype these some day */
284 int (*sign)();
285 int (*verify)();
286 int required_pkey_type[5]; /*EVP_PKEY_xxx */
287 int block_size;
288 int ctx_size; /* how big does the ctx->md_data need to be */
289 } /* EVP_MD */;
291 #define EVP_MD_FLAG_ONESHOT 0x0001 /* digest can only handle a single
292 * block */
294 #define EVP_PKEY_NULL_method NULL,NULL,{0,0,0,0}
296 #ifndef OPENSSL_NO_DSA
297 #define EVP_PKEY_DSA_method DSA_sign,DSA_verify, \
298 {EVP_PKEY_DSA,EVP_PKEY_DSA2,EVP_PKEY_DSA3, \
299 EVP_PKEY_DSA4,0}
300 #else
301 #define EVP_PKEY_DSA_method EVP_PKEY_NULL_method
302 #endif
304 #ifndef OPENSSL_NO_RSA
305 #define EVP_PKEY_RSA_method RSA_sign,RSA_verify, \
306 {EVP_PKEY_RSA,EVP_PKEY_RSA2,0,0}
307 #define EVP_PKEY_RSA_ASN1_OCTET_STRING_method \
308 RSA_sign_ASN1_OCTET_STRING, \
309 RSA_verify_ASN1_OCTET_STRING, \
310 {EVP_PKEY_RSA,EVP_PKEY_RSA2,0,0}
311 #else
312 #define EVP_PKEY_RSA_method EVP_PKEY_NULL_method
313 #define EVP_PKEY_RSA_ASN1_OCTET_STRING_method EVP_PKEY_NULL_method
314 #endif
316 #endif /* !EVP_MD */
318 struct env_md_ctx_st
320 const EVP_MD *digest;
321 ENGINE *engine; /* functional reference if 'digest' is ENGINE-provided */
322 unsigned long flags;
323 void *md_data;
324 } /* EVP_MD_CTX */;
326 /* values for EVP_MD_CTX flags */
328 #define EVP_MD_CTX_FLAG_ONESHOT 0x0001 /* digest update will be called
329 * once only */
330 #define EVP_MD_CTX_FLAG_CLEANED 0x0002 /* context has already been
331 * cleaned */
332 #define EVP_MD_CTX_FLAG_REUSE 0x0004 /* Don't free up ctx->md_data
333 * in EVP_MD_CTX_cleanup */
335 struct evp_cipher_st
337 int nid;
338 int block_size;
339 int key_len; /* Default value for variable length ciphers */
340 int iv_len;
341 unsigned long flags; /* Various flags */
342 int (*init)(EVP_CIPHER_CTX *ctx, const unsigned char *key,
343 const unsigned char *iv, int enc); /* init key */
344 int (*do_cipher)(EVP_CIPHER_CTX *ctx, unsigned char *out,
345 const unsigned char *in, unsigned int inl);/* encrypt/decrypt data */
346 int (*cleanup)(EVP_CIPHER_CTX *); /* cleanup ctx */
347 int ctx_size; /* how big ctx->cipher_data needs to be */
348 int (*set_asn1_parameters)(EVP_CIPHER_CTX *, ASN1_TYPE *); /* Populate a ASN1_TYPE with parameters */
349 int (*get_asn1_parameters)(EVP_CIPHER_CTX *, ASN1_TYPE *); /* Get parameters from a ASN1_TYPE */
350 int (*ctrl)(EVP_CIPHER_CTX *, int type, int arg, void *ptr); /* Miscellaneous operations */
351 void *app_data; /* Application data */
352 } /* EVP_CIPHER */;
354 /* Values for cipher flags */
356 /* Modes for ciphers */
358 #define EVP_CIPH_STREAM_CIPHER 0x0
359 #define EVP_CIPH_ECB_MODE 0x1
360 #define EVP_CIPH_CBC_MODE 0x2
361 #define EVP_CIPH_CFB_MODE 0x3
362 #define EVP_CIPH_OFB_MODE 0x4
363 #define EVP_CIPH_MODE 0x7
364 /* Set if variable length cipher */
365 #define EVP_CIPH_VARIABLE_LENGTH 0x8
366 /* Set if the iv handling should be done by the cipher itself */
367 #define EVP_CIPH_CUSTOM_IV 0x10
368 /* Set if the cipher's init() function should be called if key is NULL */
369 #define EVP_CIPH_ALWAYS_CALL_INIT 0x20
370 /* Call ctrl() to init cipher parameters */
371 #define EVP_CIPH_CTRL_INIT 0x40
372 /* Don't use standard key length function */
373 #define EVP_CIPH_CUSTOM_KEY_LENGTH 0x80
374 /* Don't use standard block padding */
375 #define EVP_CIPH_NO_PADDING 0x100
377 /* ctrl() values */
379 #define EVP_CTRL_INIT 0x0
380 #define EVP_CTRL_SET_KEY_LENGTH 0x1
381 #define EVP_CTRL_GET_RC2_KEY_BITS 0x2
382 #define EVP_CTRL_SET_RC2_KEY_BITS 0x3
383 #define EVP_CTRL_GET_RC5_ROUNDS 0x4
384 #define EVP_CTRL_SET_RC5_ROUNDS 0x5
386 typedef struct evp_cipher_info_st
388 const EVP_CIPHER *cipher;
389 unsigned char iv[EVP_MAX_IV_LENGTH];
390 } EVP_CIPHER_INFO;
392 struct evp_cipher_ctx_st
394 const EVP_CIPHER *cipher;
395 ENGINE *engine; /* functional reference if 'cipher' is ENGINE-provided */
396 int encrypt; /* encrypt or decrypt */
397 int buf_len; /* number we have left */
399 unsigned char oiv[EVP_MAX_IV_LENGTH]; /* original iv */
400 unsigned char iv[EVP_MAX_IV_LENGTH]; /* working iv */
401 unsigned char buf[EVP_MAX_BLOCK_LENGTH];/* saved partial block */
402 int num; /* used by cfb/ofb mode */
404 void *app_data; /* application stuff */
405 int key_len; /* May change for variable length cipher */
406 unsigned long flags; /* Various flags */
407 void *cipher_data; /* per EVP data */
408 int final_used;
409 int block_mask;
410 unsigned char final[EVP_MAX_BLOCK_LENGTH];/* possible final block */
411 } /* EVP_CIPHER_CTX */;
413 typedef struct evp_Encode_Ctx_st
415 int num; /* number saved in a partial encode/decode */
416 int length; /* The length is either the output line length
417 * (in input bytes) or the shortest input line
418 * length that is ok. Once decoding begins,
419 * the length is adjusted up each time a longer
420 * line is decoded */
421 unsigned char enc_data[80]; /* data to encode */
422 int line_num; /* number read on current line */
423 int expect_nl;
424 } EVP_ENCODE_CTX;
426 /* Password based encryption function */
427 typedef int (EVP_PBE_KEYGEN)(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
428 ASN1_TYPE *param, const EVP_CIPHER *cipher,
429 const EVP_MD *md, int en_de);
431 #ifndef OPENSSL_NO_RSA
432 #define EVP_PKEY_assign_RSA(pkey,rsa) EVP_PKEY_assign((pkey),EVP_PKEY_RSA,\
433 (char *)(rsa))
434 #endif
436 #ifndef OPENSSL_NO_DSA
437 #define EVP_PKEY_assign_DSA(pkey,dsa) EVP_PKEY_assign((pkey),EVP_PKEY_DSA,\
438 (char *)(dsa))
439 #endif
441 #ifndef OPENSSL_NO_DH
442 #define EVP_PKEY_assign_DH(pkey,dh) EVP_PKEY_assign((pkey),EVP_PKEY_DH,\
443 (char *)(dh))
444 #endif
446 /* Add some extra combinations */
447 #define EVP_get_digestbynid(a) EVP_get_digestbyname(OBJ_nid2sn(a))
448 #define EVP_get_digestbyobj(a) EVP_get_digestbynid(OBJ_obj2nid(a))
449 #define EVP_get_cipherbynid(a) EVP_get_cipherbyname(OBJ_nid2sn(a))
450 #define EVP_get_cipherbyobj(a) EVP_get_cipherbynid(OBJ_obj2nid(a))
452 #define EVP_MD_type(e) ((e)->type)
453 #define EVP_MD_nid(e) EVP_MD_type(e)
454 #define EVP_MD_name(e) OBJ_nid2sn(EVP_MD_nid(e))
455 #define EVP_MD_pkey_type(e) ((e)->pkey_type)
456 #define EVP_MD_size(e) ((e)->md_size)
457 #define EVP_MD_block_size(e) ((e)->block_size)
459 #define EVP_MD_CTX_md(e) ((e)->digest)
460 #define EVP_MD_CTX_size(e) EVP_MD_size((e)->digest)
461 #define EVP_MD_CTX_block_size(e) EVP_MD_block_size((e)->digest)
462 #define EVP_MD_CTX_type(e) EVP_MD_type((e)->digest)
464 #define EVP_CIPHER_nid(e) ((e)->nid)
465 #define EVP_CIPHER_name(e) OBJ_nid2sn(EVP_CIPHER_nid(e))
466 #define EVP_CIPHER_block_size(e) ((e)->block_size)
467 #define EVP_CIPHER_key_length(e) ((e)->key_len)
468 #define EVP_CIPHER_iv_length(e) ((e)->iv_len)
469 #define EVP_CIPHER_flags(e) ((e)->flags)
470 #define EVP_CIPHER_mode(e) (((e)->flags) & EVP_CIPH_MODE)
472 #define EVP_CIPHER_CTX_cipher(e) ((e)->cipher)
473 #define EVP_CIPHER_CTX_nid(e) ((e)->cipher->nid)
474 #define EVP_CIPHER_CTX_block_size(e) ((e)->cipher->block_size)
475 #define EVP_CIPHER_CTX_key_length(e) ((e)->key_len)
476 #define EVP_CIPHER_CTX_iv_length(e) ((e)->cipher->iv_len)
477 #define EVP_CIPHER_CTX_get_app_data(e) ((e)->app_data)
478 #define EVP_CIPHER_CTX_set_app_data(e,d) ((e)->app_data=(char *)(d))
479 #define EVP_CIPHER_CTX_type(c) EVP_CIPHER_type(EVP_CIPHER_CTX_cipher(c))
480 #define EVP_CIPHER_CTX_flags(e) ((e)->cipher->flags)
481 #define EVP_CIPHER_CTX_mode(e) ((e)->cipher->flags & EVP_CIPH_MODE)
483 #define EVP_ENCODE_LENGTH(l) (((l+2)/3*4)+(l/48+1)*2+80)
484 #define EVP_DECODE_LENGTH(l) ((l+3)/4*3+80)
486 #define EVP_SignInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c)
487 #define EVP_SignInit(a,b) EVP_DigestInit(a,b)
488 #define EVP_SignUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
489 #define EVP_VerifyInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c)
490 #define EVP_VerifyInit(a,b) EVP_DigestInit(a,b)
491 #define EVP_VerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
492 #define EVP_OpenUpdate(a,b,c,d,e) EVP_DecryptUpdate(a,b,c,d,e)
493 #define EVP_SealUpdate(a,b,c,d,e) EVP_EncryptUpdate(a,b,c,d,e)
495 #ifdef CONST_STRICT
496 void BIO_set_md(BIO *,const EVP_MD *md);
497 #else
498 # define BIO_set_md(b,md) BIO_ctrl(b,BIO_C_SET_MD,0,(char *)md)
499 #endif
500 #define BIO_get_md(b,mdp) BIO_ctrl(b,BIO_C_GET_MD,0,(char *)mdp)
501 #define BIO_get_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_GET_MD_CTX,0,(char *)mdcp)
502 #define BIO_get_cipher_status(b) BIO_ctrl(b,BIO_C_GET_CIPHER_STATUS,0,NULL)
503 #define BIO_get_cipher_ctx(b,c_pp) BIO_ctrl(b,BIO_C_GET_CIPHER_CTX,0,(char *)c_pp)
505 #define EVP_Cipher(c,o,i,l) (c)->cipher->do_cipher((c),(o),(i),(l))
507 #define EVP_add_cipher_alias(n,alias) \
508 OBJ_NAME_add((alias),OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS,(n))
509 #define EVP_add_digest_alias(n,alias) \
510 OBJ_NAME_add((alias),OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS,(n))
511 #define EVP_delete_cipher_alias(alias) \
512 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS);
513 #define EVP_delete_digest_alias(alias) \
514 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS);
516 void EVP_MD_CTX_init(EVP_MD_CTX *ctx);
517 int EVP_MD_CTX_cleanup(EVP_MD_CTX *ctx);
518 EVP_MD_CTX *EVP_MD_CTX_create(void);
519 void EVP_MD_CTX_destroy(EVP_MD_CTX *ctx);
520 int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out,const EVP_MD_CTX *in);
521 #define EVP_MD_CTX_set_flags(ctx,flgs) ((ctx)->flags|=(flgs))
522 #define EVP_MD_CTX_clear_flags(ctx,flgs) ((ctx)->flags&=~(flgs))
523 #define EVP_MD_CTX_test_flags(ctx,flgs) ((ctx)->flags&(flgs))
524 int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type, ENGINE *impl);
525 int EVP_DigestUpdate(EVP_MD_CTX *ctx,const void *d,
526 unsigned int cnt);
527 int EVP_DigestFinal_ex(EVP_MD_CTX *ctx,unsigned char *md,unsigned int *s);
528 int EVP_Digest(void *data, unsigned int count,
529 unsigned char *md, unsigned int *size, const EVP_MD *type, ENGINE *impl);
531 int EVP_MD_CTX_copy(EVP_MD_CTX *out,const EVP_MD_CTX *in);
532 int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type);
533 int EVP_DigestFinal(EVP_MD_CTX *ctx,unsigned char *md,unsigned int *s);
535 int EVP_read_pw_string(char *buf,int length,const char *prompt,int verify);
536 void EVP_set_pw_prompt(char *prompt);
537 char * EVP_get_pw_prompt(void);
539 int EVP_BytesToKey(const EVP_CIPHER *type,const EVP_MD *md,
540 const unsigned char *salt, const unsigned char *data,
541 int datal, int count, unsigned char *key,unsigned char *iv);
543 int EVP_EncryptInit(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher,
544 const unsigned char *key, const unsigned char *iv);
545 int EVP_EncryptInit_ex(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher, ENGINE *impl,
546 const unsigned char *key, const unsigned char *iv);
547 int EVP_EncryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
548 int *outl, const unsigned char *in, int inl);
549 int EVP_EncryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
550 int EVP_EncryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
552 int EVP_DecryptInit(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher,
553 const unsigned char *key, const unsigned char *iv);
554 int EVP_DecryptInit_ex(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher, ENGINE *impl,
555 const unsigned char *key, const unsigned char *iv);
556 int EVP_DecryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
557 int *outl, const unsigned char *in, int inl);
558 int EVP_DecryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
559 int EVP_DecryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
561 int EVP_CipherInit(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher,
562 const unsigned char *key,const unsigned char *iv,
563 int enc);
564 int EVP_CipherInit_ex(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *cipher, ENGINE *impl,
565 const unsigned char *key,const unsigned char *iv,
566 int enc);
567 int EVP_CipherUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
568 int *outl, const unsigned char *in, int inl);
569 int EVP_CipherFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
570 int EVP_CipherFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm, int *outl);
572 int EVP_SignFinal(EVP_MD_CTX *ctx,unsigned char *md,unsigned int *s,
573 EVP_PKEY *pkey);
575 int EVP_VerifyFinal(EVP_MD_CTX *ctx,unsigned char *sigbuf,
576 unsigned int siglen,EVP_PKEY *pkey);
578 int EVP_OpenInit(EVP_CIPHER_CTX *ctx,const EVP_CIPHER *type,unsigned char *ek,
579 int ekl,unsigned char *iv,EVP_PKEY *priv);
580 int EVP_OpenFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
582 int EVP_SealInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type, unsigned char **ek,
583 int *ekl, unsigned char *iv,EVP_PKEY **pubk, int npubk);
584 int EVP_SealFinal(EVP_CIPHER_CTX *ctx,unsigned char *out,int *outl);
586 void EVP_EncodeInit(EVP_ENCODE_CTX *ctx);
587 void EVP_EncodeUpdate(EVP_ENCODE_CTX *ctx,unsigned char *out,
588 int *outl,unsigned char *in,int inl);
589 void EVP_EncodeFinal(EVP_ENCODE_CTX *ctx,unsigned char *out,int *outl);
590 int EVP_EncodeBlock(unsigned char *t, const unsigned char *f, int n);
592 void EVP_DecodeInit(EVP_ENCODE_CTX *ctx);
593 int EVP_DecodeUpdate(EVP_ENCODE_CTX *ctx,unsigned char *out,int *outl,
594 unsigned char *in, int inl);
595 int EVP_DecodeFinal(EVP_ENCODE_CTX *ctx, unsigned
596 char *out, int *outl);
597 int EVP_DecodeBlock(unsigned char *t, const unsigned char *f, int n);
599 void EVP_CIPHER_CTX_init(EVP_CIPHER_CTX *a);
600 int EVP_CIPHER_CTX_cleanup(EVP_CIPHER_CTX *a);
601 int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *x, int keylen);
602 int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *c, int pad);
603 int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *ctx, int type, int arg, void *ptr);
605 #ifndef OPENSSL_NO_BIO
606 BIO_METHOD *BIO_f_md(void);
607 BIO_METHOD *BIO_f_base64(void);
608 BIO_METHOD *BIO_f_cipher(void);
609 BIO_METHOD *BIO_f_reliable(void);
610 void BIO_set_cipher(BIO *b,const EVP_CIPHER *c,unsigned char *k,
611 unsigned char *i, int enc);
612 #endif
614 const EVP_MD *EVP_md_null(void);
615 #ifndef OPENSSL_NO_MD2
616 const EVP_MD *EVP_md2(void);
617 #endif
618 #ifndef OPENSSL_NO_MD4
619 const EVP_MD *EVP_md4(void);
620 #endif
621 #ifndef OPENSSL_NO_MD5
622 const EVP_MD *EVP_md5(void);
623 #endif
624 #ifndef OPENSSL_NO_SHA
625 const EVP_MD *EVP_sha(void);
626 const EVP_MD *EVP_sha1(void);
627 const EVP_MD *EVP_dss(void);
628 const EVP_MD *EVP_dss1(void);
629 #endif
630 #ifndef OPENSSL_NO_MDC2
631 const EVP_MD *EVP_mdc2(void);
632 #endif
633 #ifndef OPENSSL_NO_RIPEMD
634 const EVP_MD *EVP_ripemd160(void);
635 #endif
636 const EVP_CIPHER *EVP_enc_null(void); /* does nothing :-) */
637 #ifndef OPENSSL_NO_DES
638 const EVP_CIPHER *EVP_des_ecb(void);
639 const EVP_CIPHER *EVP_des_ede(void);
640 const EVP_CIPHER *EVP_des_ede3(void);
641 const EVP_CIPHER *EVP_des_ede_ecb(void);
642 const EVP_CIPHER *EVP_des_ede3_ecb(void);
643 const EVP_CIPHER *EVP_des_cfb(void);
644 const EVP_CIPHER *EVP_des_ede_cfb(void);
645 const EVP_CIPHER *EVP_des_ede3_cfb(void);
646 const EVP_CIPHER *EVP_des_ofb(void);
647 const EVP_CIPHER *EVP_des_ede_ofb(void);
648 const EVP_CIPHER *EVP_des_ede3_ofb(void);
649 const EVP_CIPHER *EVP_des_cbc(void);
650 const EVP_CIPHER *EVP_des_ede_cbc(void);
651 const EVP_CIPHER *EVP_des_ede3_cbc(void);
652 const EVP_CIPHER *EVP_desx_cbc(void);
653 /* This should now be supported through the dev_crypto ENGINE. But also, why are
654 * rc4 and md5 declarations made here inside a "NO_DES" precompiler branch? */
655 #if 0
656 # ifdef OPENSSL_OPENBSD_DEV_CRYPTO
657 const EVP_CIPHER *EVP_dev_crypto_des_ede3_cbc(void);
658 const EVP_CIPHER *EVP_dev_crypto_rc4(void);
659 const EVP_MD *EVP_dev_crypto_md5(void);
660 # endif
661 #endif
662 #endif
663 #ifndef OPENSSL_NO_RC4
664 const EVP_CIPHER *EVP_rc4(void);
665 const EVP_CIPHER *EVP_rc4_40(void);
666 #endif
667 #ifndef OPENSSL_NO_IDEA
668 const EVP_CIPHER *EVP_idea_ecb(void);
669 const EVP_CIPHER *EVP_idea_cfb(void);
670 const EVP_CIPHER *EVP_idea_ofb(void);
671 const EVP_CIPHER *EVP_idea_cbc(void);
672 #endif
673 #ifndef OPENSSL_NO_RC2
674 const EVP_CIPHER *EVP_rc2_ecb(void);
675 const EVP_CIPHER *EVP_rc2_cbc(void);
676 const EVP_CIPHER *EVP_rc2_40_cbc(void);
677 const EVP_CIPHER *EVP_rc2_64_cbc(void);
678 const EVP_CIPHER *EVP_rc2_cfb(void);
679 const EVP_CIPHER *EVP_rc2_ofb(void);
680 #endif
681 #ifndef OPENSSL_NO_BF
682 const EVP_CIPHER *EVP_bf_ecb(void);
683 const EVP_CIPHER *EVP_bf_cbc(void);
684 const EVP_CIPHER *EVP_bf_cfb(void);
685 const EVP_CIPHER *EVP_bf_ofb(void);
686 #endif
687 #ifndef OPENSSL_NO_CAST
688 const EVP_CIPHER *EVP_cast5_ecb(void);
689 const EVP_CIPHER *EVP_cast5_cbc(void);
690 const EVP_CIPHER *EVP_cast5_cfb(void);
691 const EVP_CIPHER *EVP_cast5_ofb(void);
692 #endif
693 #ifndef OPENSSL_NO_RC5
694 const EVP_CIPHER *EVP_rc5_32_12_16_cbc(void);
695 const EVP_CIPHER *EVP_rc5_32_12_16_ecb(void);
696 const EVP_CIPHER *EVP_rc5_32_12_16_cfb(void);
697 const EVP_CIPHER *EVP_rc5_32_12_16_ofb(void);
698 #endif
699 #ifndef OPENSSL_NO_AES
700 const EVP_CIPHER *EVP_aes_128_ecb(void);
701 const EVP_CIPHER *EVP_aes_128_cbc(void);
702 const EVP_CIPHER *EVP_aes_128_cfb(void);
703 const EVP_CIPHER *EVP_aes_128_ofb(void);
704 #if 0
705 const EVP_CIPHER *EVP_aes_128_ctr(void);
706 #endif
707 const EVP_CIPHER *EVP_aes_192_ecb(void);
708 const EVP_CIPHER *EVP_aes_192_cbc(void);
709 const EVP_CIPHER *EVP_aes_192_cfb(void);
710 const EVP_CIPHER *EVP_aes_192_ofb(void);
711 #if 0
712 const EVP_CIPHER *EVP_aes_192_ctr(void);
713 #endif
714 const EVP_CIPHER *EVP_aes_256_ecb(void);
715 const EVP_CIPHER *EVP_aes_256_cbc(void);
716 const EVP_CIPHER *EVP_aes_256_cfb(void);
717 const EVP_CIPHER *EVP_aes_256_ofb(void);
718 #if 0
719 const EVP_CIPHER *EVP_aes_256_ctr(void);
720 #endif
721 #endif
723 void OPENSSL_add_all_algorithms_noconf(void);
724 void OPENSSL_add_all_algorithms_conf(void);
726 #ifdef OPENSSL_LOAD_CONF
727 #define OpenSSL_add_all_algorithms() \
728 OPENSSL_add_all_algorithms_conf()
729 #else
730 #define OpenSSL_add_all_algorithms() \
731 OPENSSL_add_all_algorithms_noconf()
732 #endif
734 void OpenSSL_add_all_ciphers(void);
735 void OpenSSL_add_all_digests(void);
736 #define SSLeay_add_all_algorithms() OpenSSL_add_all_algorithms()
737 #define SSLeay_add_all_ciphers() OpenSSL_add_all_ciphers()
738 #define SSLeay_add_all_digests() OpenSSL_add_all_digests()
740 int EVP_add_cipher(const EVP_CIPHER *cipher);
741 int EVP_add_digest(const EVP_MD *digest);
743 const EVP_CIPHER *EVP_get_cipherbyname(const char *name);
744 const EVP_MD *EVP_get_digestbyname(const char *name);
745 void EVP_cleanup(void);
747 int EVP_PKEY_decrypt(unsigned char *dec_key,unsigned char *enc_key,
748 int enc_key_len,EVP_PKEY *private_key);
749 int EVP_PKEY_encrypt(unsigned char *enc_key,
750 unsigned char *key,int key_len,EVP_PKEY *pub_key);
751 int EVP_PKEY_type(int type);
752 int EVP_PKEY_bits(EVP_PKEY *pkey);
753 int EVP_PKEY_size(EVP_PKEY *pkey);
754 int EVP_PKEY_assign(EVP_PKEY *pkey,int type,char *key);
756 #ifndef OPENSSL_NO_RSA
757 struct rsa_st;
758 int EVP_PKEY_set1_RSA(EVP_PKEY *pkey,struct rsa_st *key);
759 struct rsa_st *EVP_PKEY_get1_RSA(EVP_PKEY *pkey);
760 #endif
761 #ifndef OPENSSL_NO_DSA
762 struct dsa_st;
763 int EVP_PKEY_set1_DSA(EVP_PKEY *pkey,struct dsa_st *key);
764 struct dsa_st *EVP_PKEY_get1_DSA(EVP_PKEY *pkey);
765 #endif
766 #ifndef OPENSSL_NO_DH
767 struct dh_st;
768 int EVP_PKEY_set1_DH(EVP_PKEY *pkey,struct dh_st *key);
769 struct dh_st *EVP_PKEY_get1_DH(EVP_PKEY *pkey);
770 #endif
773 EVP_PKEY * EVP_PKEY_new(void);
774 void EVP_PKEY_free(EVP_PKEY *pkey);
775 EVP_PKEY * d2i_PublicKey(int type,EVP_PKEY **a, unsigned char **pp,
776 long length);
777 int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp);
779 EVP_PKEY * d2i_PrivateKey(int type,EVP_PKEY **a, unsigned char **pp,
780 long length);
781 EVP_PKEY * d2i_AutoPrivateKey(EVP_PKEY **a, unsigned char **pp,
782 long length);
783 int i2d_PrivateKey(EVP_PKEY *a, unsigned char **pp);
785 int EVP_PKEY_copy_parameters(EVP_PKEY *to,EVP_PKEY *from);
786 int EVP_PKEY_missing_parameters(EVP_PKEY *pkey);
787 int EVP_PKEY_save_parameters(EVP_PKEY *pkey,int mode);
788 int EVP_PKEY_cmp_parameters(EVP_PKEY *a,EVP_PKEY *b);
790 int EVP_CIPHER_type(const EVP_CIPHER *ctx);
792 /* calls methods */
793 int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
794 int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
796 /* These are used by EVP_CIPHER methods */
797 int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX *c,ASN1_TYPE *type);
798 int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX *c,ASN1_TYPE *type);
800 /* PKCS5 password based encryption */
801 int PKCS5_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
802 ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md,
803 int en_de);
804 int PKCS5_PBKDF2_HMAC_SHA1(const char *pass, int passlen,
805 unsigned char *salt, int saltlen, int iter,
806 int keylen, unsigned char *out);
807 int PKCS5_v2_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
808 ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md,
809 int en_de);
811 void PKCS5_PBE_add(void);
813 int EVP_PBE_CipherInit (ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
814 ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de);
815 int EVP_PBE_alg_add(int nid, const EVP_CIPHER *cipher, const EVP_MD *md,
816 EVP_PBE_KEYGEN *keygen);
817 void EVP_PBE_cleanup(void);
819 /* BEGIN ERROR CODES */
820 /* The following lines are auto generated by the script mkerr.pl. Any changes
821 * made after this point may be overwritten when the script is next run.
823 void ERR_load_EVP_strings(void);
825 /* Error codes for the EVP functions. */
827 /* Function codes. */
828 #define EVP_F_D2I_PKEY 100
829 #define EVP_F_EVP_CIPHERINIT 123
830 #define EVP_F_EVP_CIPHER_CTX_CTRL 124
831 #define EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH 122
832 #define EVP_F_EVP_DECRYPTFINAL 101
833 #define EVP_F_EVP_DIGESTINIT 128
834 #define EVP_F_EVP_ENCRYPTFINAL 127
835 #define EVP_F_EVP_MD_CTX_COPY 110
836 #define EVP_F_EVP_OPENINIT 102
837 #define EVP_F_EVP_PBE_ALG_ADD 115
838 #define EVP_F_EVP_PBE_CIPHERINIT 116
839 #define EVP_F_EVP_PKCS82PKEY 111
840 #define EVP_F_EVP_PKCS8_SET_BROKEN 112
841 #define EVP_F_EVP_PKEY2PKCS8 113
842 #define EVP_F_EVP_PKEY_COPY_PARAMETERS 103
843 #define EVP_F_EVP_PKEY_DECRYPT 104
844 #define EVP_F_EVP_PKEY_ENCRYPT 105
845 #define EVP_F_EVP_PKEY_GET1_DH 119
846 #define EVP_F_EVP_PKEY_GET1_DSA 120
847 #define EVP_F_EVP_PKEY_GET1_RSA 121
848 #define EVP_F_EVP_PKEY_NEW 106
849 #define EVP_F_EVP_RIJNDAEL 126
850 #define EVP_F_EVP_SIGNFINAL 107
851 #define EVP_F_EVP_VERIFYFINAL 108
852 #define EVP_F_PKCS5_PBE_KEYIVGEN 117
853 #define EVP_F_PKCS5_V2_PBE_KEYIVGEN 118
854 #define EVP_F_RC2_MAGIC_TO_METH 109
855 #define EVP_F_RC5_CTRL 125
857 /* Reason codes. */
858 #define EVP_R_BAD_BLOCK_LENGTH 136
859 #define EVP_R_BAD_DECRYPT 100
860 #define EVP_R_BAD_KEY_LENGTH 137
861 #define EVP_R_BN_DECODE_ERROR 112
862 #define EVP_R_BN_PUBKEY_ERROR 113
863 #define EVP_R_CIPHER_PARAMETER_ERROR 122
864 #define EVP_R_CTRL_NOT_IMPLEMENTED 132
865 #define EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED 133
866 #define EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH 138
867 #define EVP_R_DECODE_ERROR 114
868 #define EVP_R_DIFFERENT_KEY_TYPES 101
869 #define EVP_R_ENCODE_ERROR 115
870 #define EVP_R_EVP_PBE_CIPHERINIT_ERROR 119
871 #define EVP_R_EXPECTING_AN_RSA_KEY 127
872 #define EVP_R_EXPECTING_A_DH_KEY 128
873 #define EVP_R_EXPECTING_A_DSA_KEY 129
874 #define EVP_R_INITIALIZATION_ERROR 134
875 #define EVP_R_INPUT_NOT_INITIALIZED 111
876 #define EVP_R_INVALID_KEY_LENGTH 130
877 #define EVP_R_IV_TOO_LARGE 102
878 #define EVP_R_KEYGEN_FAILURE 120
879 #define EVP_R_MISSING_PARAMETERS 103
880 #define EVP_R_NO_CIPHER_SET 131
881 #define EVP_R_NO_DIGEST_SET 139
882 #define EVP_R_NO_DSA_PARAMETERS 116
883 #define EVP_R_NO_SIGN_FUNCTION_CONFIGURED 104
884 #define EVP_R_NO_VERIFY_FUNCTION_CONFIGURED 105
885 #define EVP_R_PKCS8_UNKNOWN_BROKEN_TYPE 117
886 #define EVP_R_PUBLIC_KEY_NOT_RSA 106
887 #define EVP_R_UNKNOWN_PBE_ALGORITHM 121
888 #define EVP_R_UNSUPORTED_NUMBER_OF_ROUNDS 135
889 #define EVP_R_UNSUPPORTED_CIPHER 107
890 #define EVP_R_UNSUPPORTED_KEYLENGTH 123
891 #define EVP_R_UNSUPPORTED_KEY_DERIVATION_FUNCTION 124
892 #define EVP_R_UNSUPPORTED_KEY_SIZE 108
893 #define EVP_R_UNSUPPORTED_PRF 125
894 #define EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM 118
895 #define EVP_R_UNSUPPORTED_SALT_TYPE 126
896 #define EVP_R_WRONG_FINAL_BLOCK_LENGTH 109
897 #define EVP_R_WRONG_PUBLIC_KEY_TYPE 110
899 #ifdef __cplusplus
901 #endif
902 #endif