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