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