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