]>
git.ipfire.org Git - thirdparty/openssl.git/blob - crypto/evp/evp.h
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
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.
9 * This library is free for commercial and non-commercial use as long as
10 * the following conditions are aheared to. The following conditions
11 * apply to all code found in this distribution, be it the RC4, RSA,
12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
13 * included with this distribution is covered by the same copyright terms
14 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
16 * Copyright remains Eric Young's, and as such any Copyright notices in
17 * the code are not to be removed.
18 * If this package is used in a product, Eric Young should be given attribution
19 * as the author of the parts of the library used.
20 * This can be in the form of a textual message at program startup or
21 * in documentation (online or textual) provided with the package.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
26 * 1. Redistributions of source code must retain the copyright
27 * notice, this list of conditions and the following disclaimer.
28 * 2. Redistributions in binary form must reproduce the above copyright
29 * notice, this list of conditions and the following disclaimer in the
30 * documentation and/or other materials provided with the distribution.
31 * 3. All advertising materials mentioning features or use of this software
32 * must display the following acknowledgement:
33 * "This product includes cryptographic software written by
34 * Eric Young (eay@cryptsoft.com)"
35 * The word 'cryptographic' can be left out if the rouines from the library
36 * being used are not cryptographic related :-).
37 * 4. If you include any Windows specific code (or a derivative thereof) from
38 * the apps directory (application code) you must include an acknowledgement:
39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * The licence and distribution terms for any publically available version or
54 * derivative of this code cannot be changed. i.e. this code cannot simply be
55 * copied and put under another distribution licence
56 * [including the GNU Public Licence.]
59 #ifndef HEADER_ENVELOPE_H
60 #define HEADER_ENVELOPE_H
62 #ifdef OPENSSL_ALGORITHM_DEFINES
63 # include <openssl/opensslconf.h>
65 # define OPENSSL_ALGORITHM_DEFINES
66 # include <openssl/opensslconf.h>
67 # undef OPENSSL_ALGORITHM_DEFINES
70 #include <openssl/types.h>
72 #ifndef OPENSSL_NO_BIO
73 #include <openssl/bio.h>
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
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
88 #define PKCS5_SALT_LEN 8
89 /* Default PKCS#5 iteration count */
90 #define PKCS5_DEFAULT_ITER 2048
92 #include <openssl/objects.h>
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 */
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
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.... */
128 #ifndef OPENSSL_NO_RSA
129 struct rsa_st
*rsa
; /* RSA */
131 #ifndef OPENSSL_NO_DSA
132 struct dsa_st
*dsa
; /* DSA */
134 #ifndef OPENSSL_NO_DH
135 struct dh_st
*dh
; /* DH */
139 STACK_OF(X509_ATTRIBUTE
) *attributes
; /* [ 0 ] */
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
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
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
158 typedef struct evp_pkey_md_st
162 EVP_PKEY_METHOD
*pkey
;
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())
190 typedef struct evp_pkey_method_st
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 */
201 int (*set
)(); /* get and/or set the underlying type */
209 int (*set_asn1_parameters
)();
210 int (*get_asn1_parameters
)();
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
);
227 /* FIXME: prototype these some day */
230 int required_pkey_type
[5]; /*EVP_PKEY_xxx */
232 int ctx_size
; /* how big does the ctx->md_data need to be */
235 #define EVP_MD_FLAG_ONESHOT 0x0001 /* digest can only handle a single
238 #define EVP_PKEY_NULL_method NULL,NULL,{0,0,0,0}
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, \
245 #define EVP_PKEY_DSA_method EVP_PKEY_NULL_method
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}
256 #define EVP_PKEY_RSA_method EVP_PKEY_NULL_method
257 #define EVP_PKEY_RSA_ASN1_OCTET_STRING_method EVP_PKEY_NULL_method
264 const EVP_MD
*digest
;
265 ENGINE
*engine
; /* functional reference if 'digest' is ENGINE-provided */
270 /* values for EVP_MD_CTX flags */
272 #define EVP_MD_CTX_FLAG_ONESHOT 0x0001 /* digest update will be called
274 #define EVP_MD_CTX_FLAG_CLEANED 0x0002 /* context has already been
281 int key_len
; /* Default value for variable length ciphers */
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 */
296 /* Values for cipher flags */
298 /* Modes for ciphers */
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
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
328 typedef struct evp_cipher_info_st
330 const EVP_CIPHER
*cipher
;
331 unsigned char iv
[EVP_MAX_IV_LENGTH
];
334 struct evp_cipher_ctx_st
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 */
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 */
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 */
352 unsigned char final
[EVP_MAX_BLOCK_LENGTH
];/* possible final block */
353 } /* EVP_CIPHER_CTX */;
355 typedef struct evp_Encode_Ctx_st
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
363 unsigned char enc_data
[80]; /* data to encode */
364 int line_num
; /* number read on current line */
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
);
373 #ifndef OPENSSL_NO_RSA
374 #define EVP_PKEY_assign_RSA(pkey,rsa) EVP_PKEY_assign((pkey),EVP_PKEY_RSA,\
378 #ifndef OPENSSL_NO_DSA
379 #define EVP_PKEY_assign_DSA(pkey,dsa) EVP_PKEY_assign((pkey),EVP_PKEY_DSA,\
383 #ifndef OPENSSL_NO_DH
384 #define EVP_PKEY_assign_DH(pkey,dh) EVP_PKEY_assign((pkey),EVP_PKEY_DH,\
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))
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)
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)
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)
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)
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)
428 #define EVP_SignInit(a,b) EVP_DigestInit(a,b)
429 #define EVP_SignUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
430 #define EVP_VerifyInit(a,b) EVP_DigestInit(a,b)
431 #define EVP_VerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
432 #define EVP_OpenUpdate(a,b,c,d,e) EVP_DecryptUpdate(a,b,c,d,e)
433 #define EVP_SealUpdate(a,b,c,d,e) EVP_EncryptUpdate(a,b,c,d,e)
436 void BIO_set_md(BIO
*,const EVP_MD
*md
);
438 # define BIO_set_md(b,md) BIO_ctrl(b,BIO_C_SET_MD,0,(char *)md)
440 #define BIO_get_md(b,mdp) BIO_ctrl(b,BIO_C_GET_MD,0,(char *)mdp)
441 #define BIO_get_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_GET_MD_CTX,0,(char *)mdcp)
442 #define BIO_get_cipher_status(b) BIO_ctrl(b,BIO_C_GET_CIPHER_STATUS,0,NULL)
443 #define BIO_get_cipher_ctx(b,c_pp) BIO_ctrl(b,BIO_C_GET_CIPHER_CTX,0,(char *)c_pp)
445 #define EVP_Cipher(c,o,i,l) (c)->cipher->do_cipher((c),(o),(i),(l))
447 #define EVP_add_cipher_alias(n,alias) \
448 OBJ_NAME_add((alias),OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS,(n))
449 #define EVP_add_digest_alias(n,alias) \
450 OBJ_NAME_add((alias),OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS,(n))
451 #define EVP_delete_cipher_alias(alias) \
452 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS);
453 #define EVP_delete_digest_alias(alias) \
454 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS);
456 void EVP_MD_CTX_init(EVP_MD_CTX
*ctx
);
457 int EVP_MD_CTX_cleanup(EVP_MD_CTX
*ctx
);
458 EVP_MD_CTX
*EVP_MD_CTX_create(void);
459 void EVP_MD_CTX_destroy(EVP_MD_CTX
*ctx
);
460 int EVP_MD_CTX_copy(EVP_MD_CTX
*out
,const EVP_MD_CTX
*in
);
461 #define EVP_MD_CTX_set_flags(ctx,flgs) ((ctx)->flags|=(flgs))
462 #define EVP_MD_CTX_clear_flags(ctx,flgs) ((ctx)->flags&=~(flgs))
463 #define EVP_MD_CTX_test_flags(ctx,flgs) ((ctx)->flags&(flgs))
464 int EVP_DigestInit(EVP_MD_CTX
*ctx
, const EVP_MD
*type
);
465 int EVP_DigestInit_ex(EVP_MD_CTX
*ctx
, const EVP_MD
*type
, ENGINE
*impl
);
466 int EVP_DigestUpdate(EVP_MD_CTX
*ctx
,const void *d
,
468 int EVP_DigestFinal(EVP_MD_CTX
*ctx
,unsigned char *md
,unsigned int *s
);
469 int EVP_Digest(void *data
, unsigned int count
,
470 unsigned char *md
, unsigned int *size
, const EVP_MD
*type
);
472 int EVP_read_pw_string(char *buf
,int length
,const char *prompt
,int verify
);
473 void EVP_set_pw_prompt(char *prompt
);
474 char * EVP_get_pw_prompt(void);
476 int EVP_BytesToKey(const EVP_CIPHER
*type
,const EVP_MD
*md
,
477 const unsigned char *salt
, const unsigned char *data
,
478 int datal
, int count
, unsigned char *key
,unsigned char *iv
);
480 int EVP_EncryptInit(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
,
481 const unsigned char *key
, const unsigned char *iv
);
482 int EVP_EncryptInit_ex(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
, ENGINE
*impl
,
483 const unsigned char *key
, const unsigned char *iv
);
484 int EVP_EncryptUpdate(EVP_CIPHER_CTX
*ctx
, unsigned char *out
,
485 int *outl
, const unsigned char *in
, int inl
);
486 int EVP_EncryptFinal(EVP_CIPHER_CTX
*ctx
, unsigned char *out
, int *outl
);
488 int EVP_DecryptInit(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
,
489 const unsigned char *key
, const unsigned char *iv
);
490 int EVP_DecryptInit_ex(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
, ENGINE
*impl
,
491 const unsigned char *key
, const unsigned char *iv
);
492 int EVP_DecryptUpdate(EVP_CIPHER_CTX
*ctx
, unsigned char *out
,
493 int *outl
, const unsigned char *in
, int inl
);
494 int EVP_DecryptFinal(EVP_CIPHER_CTX
*ctx
, unsigned char *outm
, int *outl
);
496 int EVP_CipherInit(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
,
497 const unsigned char *key
,const unsigned char *iv
,
499 int EVP_CipherInit_ex(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
, ENGINE
*impl
,
500 const unsigned char *key
,const unsigned char *iv
,
502 int EVP_CipherUpdate(EVP_CIPHER_CTX
*ctx
, unsigned char *out
,
503 int *outl
, const unsigned char *in
, int inl
);
504 int EVP_CipherFinal(EVP_CIPHER_CTX
*ctx
, unsigned char *outm
, int *outl
);
506 int EVP_SignFinal(EVP_MD_CTX
*ctx
,unsigned char *md
,unsigned int *s
,
509 int EVP_VerifyFinal(EVP_MD_CTX
*ctx
,unsigned char *sigbuf
,
510 unsigned int siglen
,EVP_PKEY
*pkey
);
512 int EVP_OpenInit(EVP_CIPHER_CTX
*ctx
,const EVP_CIPHER
*type
,unsigned char *ek
,
513 int ekl
,unsigned char *iv
,EVP_PKEY
*priv
);
514 int EVP_OpenFinal(EVP_CIPHER_CTX
*ctx
, unsigned char *out
, int *outl
);
516 int EVP_SealInit(EVP_CIPHER_CTX
*ctx
, const EVP_CIPHER
*type
, unsigned char **ek
,
517 int *ekl
, unsigned char *iv
,EVP_PKEY
**pubk
, int npubk
);
518 void EVP_SealFinal(EVP_CIPHER_CTX
*ctx
,unsigned char *out
,int *outl
);
520 void EVP_EncodeInit(EVP_ENCODE_CTX
*ctx
);
521 void EVP_EncodeUpdate(EVP_ENCODE_CTX
*ctx
,unsigned char *out
,
522 int *outl
,unsigned char *in
,int inl
);
523 void EVP_EncodeFinal(EVP_ENCODE_CTX
*ctx
,unsigned char *out
,int *outl
);
524 int EVP_EncodeBlock(unsigned char *t
, const unsigned char *f
, int n
);
526 void EVP_DecodeInit(EVP_ENCODE_CTX
*ctx
);
527 int EVP_DecodeUpdate(EVP_ENCODE_CTX
*ctx
,unsigned char *out
,int *outl
,
528 unsigned char *in
, int inl
);
529 int EVP_DecodeFinal(EVP_ENCODE_CTX
*ctx
, unsigned
530 char *out
, int *outl
);
531 int EVP_DecodeBlock(unsigned char *t
, const unsigned char *f
, int n
);
533 void ERR_load_EVP_strings(void );
535 void EVP_CIPHER_CTX_init(EVP_CIPHER_CTX
*a
);
536 int EVP_CIPHER_CTX_cleanup(EVP_CIPHER_CTX
*a
);
537 int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX
*x
, int keylen
);
538 int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX
*c
, int pad
);
539 int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX
*ctx
, int type
, int arg
, void *ptr
);
541 #ifndef OPENSSL_NO_BIO
542 BIO_METHOD
*BIO_f_md(void);
543 BIO_METHOD
*BIO_f_base64(void);
544 BIO_METHOD
*BIO_f_cipher(void);
545 BIO_METHOD
*BIO_f_reliable(void);
546 void BIO_set_cipher(BIO
*b
,const EVP_CIPHER
*c
,unsigned char *k
,
547 unsigned char *i
, int enc
);
550 const EVP_MD
*EVP_md_null(void);
551 #ifndef OPENSSL_NO_MD2
552 const EVP_MD
*EVP_md2(void);
554 #ifndef OPENSSL_NO_MD4
555 const EVP_MD
*EVP_md4(void);
557 #ifndef OPENSSL_NO_MD5
558 const EVP_MD
*EVP_md5(void);
560 #ifndef OPENSSL_NO_SHA
561 const EVP_MD
*EVP_sha(void);
562 const EVP_MD
*EVP_sha1(void);
563 const EVP_MD
*EVP_dss(void);
564 const EVP_MD
*EVP_dss1(void);
566 #ifndef OPENSSL_NO_MDC2
567 const EVP_MD
*EVP_mdc2(void);
569 #ifndef OPENSSL_NO_RIPEMD
570 const EVP_MD
*EVP_ripemd160(void);
572 const EVP_CIPHER
*EVP_enc_null(void); /* does nothing :-) */
573 #ifndef OPENSSL_NO_DES
574 const EVP_CIPHER
*EVP_des_ecb(void);
575 const EVP_CIPHER
*EVP_des_ede(void);
576 const EVP_CIPHER
*EVP_des_ede3(void);
577 const EVP_CIPHER
*EVP_des_cfb(void);
578 const EVP_CIPHER
*EVP_des_ede_cfb(void);
579 const EVP_CIPHER
*EVP_des_ede3_cfb(void);
580 const EVP_CIPHER
*EVP_des_ofb(void);
581 const EVP_CIPHER
*EVP_des_ede_ofb(void);
582 const EVP_CIPHER
*EVP_des_ede3_ofb(void);
583 const EVP_CIPHER
*EVP_des_cbc(void);
584 const EVP_CIPHER
*EVP_des_ede_cbc(void);
585 const EVP_CIPHER
*EVP_des_ede3_cbc(void);
586 const EVP_CIPHER
*EVP_desx_cbc(void);
587 /* This should now be supported through the dev_crypto ENGINE. But also, why are
588 * rc4 and md5 declarations made here inside a "NO_DES" precompiler branch? */
590 # ifdef OPENSSL_OPENBSD_DEV_CRYPTO
591 const EVP_CIPHER
*EVP_dev_crypto_des_ede3_cbc(void);
592 const EVP_CIPHER
*EVP_dev_crypto_rc4(void);
593 const EVP_MD
*EVP_dev_crypto_md5(void);
597 #ifndef OPENSSL_NO_RC4
598 const EVP_CIPHER
*EVP_rc4(void);
599 const EVP_CIPHER
*EVP_rc4_40(void);
601 #ifndef OPENSSL_NO_IDEA
602 const EVP_CIPHER
*EVP_idea_ecb(void);
603 const EVP_CIPHER
*EVP_idea_cfb(void);
604 const EVP_CIPHER
*EVP_idea_ofb(void);
605 const EVP_CIPHER
*EVP_idea_cbc(void);
607 #ifndef OPENSSL_NO_RC2
608 const EVP_CIPHER
*EVP_rc2_ecb(void);
609 const EVP_CIPHER
*EVP_rc2_cbc(void);
610 const EVP_CIPHER
*EVP_rc2_40_cbc(void);
611 const EVP_CIPHER
*EVP_rc2_64_cbc(void);
612 const EVP_CIPHER
*EVP_rc2_cfb(void);
613 const EVP_CIPHER
*EVP_rc2_ofb(void);
615 #ifndef OPENSSL_NO_BF
616 const EVP_CIPHER
*EVP_bf_ecb(void);
617 const EVP_CIPHER
*EVP_bf_cbc(void);
618 const EVP_CIPHER
*EVP_bf_cfb(void);
619 const EVP_CIPHER
*EVP_bf_ofb(void);
621 #ifndef OPENSSL_NO_CAST
622 const EVP_CIPHER
*EVP_cast5_ecb(void);
623 const EVP_CIPHER
*EVP_cast5_cbc(void);
624 const EVP_CIPHER
*EVP_cast5_cfb(void);
625 const EVP_CIPHER
*EVP_cast5_ofb(void);
627 #ifndef OPENSSL_NO_RC5
628 const EVP_CIPHER
*EVP_rc5_32_12_16_cbc(void);
629 const EVP_CIPHER
*EVP_rc5_32_12_16_ecb(void);
630 const EVP_CIPHER
*EVP_rc5_32_12_16_cfb(void);
631 const EVP_CIPHER
*EVP_rc5_32_12_16_ofb(void);
633 #ifndef OPENSSL_NO_AES
634 const EVP_CIPHER
*EVP_aes_128_ecb(void);
635 const EVP_CIPHER
*EVP_aes_128_cbc(void);
636 const EVP_CIPHER
*EVP_aes_192_ecb(void);
637 const EVP_CIPHER
*EVP_aes_192_cbc(void);
638 const EVP_CIPHER
*EVP_aes_256_ecb(void);
639 const EVP_CIPHER
*EVP_aes_256_cbc(void);
642 void OpenSSL_add_all_algorithms(void);
643 void OpenSSL_add_all_ciphers(void);
644 void OpenSSL_add_all_digests(void);
645 #define SSLeay_add_all_algorithms() OpenSSL_add_all_algorithms()
646 #define SSLeay_add_all_ciphers() OpenSSL_add_all_ciphers()
647 #define SSLeay_add_all_digests() OpenSSL_add_all_digests()
649 int EVP_add_cipher(const EVP_CIPHER
*cipher
);
650 int EVP_add_digest(const EVP_MD
*digest
);
652 const EVP_CIPHER
*EVP_get_cipherbyname(const char *name
);
653 const EVP_MD
*EVP_get_digestbyname(const char *name
);
654 void EVP_cleanup(void);
656 int EVP_PKEY_decrypt(unsigned char *dec_key
,unsigned char *enc_key
,
657 int enc_key_len
,EVP_PKEY
*private_key
);
658 int EVP_PKEY_encrypt(unsigned char *enc_key
,
659 unsigned char *key
,int key_len
,EVP_PKEY
*pub_key
);
660 int EVP_PKEY_type(int type
);
661 int EVP_PKEY_bits(EVP_PKEY
*pkey
);
662 int EVP_PKEY_size(EVP_PKEY
*pkey
);
663 int EVP_PKEY_assign(EVP_PKEY
*pkey
,int type
,char *key
);
665 #ifndef OPENSSL_NO_RSA
667 int EVP_PKEY_set1_RSA(EVP_PKEY
*pkey
,struct rsa_st
*key
);
668 struct rsa_st
*EVP_PKEY_get1_RSA(EVP_PKEY
*pkey
);
670 #ifndef OPENSSL_NO_DSA
672 int EVP_PKEY_set1_DSA(EVP_PKEY
*pkey
,struct dsa_st
*key
);
673 struct dsa_st
*EVP_PKEY_get1_DSA(EVP_PKEY
*pkey
);
675 #ifndef OPENSSL_NO_DH
677 int EVP_PKEY_set1_DH(EVP_PKEY
*pkey
,struct dh_st
*key
);
678 struct dh_st
*EVP_PKEY_get1_DH(EVP_PKEY
*pkey
);
682 EVP_PKEY
* EVP_PKEY_new(void);
683 void EVP_PKEY_free(EVP_PKEY
*pkey
);
684 EVP_PKEY
* d2i_PublicKey(int type
,EVP_PKEY
**a
, unsigned char **pp
,
686 int i2d_PublicKey(EVP_PKEY
*a
, unsigned char **pp
);
688 EVP_PKEY
* d2i_PrivateKey(int type
,EVP_PKEY
**a
, unsigned char **pp
,
690 EVP_PKEY
* d2i_AutoPrivateKey(EVP_PKEY
**a
, unsigned char **pp
,
692 int i2d_PrivateKey(EVP_PKEY
*a
, unsigned char **pp
);
694 int EVP_PKEY_copy_parameters(EVP_PKEY
*to
,EVP_PKEY
*from
);
695 int EVP_PKEY_missing_parameters(EVP_PKEY
*pkey
);
696 int EVP_PKEY_save_parameters(EVP_PKEY
*pkey
,int mode
);
697 int EVP_PKEY_cmp_parameters(EVP_PKEY
*a
,EVP_PKEY
*b
);
699 int EVP_CIPHER_type(const EVP_CIPHER
*ctx
);
702 int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX
*c
, ASN1_TYPE
*type
);
703 int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX
*c
, ASN1_TYPE
*type
);
705 /* These are used by EVP_CIPHER methods */
706 int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX
*c
,ASN1_TYPE
*type
);
707 int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX
*c
,ASN1_TYPE
*type
);
709 /* PKCS5 password based encryption */
710 int PKCS5_PBE_keyivgen(EVP_CIPHER_CTX
*ctx
, const char *pass
, int passlen
,
711 ASN1_TYPE
*param
, const EVP_CIPHER
*cipher
, const EVP_MD
*md
,
713 int PKCS5_PBKDF2_HMAC_SHA1(const char *pass
, int passlen
,
714 unsigned char *salt
, int saltlen
, int iter
,
715 int keylen
, unsigned char *out
);
716 int PKCS5_v2_PBE_keyivgen(EVP_CIPHER_CTX
*ctx
, const char *pass
, int passlen
,
717 ASN1_TYPE
*param
, const EVP_CIPHER
*cipher
, const EVP_MD
*md
,
720 void PKCS5_PBE_add(void);
722 int EVP_PBE_CipherInit (ASN1_OBJECT
*pbe_obj
, const char *pass
, int passlen
,
723 ASN1_TYPE
*param
, EVP_CIPHER_CTX
*ctx
, int en_de
);
724 int EVP_PBE_alg_add(int nid
, const EVP_CIPHER
*cipher
, const EVP_MD
*md
,
725 EVP_PBE_KEYGEN
*keygen
);
726 void EVP_PBE_cleanup(void);
728 /* BEGIN ERROR CODES */
729 /* The following lines are auto generated by the script mkerr.pl. Any changes
730 * made after this point may be overwritten when the script is next run.
732 void ERR_load_EVP_strings(void);
734 /* Error codes for the EVP functions. */
736 /* Function codes. */
737 #define EVP_F_D2I_PKEY 100
738 #define EVP_F_EVP_CIPHERINIT 123
739 #define EVP_F_EVP_CIPHER_CTX_CTRL 124
740 #define EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH 122
741 #define EVP_F_EVP_DECRYPTFINAL 101
742 #define EVP_F_EVP_DIGESTINIT 128
743 #define EVP_F_EVP_ENCRYPTFINAL 127
744 #define EVP_F_EVP_MD_CTX_COPY 110
745 #define EVP_F_EVP_OPENINIT 102
746 #define EVP_F_EVP_PBE_ALG_ADD 115
747 #define EVP_F_EVP_PBE_CIPHERINIT 116
748 #define EVP_F_EVP_PKCS82PKEY 111
749 #define EVP_F_EVP_PKCS8_SET_BROKEN 112
750 #define EVP_F_EVP_PKEY2PKCS8 113
751 #define EVP_F_EVP_PKEY_COPY_PARAMETERS 103
752 #define EVP_F_EVP_PKEY_DECRYPT 104
753 #define EVP_F_EVP_PKEY_ENCRYPT 105
754 #define EVP_F_EVP_PKEY_GET1_DH 119
755 #define EVP_F_EVP_PKEY_GET1_DSA 120
756 #define EVP_F_EVP_PKEY_GET1_RSA 121
757 #define EVP_F_EVP_PKEY_NEW 106
758 #define EVP_F_EVP_RIJNDAEL 126
759 #define EVP_F_EVP_SIGNFINAL 107
760 #define EVP_F_EVP_VERIFYFINAL 108
761 #define EVP_F_PKCS5_PBE_KEYIVGEN 117
762 #define EVP_F_PKCS5_V2_PBE_KEYIVGEN 118
763 #define EVP_F_RC2_MAGIC_TO_METH 109
764 #define EVP_F_RC5_CTRL 125
767 #define EVP_R_BAD_BLOCK_LENGTH 136
768 #define EVP_R_BAD_DECRYPT 100
769 #define EVP_R_BAD_KEY_LENGTH 137
770 #define EVP_R_BN_DECODE_ERROR 112
771 #define EVP_R_BN_PUBKEY_ERROR 113
772 #define EVP_R_CIPHER_PARAMETER_ERROR 122
773 #define EVP_R_CTRL_NOT_IMPLEMENTED 132
774 #define EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED 133
775 #define EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH 138
776 #define EVP_R_DECODE_ERROR 114
777 #define EVP_R_DIFFERENT_KEY_TYPES 101
778 #define EVP_R_ENCODE_ERROR 115
779 #define EVP_R_EVP_PBE_CIPHERINIT_ERROR 119
780 #define EVP_R_EXPECTING_AN_RSA_KEY 127
781 #define EVP_R_EXPECTING_A_DH_KEY 128
782 #define EVP_R_EXPECTING_A_DSA_KEY 129
783 #define EVP_R_INITIALIZATION_ERROR 134
784 #define EVP_R_INPUT_NOT_INITIALIZED 111
785 #define EVP_R_INVALID_KEY_LENGTH 130
786 #define EVP_R_IV_TOO_LARGE 102
787 #define EVP_R_KEYGEN_FAILURE 120
788 #define EVP_R_MISSING_PARAMETERS 103
789 #define EVP_R_NO_CIPHER_SET 131
790 #define EVP_R_NO_DIGEST_SET 139
791 #define EVP_R_NO_DSA_PARAMETERS 116
792 #define EVP_R_NO_SIGN_FUNCTION_CONFIGURED 104
793 #define EVP_R_NO_VERIFY_FUNCTION_CONFIGURED 105
794 #define EVP_R_PKCS8_UNKNOWN_BROKEN_TYPE 117
795 #define EVP_R_PUBLIC_KEY_NOT_RSA 106
796 #define EVP_R_UNKNOWN_PBE_ALGORITHM 121
797 #define EVP_R_UNSUPORTED_NUMBER_OF_ROUNDS 135
798 #define EVP_R_UNSUPPORTED_CIPHER 107
799 #define EVP_R_UNSUPPORTED_KEYLENGTH 123
800 #define EVP_R_UNSUPPORTED_KEY_DERIVATION_FUNCTION 124
801 #define EVP_R_UNSUPPORTED_KEY_SIZE 108
802 #define EVP_R_UNSUPPORTED_PRF 125
803 #define EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM 118
804 #define EVP_R_UNSUPPORTED_SALT_TYPE 126
805 #define EVP_R_WRONG_FINAL_BLOCK_LENGTH 109
806 #define EVP_R_WRONG_PUBLIC_KEY_TYPE 110