]> git.ipfire.org Git - thirdparty/openssl.git/blob - include/openssl/evp.h
make EVP_PKEY opaque
[thirdparty/openssl.git] / include / openssl / 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 # include <openssl/symhacks.h>
73
74 # include <openssl/bio.h>
75
76 # define EVP_MAX_MD_SIZE 64/* longest known is SHA512 */
77 # define EVP_MAX_KEY_LENGTH 64
78 # define EVP_MAX_IV_LENGTH 16
79 # define EVP_MAX_BLOCK_LENGTH 32
80
81 # define PKCS5_SALT_LEN 8
82 /* Default PKCS#5 iteration count */
83 # define PKCS5_DEFAULT_ITER 2048
84
85 # include <openssl/objects.h>
86
87 # define EVP_PK_RSA 0x0001
88 # define EVP_PK_DSA 0x0002
89 # define EVP_PK_DH 0x0004
90 # define EVP_PK_EC 0x0008
91 # define EVP_PKT_SIGN 0x0010
92 # define EVP_PKT_ENC 0x0020
93 # define EVP_PKT_EXCH 0x0040
94 # define EVP_PKS_RSA 0x0100
95 # define EVP_PKS_DSA 0x0200
96 # define EVP_PKS_EC 0x0400
97
98 # define EVP_PKEY_NONE NID_undef
99 # define EVP_PKEY_RSA NID_rsaEncryption
100 # define EVP_PKEY_RSA2 NID_rsa
101 # define EVP_PKEY_DSA NID_dsa
102 # define EVP_PKEY_DSA1 NID_dsa_2
103 # define EVP_PKEY_DSA2 NID_dsaWithSHA
104 # define EVP_PKEY_DSA3 NID_dsaWithSHA1
105 # define EVP_PKEY_DSA4 NID_dsaWithSHA1_2
106 # define EVP_PKEY_DH NID_dhKeyAgreement
107 # define EVP_PKEY_DHX NID_dhpublicnumber
108 # define EVP_PKEY_EC NID_X9_62_id_ecPublicKey
109 # define EVP_PKEY_HMAC NID_hmac
110 # define EVP_PKEY_CMAC NID_cmac
111 # define EVP_PKEY_TLS1_PRF NID_tls1_prf
112
113 #ifdef __cplusplus
114 extern "C" {
115 #endif
116
117 # define EVP_PKEY_MO_SIGN 0x0001
118 # define EVP_PKEY_MO_VERIFY 0x0002
119 # define EVP_PKEY_MO_ENCRYPT 0x0004
120 # define EVP_PKEY_MO_DECRYPT 0x0008
121
122 # ifndef EVP_MD
123 EVP_MD *EVP_MD_meth_new(int md_type, int pkey_type);
124 EVP_MD *EVP_MD_meth_dup(const EVP_MD *md);
125 void EVP_MD_meth_free(EVP_MD *md);
126
127 int EVP_MD_meth_set_input_blocksize(EVP_MD *md, int blocksize);
128 int EVP_MD_meth_set_result_size(EVP_MD *md, int resultsize);
129 int EVP_MD_meth_set_app_datasize(EVP_MD *md, int datasize);
130 int EVP_MD_meth_set_flags(EVP_MD *md, unsigned long flags);
131 int EVP_MD_meth_set_init(EVP_MD *md, int (*init)(EVP_MD_CTX *ctx));
132 int EVP_MD_meth_set_update(EVP_MD *md, int (*update)(EVP_MD_CTX *ctx,
133 const void *data,
134 size_t count));
135 int EVP_MD_meth_set_final(EVP_MD *md, int (*final)(EVP_MD_CTX *ctx,
136 unsigned char *md));
137 int EVP_MD_meth_set_copy(EVP_MD *md, int (*copy)(EVP_MD_CTX *to,
138 const EVP_MD_CTX *from));
139 int EVP_MD_meth_set_cleanup(EVP_MD *md, int (*cleanup)(EVP_MD_CTX *ctx));
140 int EVP_MD_meth_set_ctrl(EVP_MD *md, int (*ctrl)(EVP_MD_CTX *ctx, int cmd,
141 int p1, void *p2));
142
143 int EVP_MD_meth_get_input_blocksize(const EVP_MD *md);
144 int EVP_MD_meth_get_result_size(const EVP_MD *md);
145 int EVP_MD_meth_get_app_datasize(const EVP_MD *md);
146 unsigned long EVP_MD_meth_get_flags(const EVP_MD *md);
147 int (*EVP_MD_meth_get_init(const EVP_MD *md))(EVP_MD_CTX *ctx);
148 int (*EVP_MD_meth_get_update(const EVP_MD *md))(EVP_MD_CTX *ctx,
149 const void *data,
150 size_t count);
151 int (*EVP_MD_meth_get_final(const EVP_MD *md))(EVP_MD_CTX *ctx,
152 unsigned char *md);
153 int (*EVP_MD_meth_get_copy(const EVP_MD *md))(EVP_MD_CTX *to,
154 const EVP_MD_CTX *from);
155 int (*EVP_MD_meth_get_cleanup(const EVP_MD *md))(EVP_MD_CTX *ctx);
156 int (*EVP_MD_meth_get_ctrl(const EVP_MD *md))(EVP_MD_CTX *ctx, int cmd,
157 int p1, void *p2);
158
159 /* digest can only handle a single block */
160 # define EVP_MD_FLAG_ONESHOT 0x0001
161
162 /* DigestAlgorithmIdentifier flags... */
163
164 # define EVP_MD_FLAG_DIGALGID_MASK 0x0018
165
166 /* NULL or absent parameter accepted. Use NULL */
167
168 # define EVP_MD_FLAG_DIGALGID_NULL 0x0000
169
170 /* NULL or absent parameter accepted. Use NULL for PKCS#1 otherwise absent */
171
172 # define EVP_MD_FLAG_DIGALGID_ABSENT 0x0008
173
174 /* Custom handling via ctrl */
175
176 # define EVP_MD_FLAG_DIGALGID_CUSTOM 0x0018
177
178 /* Note if suitable for use in FIPS mode */
179 # define EVP_MD_FLAG_FIPS 0x0400
180
181 /* Digest ctrls */
182
183 # define EVP_MD_CTRL_DIGALGID 0x1
184 # define EVP_MD_CTRL_MICALG 0x2
185
186 /* Minimum Algorithm specific ctrl value */
187
188 # define EVP_MD_CTRL_ALG_CTRL 0x1000
189
190 # endif /* !EVP_MD */
191
192 /* values for EVP_MD_CTX flags */
193
194 # define EVP_MD_CTX_FLAG_ONESHOT 0x0001/* digest update will be
195 * called once only */
196 # define EVP_MD_CTX_FLAG_CLEANED 0x0002/* context has already been
197 * cleaned */
198 # define EVP_MD_CTX_FLAG_REUSE 0x0004/* Don't free up ctx->md_data
199 * in EVP_MD_CTX_reset */
200 /*
201 * FIPS and pad options are ignored in 1.0.0, definitions are here so we
202 * don't accidentally reuse the values for other purposes.
203 */
204
205 # define EVP_MD_CTX_FLAG_NON_FIPS_ALLOW 0x0008/* Allow use of non FIPS
206 * digest in FIPS mode */
207
208 /*
209 * The following PAD options are also currently ignored in 1.0.0, digest
210 * parameters are handled through EVP_DigestSign*() and EVP_DigestVerify*()
211 * instead.
212 */
213 # define EVP_MD_CTX_FLAG_PAD_MASK 0xF0/* RSA mode to use */
214 # define EVP_MD_CTX_FLAG_PAD_PKCS1 0x00/* PKCS#1 v1.5 mode */
215 # define EVP_MD_CTX_FLAG_PAD_X931 0x10/* X9.31 mode */
216 # define EVP_MD_CTX_FLAG_PAD_PSS 0x20/* PSS mode */
217
218 # define EVP_MD_CTX_FLAG_NO_INIT 0x0100/* Don't initialize md_data */
219 /*
220 * Some functions such as EVP_DigestSign only finalise copies of internal
221 * contexts so additional data can be included after the finalisation call.
222 * This is inefficient if this functionality is not required: it is disabled
223 * if the following flag is set.
224 */
225 # define EVP_MD_CTX_FLAG_FINALISE 0x0200
226
227 EVP_CIPHER *EVP_CIPHER_meth_new(int cipher_type, int block_size, int key_len);
228 EVP_CIPHER *EVP_CIPHER_meth_dup(const EVP_CIPHER *cipher);
229 void EVP_CIPHER_meth_free(EVP_CIPHER *cipher);
230
231 int EVP_CIPHER_meth_set_iv_length(EVP_CIPHER *cipher, int iv_len);
232 int EVP_CIPHER_meth_set_flags(EVP_CIPHER *cipher, unsigned long flags);
233 int EVP_CIPHER_meth_set_impl_ctx_size(EVP_CIPHER *cipher, int ctx_size);
234 int EVP_CIPHER_meth_set_init(EVP_CIPHER *cipher,
235 int (*init) (EVP_CIPHER_CTX *ctx,
236 const unsigned char *key,
237 const unsigned char *iv,
238 int enc));
239 int EVP_CIPHER_meth_set_do_cipher(EVP_CIPHER *cipher,
240 int (*do_cipher) (EVP_CIPHER_CTX *ctx,
241 unsigned char *out,
242 const unsigned char *in,
243 size_t inl));
244 int EVP_CIPHER_meth_set_cleanup(EVP_CIPHER *cipher,
245 int (*cleanup) (EVP_CIPHER_CTX *));
246 int EVP_CIPHER_meth_set_set_asn1_params(EVP_CIPHER *cipher,
247 int (*set_asn1_parameters) (EVP_CIPHER_CTX *,
248 ASN1_TYPE *));
249 int EVP_CIPHER_meth_set_get_asn1_params(EVP_CIPHER *cipher,
250 int (*get_asn1_parameters) (EVP_CIPHER_CTX *,
251 ASN1_TYPE *));
252 int EVP_CIPHER_meth_set_ctrl(EVP_CIPHER *cipher,
253 int (*ctrl) (EVP_CIPHER_CTX *, int type,
254 int arg, void *ptr));
255
256 int (*EVP_CIPHER_meth_get_init(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *ctx,
257 const unsigned char *key,
258 const unsigned char *iv,
259 int enc);
260 int (*EVP_CIPHER_meth_get_do_cipher(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *ctx,
261 unsigned char *out,
262 const unsigned char *in,
263 size_t inl);
264 int (*EVP_CIPHER_meth_get_cleanup(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *);
265 int (*EVP_CIPHER_meth_get_set_asn1_params(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *,
266 ASN1_TYPE *);
267 int (*EVP_CIPHER_meth_get_get_asn1_params(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *,
268 ASN1_TYPE *);
269 int (*EVP_CIPHER_meth_get_ctrl(const EVP_CIPHER *cipher))(EVP_CIPHER_CTX *,
270 int type, int arg,
271 void *ptr);
272
273 /* Values for cipher flags */
274
275 /* Modes for ciphers */
276
277 # define EVP_CIPH_STREAM_CIPHER 0x0
278 # define EVP_CIPH_ECB_MODE 0x1
279 # define EVP_CIPH_CBC_MODE 0x2
280 # define EVP_CIPH_CFB_MODE 0x3
281 # define EVP_CIPH_OFB_MODE 0x4
282 # define EVP_CIPH_CTR_MODE 0x5
283 # define EVP_CIPH_GCM_MODE 0x6
284 # define EVP_CIPH_CCM_MODE 0x7
285 # define EVP_CIPH_XTS_MODE 0x10001
286 # define EVP_CIPH_WRAP_MODE 0x10002
287 # define EVP_CIPH_OCB_MODE 0x10003
288 # define EVP_CIPH_MODE 0xF0007
289 /* Set if variable length cipher */
290 # define EVP_CIPH_VARIABLE_LENGTH 0x8
291 /* Set if the iv handling should be done by the cipher itself */
292 # define EVP_CIPH_CUSTOM_IV 0x10
293 /* Set if the cipher's init() function should be called if key is NULL */
294 # define EVP_CIPH_ALWAYS_CALL_INIT 0x20
295 /* Call ctrl() to init cipher parameters */
296 # define EVP_CIPH_CTRL_INIT 0x40
297 /* Don't use standard key length function */
298 # define EVP_CIPH_CUSTOM_KEY_LENGTH 0x80
299 /* Don't use standard block padding */
300 # define EVP_CIPH_NO_PADDING 0x100
301 /* cipher handles random key generation */
302 # define EVP_CIPH_RAND_KEY 0x200
303 /* cipher has its own additional copying logic */
304 # define EVP_CIPH_CUSTOM_COPY 0x400
305 /* Allow use default ASN1 get/set iv */
306 # define EVP_CIPH_FLAG_DEFAULT_ASN1 0x1000
307 /* Buffer length in bits not bytes: CFB1 mode only */
308 # define EVP_CIPH_FLAG_LENGTH_BITS 0x2000
309 /* Note if suitable for use in FIPS mode */
310 # define EVP_CIPH_FLAG_FIPS 0x4000
311 /* Allow non FIPS cipher in FIPS mode */
312 # define EVP_CIPH_FLAG_NON_FIPS_ALLOW 0x8000
313 /*
314 * Cipher handles any and all padding logic as well as finalisation.
315 */
316 # define EVP_CIPH_FLAG_CUSTOM_CIPHER 0x100000
317 # define EVP_CIPH_FLAG_AEAD_CIPHER 0x200000
318 # define EVP_CIPH_FLAG_TLS1_1_MULTIBLOCK 0x400000
319
320 /*
321 * Cipher context flag to indicate we can handle wrap mode: if allowed in
322 * older applications it could overflow buffers.
323 */
324
325 # define EVP_CIPHER_CTX_FLAG_WRAP_ALLOW 0x1
326
327 /* ctrl() values */
328
329 # define EVP_CTRL_INIT 0x0
330 # define EVP_CTRL_SET_KEY_LENGTH 0x1
331 # define EVP_CTRL_GET_RC2_KEY_BITS 0x2
332 # define EVP_CTRL_SET_RC2_KEY_BITS 0x3
333 # define EVP_CTRL_GET_RC5_ROUNDS 0x4
334 # define EVP_CTRL_SET_RC5_ROUNDS 0x5
335 # define EVP_CTRL_RAND_KEY 0x6
336 # define EVP_CTRL_PBE_PRF_NID 0x7
337 # define EVP_CTRL_COPY 0x8
338 # define EVP_CTRL_AEAD_SET_IVLEN 0x9
339 # define EVP_CTRL_AEAD_GET_TAG 0x10
340 # define EVP_CTRL_AEAD_SET_TAG 0x11
341 # define EVP_CTRL_AEAD_SET_IV_FIXED 0x12
342 # define EVP_CTRL_GCM_SET_IVLEN EVP_CTRL_AEAD_SET_IVLEN
343 # define EVP_CTRL_GCM_GET_TAG EVP_CTRL_AEAD_GET_TAG
344 # define EVP_CTRL_GCM_SET_TAG EVP_CTRL_AEAD_SET_TAG
345 # define EVP_CTRL_GCM_SET_IV_FIXED EVP_CTRL_AEAD_SET_IV_FIXED
346 # define EVP_CTRL_GCM_IV_GEN 0x13
347 # define EVP_CTRL_CCM_SET_IVLEN EVP_CTRL_AEAD_SET_IVLEN
348 # define EVP_CTRL_CCM_GET_TAG EVP_CTRL_AEAD_GET_TAG
349 # define EVP_CTRL_CCM_SET_TAG EVP_CTRL_AEAD_SET_TAG
350 # define EVP_CTRL_CCM_SET_IV_FIXED EVP_CTRL_AEAD_SET_IV_FIXED
351 # define EVP_CTRL_CCM_SET_L 0x14
352 # define EVP_CTRL_CCM_SET_MSGLEN 0x15
353 /*
354 * AEAD cipher deduces payload length and returns number of bytes required to
355 * store MAC and eventual padding. Subsequent call to EVP_Cipher even
356 * appends/verifies MAC.
357 */
358 # define EVP_CTRL_AEAD_TLS1_AAD 0x16
359 /* Used by composite AEAD ciphers, no-op in GCM, CCM... */
360 # define EVP_CTRL_AEAD_SET_MAC_KEY 0x17
361 /* Set the GCM invocation field, decrypt only */
362 # define EVP_CTRL_GCM_SET_IV_INV 0x18
363
364 # define EVP_CTRL_TLS1_1_MULTIBLOCK_AAD 0x19
365 # define EVP_CTRL_TLS1_1_MULTIBLOCK_ENCRYPT 0x1a
366 # define EVP_CTRL_TLS1_1_MULTIBLOCK_DECRYPT 0x1b
367 # define EVP_CTRL_TLS1_1_MULTIBLOCK_MAX_BUFSIZE 0x1c
368
369 # define EVP_CTRL_SSL3_MASTER_SECRET 0x1d
370
371 /* EVP_CTRL_SET_SBOX takes the char * specifying S-boxes */
372 # define EVP_CTRL_SET_SBOX 0x1e
373 /*
374 * EVP_CTRL_SBOX_USED takes a 'size_t' and 'char *', pointing at a
375 * pre-allocated buffer with specified size
376 */
377 # define EVP_CTRL_SBOX_USED 0x1f
378 /* EVP_CTRL_KEY_MESH takes 'size_t' number of bytes to mesh the key after,
379 * 0 switches meshing off
380 */
381 # define EVP_CTRL_KEY_MESH 0x20
382 /* EVP_CTRL_BLOCK_PADDING_MODE takes the padding mode */
383 # define EVP_CTRL_BLOCK_PADDING_MODE 0x21
384
385 /* Padding modes */
386 #define EVP_PADDING_PKCS7 1
387 #define EVP_PADDING_ISO7816_4 2
388 #define EVP_PADDING_ANSI923 3
389 #define EVP_PADDING_ISO10126 4
390 #define EVP_PADDING_ZERO 5
391
392 /* RFC 5246 defines additional data to be 13 bytes in length */
393 # define EVP_AEAD_TLS1_AAD_LEN 13
394
395 typedef struct {
396 unsigned char *out;
397 const unsigned char *inp;
398 size_t len;
399 unsigned int interleave;
400 } EVP_CTRL_TLS1_1_MULTIBLOCK_PARAM;
401
402 /* GCM TLS constants */
403 /* Length of fixed part of IV derived from PRF */
404 # define EVP_GCM_TLS_FIXED_IV_LEN 4
405 /* Length of explicit part of IV part of TLS records */
406 # define EVP_GCM_TLS_EXPLICIT_IV_LEN 8
407 /* Length of tag for TLS */
408 # define EVP_GCM_TLS_TAG_LEN 16
409
410 /* CCM TLS constants */
411 /* Length of fixed part of IV derived from PRF */
412 # define EVP_CCM_TLS_FIXED_IV_LEN 4
413 /* Length of explicit part of IV part of TLS records */
414 # define EVP_CCM_TLS_EXPLICIT_IV_LEN 8
415
416 typedef struct evp_cipher_info_st {
417 const EVP_CIPHER *cipher;
418 unsigned char iv[EVP_MAX_IV_LENGTH];
419 } EVP_CIPHER_INFO;
420
421
422 /* Password based encryption function */
423 typedef int (EVP_PBE_KEYGEN) (EVP_CIPHER_CTX *ctx, const char *pass,
424 int passlen, ASN1_TYPE *param,
425 const EVP_CIPHER *cipher, const EVP_MD *md,
426 int en_de);
427
428 # ifndef OPENSSL_NO_RSA
429 # define EVP_PKEY_assign_RSA(pkey,rsa) EVP_PKEY_assign((pkey),EVP_PKEY_RSA,\
430 (char *)(rsa))
431 # endif
432
433 # ifndef OPENSSL_NO_DSA
434 # define EVP_PKEY_assign_DSA(pkey,dsa) EVP_PKEY_assign((pkey),EVP_PKEY_DSA,\
435 (char *)(dsa))
436 # endif
437
438 # ifndef OPENSSL_NO_DH
439 # define EVP_PKEY_assign_DH(pkey,dh) EVP_PKEY_assign((pkey),EVP_PKEY_DH,\
440 (char *)(dh))
441 # endif
442
443 # ifndef OPENSSL_NO_EC
444 # define EVP_PKEY_assign_EC_KEY(pkey,eckey) EVP_PKEY_assign((pkey),EVP_PKEY_EC,\
445 (char *)(eckey))
446 # endif
447
448 /* Add some extra combinations */
449 # define EVP_get_digestbynid(a) EVP_get_digestbyname(OBJ_nid2sn(a))
450 # define EVP_get_digestbyobj(a) EVP_get_digestbynid(OBJ_obj2nid(a))
451 # define EVP_get_cipherbynid(a) EVP_get_cipherbyname(OBJ_nid2sn(a))
452 # define EVP_get_cipherbyobj(a) EVP_get_cipherbynid(OBJ_obj2nid(a))
453
454 int EVP_MD_type(const EVP_MD *md);
455 # define EVP_MD_nid(e) EVP_MD_type(e)
456 # define EVP_MD_name(e) OBJ_nid2sn(EVP_MD_nid(e))
457 int EVP_MD_pkey_type(const EVP_MD *md);
458 int EVP_MD_size(const EVP_MD *md);
459 int EVP_MD_block_size(const EVP_MD *md);
460 unsigned long EVP_MD_flags(const EVP_MD *md);
461
462 const EVP_MD *EVP_MD_CTX_md(const EVP_MD_CTX *ctx);
463 int (*EVP_MD_CTX_update_fn(EVP_MD_CTX *ctx))(EVP_MD_CTX *ctx,
464 const void *data, size_t count);
465 void EVP_MD_CTX_set_update_fn(EVP_MD_CTX *ctx,
466 int (*update) (EVP_MD_CTX *ctx,
467 const void *data, size_t count));
468 # define EVP_MD_CTX_size(e) EVP_MD_size(EVP_MD_CTX_md(e))
469 # define EVP_MD_CTX_block_size(e) EVP_MD_block_size(EVP_MD_CTX_md(e))
470 # define EVP_MD_CTX_type(e) EVP_MD_type(EVP_MD_CTX_md(e))
471 EVP_PKEY_CTX *EVP_MD_CTX_pkey_ctx(const EVP_MD_CTX *ctx);
472 void *EVP_MD_CTX_md_data(const EVP_MD_CTX *ctx);
473
474 int EVP_CIPHER_nid(const EVP_CIPHER *cipher);
475 # define EVP_CIPHER_name(e) OBJ_nid2sn(EVP_CIPHER_nid(e))
476 int EVP_CIPHER_block_size(const EVP_CIPHER *cipher);
477 int EVP_CIPHER_impl_ctx_size(const EVP_CIPHER *cipher);
478 int EVP_CIPHER_key_length(const EVP_CIPHER *cipher);
479 int EVP_CIPHER_iv_length(const EVP_CIPHER *cipher);
480 unsigned long EVP_CIPHER_flags(const EVP_CIPHER *cipher);
481 # define EVP_CIPHER_mode(e) (EVP_CIPHER_flags(e) & EVP_CIPH_MODE)
482
483 const EVP_CIPHER *EVP_CIPHER_CTX_cipher(const EVP_CIPHER_CTX *ctx);
484 int EVP_CIPHER_CTX_encrypting(const EVP_CIPHER_CTX *ctx);
485 int EVP_CIPHER_CTX_nid(const EVP_CIPHER_CTX *ctx);
486 int EVP_CIPHER_CTX_block_size(const EVP_CIPHER_CTX *ctx);
487 int EVP_CIPHER_CTX_key_length(const EVP_CIPHER_CTX *ctx);
488 int EVP_CIPHER_CTX_iv_length(const EVP_CIPHER_CTX *ctx);
489 const unsigned char *EVP_CIPHER_CTX_iv(const EVP_CIPHER_CTX *ctx);
490 const unsigned char *EVP_CIPHER_CTX_original_iv(const EVP_CIPHER_CTX *ctx);
491 unsigned char *EVP_CIPHER_CTX_iv_noconst(EVP_CIPHER_CTX *ctx);
492 unsigned char *EVP_CIPHER_CTX_buf_noconst(EVP_CIPHER_CTX *ctx);
493 int EVP_CIPHER_CTX_num(const EVP_CIPHER_CTX *ctx);
494 void EVP_CIPHER_CTX_set_num(EVP_CIPHER_CTX *ctx, int num);
495 int EVP_CIPHER_CTX_copy(EVP_CIPHER_CTX *out, const EVP_CIPHER_CTX *in);
496 void *EVP_CIPHER_CTX_get_app_data(const EVP_CIPHER_CTX *ctx);
497 void EVP_CIPHER_CTX_set_app_data(EVP_CIPHER_CTX *ctx, void *data);
498 void *EVP_CIPHER_CTX_cipher_data(const EVP_CIPHER_CTX *ctx);
499 # define EVP_CIPHER_CTX_type(c) EVP_CIPHER_type(EVP_CIPHER_CTX_cipher(c))
500 # if OPENSSL_API_COMPAT < 0x10100000L
501 # define EVP_CIPHER_CTX_flags(c) EVP_CIPHER_flags(EVP_CIPHER_CTX_cipher(c))
502 # endif
503 # define EVP_CIPHER_CTX_mode(c) EVP_CIPHER_mode(EVP_CIPHER_CTX_cipher(c))
504
505 # define EVP_ENCODE_LENGTH(l) (((l+2)/3*4)+(l/48+1)*2+80)
506 # define EVP_DECODE_LENGTH(l) ((l+3)/4*3+80)
507
508 # define EVP_SignInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c)
509 # define EVP_SignInit(a,b) EVP_DigestInit(a,b)
510 # define EVP_SignUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
511 # define EVP_VerifyInit_ex(a,b,c) EVP_DigestInit_ex(a,b,c)
512 # define EVP_VerifyInit(a,b) EVP_DigestInit(a,b)
513 # define EVP_VerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
514 # define EVP_OpenUpdate(a,b,c,d,e) EVP_DecryptUpdate(a,b,c,d,e)
515 # define EVP_SealUpdate(a,b,c,d,e) EVP_EncryptUpdate(a,b,c,d,e)
516 # define EVP_DigestSignUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
517 # define EVP_DigestVerifyUpdate(a,b,c) EVP_DigestUpdate(a,b,c)
518
519 # ifdef CONST_STRICT
520 void BIO_set_md(BIO *, const EVP_MD *md);
521 # else
522 # define BIO_set_md(b,md) BIO_ctrl(b,BIO_C_SET_MD,0,(char *)md)
523 # endif
524 # define BIO_get_md(b,mdp) BIO_ctrl(b,BIO_C_GET_MD,0,(char *)mdp)
525 # define BIO_get_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_GET_MD_CTX,0,(char *)mdcp)
526 # define BIO_set_md_ctx(b,mdcp) BIO_ctrl(b,BIO_C_SET_MD_CTX,0,(char *)mdcp)
527 # define BIO_get_cipher_status(b) BIO_ctrl(b,BIO_C_GET_CIPHER_STATUS,0,NULL)
528 # define BIO_get_cipher_ctx(b,c_pp) BIO_ctrl(b,BIO_C_GET_CIPHER_CTX,0,(char *)c_pp)
529
530 /*__owur*/ int EVP_Cipher(EVP_CIPHER_CTX *c,
531 unsigned char *out,
532 const unsigned char *in, unsigned int inl);
533
534 # define EVP_add_cipher_alias(n,alias) \
535 OBJ_NAME_add((alias),OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS,(n))
536 # define EVP_add_digest_alias(n,alias) \
537 OBJ_NAME_add((alias),OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS,(n))
538 # define EVP_delete_cipher_alias(alias) \
539 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_CIPHER_METH|OBJ_NAME_ALIAS);
540 # define EVP_delete_digest_alias(alias) \
541 OBJ_NAME_remove(alias,OBJ_NAME_TYPE_MD_METH|OBJ_NAME_ALIAS);
542
543 int EVP_MD_CTX_ctrl(EVP_MD_CTX *ctx, int cmd, int p1, void *p2);
544 EVP_MD_CTX *EVP_MD_CTX_new(void);
545 int EVP_MD_CTX_reset(EVP_MD_CTX *ctx);
546 void EVP_MD_CTX_free(EVP_MD_CTX *ctx);
547 # define EVP_MD_CTX_create() EVP_MD_CTX_new()
548 # define EVP_MD_CTX_init(ctx) EVP_MD_CTX_reset((ctx))
549 # define EVP_MD_CTX_destroy(ctx) EVP_MD_CTX_free((ctx))
550 /*__owur*/ int EVP_MD_CTX_copy_ex(EVP_MD_CTX *out, const EVP_MD_CTX *in);
551 void EVP_MD_CTX_set_flags(EVP_MD_CTX *ctx, int flags);
552 void EVP_MD_CTX_clear_flags(EVP_MD_CTX *ctx, int flags);
553 int EVP_MD_CTX_test_flags(const EVP_MD_CTX *ctx, int flags);
554 /*__owur*/ int EVP_DigestInit_ex(EVP_MD_CTX *ctx, const EVP_MD *type,
555 ENGINE *impl);
556 /*__owur*/ int EVP_DigestUpdate(EVP_MD_CTX *ctx, const void *d,
557 size_t cnt);
558 /*__owur*/ int EVP_DigestFinal_ex(EVP_MD_CTX *ctx, unsigned char *md,
559 unsigned int *s);
560 /*__owur*/ int EVP_Digest(const void *data, size_t count,
561 unsigned char *md, unsigned int *size,
562 const EVP_MD *type, ENGINE *impl);
563
564 /*__owur*/ int EVP_MD_CTX_copy(EVP_MD_CTX *out, const EVP_MD_CTX *in);
565 /*__owur*/ int EVP_DigestInit(EVP_MD_CTX *ctx, const EVP_MD *type);
566 __owur int EVP_DigestFinal(EVP_MD_CTX *ctx, unsigned char *md,
567 unsigned int *s);
568
569 int EVP_read_pw_string(char *buf, int length, const char *prompt, int verify);
570 int EVP_read_pw_string_min(char *buf, int minlen, int maxlen,
571 const char *prompt, int verify);
572 void EVP_set_pw_prompt(const char *prompt);
573 char *EVP_get_pw_prompt(void);
574
575 __owur int EVP_BytesToKey(const EVP_CIPHER *type, const EVP_MD *md,
576 const unsigned char *salt,
577 const unsigned char *data, int datal, int count,
578 unsigned char *key, unsigned char *iv);
579
580 void EVP_CIPHER_CTX_set_flags(EVP_CIPHER_CTX *ctx, int flags);
581 void EVP_CIPHER_CTX_clear_flags(EVP_CIPHER_CTX *ctx, int flags);
582 int EVP_CIPHER_CTX_test_flags(const EVP_CIPHER_CTX *ctx, int flags);
583
584 __owur int EVP_EncryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
585 const unsigned char *key, const unsigned char *iv);
586 /*__owur*/ int EVP_EncryptInit_ex(EVP_CIPHER_CTX *ctx,
587 const EVP_CIPHER *cipher, ENGINE *impl,
588 const unsigned char *key,
589 const unsigned char *iv);
590 /*__owur*/ int EVP_EncryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
591 int *outl, const unsigned char *in, int inl);
592 /*__owur*/ int EVP_EncryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *out,
593 int *outl);
594 /*__owur*/ int EVP_EncryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *out,
595 int *outl);
596
597 __owur int EVP_DecryptInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
598 const unsigned char *key, const unsigned char *iv);
599 /*__owur*/ int EVP_DecryptInit_ex(EVP_CIPHER_CTX *ctx,
600 const EVP_CIPHER *cipher, ENGINE *impl,
601 const unsigned char *key,
602 const unsigned char *iv);
603 /*__owur*/ int EVP_DecryptUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
604 int *outl, const unsigned char *in, int inl);
605 __owur int EVP_DecryptFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm,
606 int *outl);
607 /*__owur*/ int EVP_DecryptFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm,
608 int *outl);
609
610 __owur int EVP_CipherInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *cipher,
611 const unsigned char *key, const unsigned char *iv,
612 int enc);
613 /*__owur*/ int EVP_CipherInit_ex(EVP_CIPHER_CTX *ctx,
614 const EVP_CIPHER *cipher, ENGINE *impl,
615 const unsigned char *key,
616 const unsigned char *iv, int enc);
617 __owur int EVP_CipherUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
618 int *outl, const unsigned char *in, int inl);
619 __owur int EVP_CipherFinal(EVP_CIPHER_CTX *ctx, unsigned char *outm,
620 int *outl);
621 __owur int EVP_CipherFinal_ex(EVP_CIPHER_CTX *ctx, unsigned char *outm,
622 int *outl);
623
624 __owur int EVP_SignFinal(EVP_MD_CTX *ctx, unsigned char *md, unsigned int *s,
625 EVP_PKEY *pkey);
626
627 __owur int EVP_VerifyFinal(EVP_MD_CTX *ctx, const unsigned char *sigbuf,
628 unsigned int siglen, EVP_PKEY *pkey);
629
630 /*__owur*/ int EVP_DigestSignInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx,
631 const EVP_MD *type, ENGINE *e,
632 EVP_PKEY *pkey);
633 __owur int EVP_DigestSignFinal(EVP_MD_CTX *ctx, unsigned char *sigret,
634 size_t *siglen);
635
636 __owur int EVP_DigestVerifyInit(EVP_MD_CTX *ctx, EVP_PKEY_CTX **pctx,
637 const EVP_MD *type, ENGINE *e,
638 EVP_PKEY *pkey);
639 __owur int EVP_DigestVerifyFinal(EVP_MD_CTX *ctx, const unsigned char *sig,
640 size_t siglen);
641
642 # ifndef OPENSSL_NO_RSA
643 __owur int EVP_OpenInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type,
644 const unsigned char *ek, int ekl,
645 const unsigned char *iv, EVP_PKEY *priv);
646 __owur int EVP_OpenFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
647
648 __owur int EVP_SealInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type,
649 unsigned char **ek, int *ekl, unsigned char *iv,
650 EVP_PKEY **pubk, int npubk);
651 __owur int EVP_SealFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);
652 # endif
653
654 EVP_ENCODE_CTX *EVP_ENCODE_CTX_new(void);
655 void EVP_ENCODE_CTX_free(EVP_ENCODE_CTX *ctx);
656 int EVP_ENCODE_CTX_num(EVP_ENCODE_CTX *ctx);
657 void EVP_EncodeInit(EVP_ENCODE_CTX *ctx);
658 void EVP_EncodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl,
659 const unsigned char *in, int inl);
660 void EVP_EncodeFinal(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl);
661 int EVP_EncodeBlock(unsigned char *t, const unsigned char *f, int n);
662
663 void EVP_DecodeInit(EVP_ENCODE_CTX *ctx);
664 int EVP_DecodeUpdate(EVP_ENCODE_CTX *ctx, unsigned char *out, int *outl,
665 const unsigned char *in, int inl);
666 int EVP_DecodeFinal(EVP_ENCODE_CTX *ctx, unsigned
667 char *out, int *outl);
668 int EVP_DecodeBlock(unsigned char *t, const unsigned char *f, int n);
669
670 # if OPENSSL_API_COMPAT < 0x10100000L
671 # define EVP_CIPHER_CTX_init(c) EVP_CIPHER_CTX_reset(c)
672 # define EVP_CIPHER_CTX_cleanup(c) EVP_CIPHER_CTX_reset(c)
673 # endif
674 EVP_CIPHER_CTX *EVP_CIPHER_CTX_new(void);
675 int EVP_CIPHER_CTX_reset(EVP_CIPHER_CTX *c);
676 void EVP_CIPHER_CTX_free(EVP_CIPHER_CTX *c);
677 int EVP_CIPHER_CTX_set_key_length(EVP_CIPHER_CTX *x, int keylen);
678 int EVP_CIPHER_CTX_set_padding(EVP_CIPHER_CTX *c, int pad);
679 int EVP_CIPHER_CTX_ctrl(EVP_CIPHER_CTX *ctx, int type, int arg, void *ptr);
680 int EVP_CIPHER_CTX_rand_key(EVP_CIPHER_CTX *ctx, unsigned char *key);
681
682 BIO_METHOD *BIO_f_md(void);
683 BIO_METHOD *BIO_f_base64(void);
684 BIO_METHOD *BIO_f_cipher(void);
685 BIO_METHOD *BIO_f_reliable(void);
686 __owur int BIO_set_cipher(BIO *b, const EVP_CIPHER *c, const unsigned char *k,
687 const unsigned char *i, int enc);
688
689 const EVP_MD *EVP_md_null(void);
690 # ifndef OPENSSL_NO_MD2
691 const EVP_MD *EVP_md2(void);
692 # endif
693 # ifndef OPENSSL_NO_MD4
694 const EVP_MD *EVP_md4(void);
695 # endif
696 # ifndef OPENSSL_NO_MD5
697 const EVP_MD *EVP_md5(void);
698 const EVP_MD *EVP_md5_sha1(void);
699 # endif
700 const EVP_MD *EVP_sha1(void);
701 const EVP_MD *EVP_sha224(void);
702 const EVP_MD *EVP_sha256(void);
703 const EVP_MD *EVP_sha384(void);
704 const EVP_MD *EVP_sha512(void);
705 # ifndef OPENSSL_NO_MDC2
706 const EVP_MD *EVP_mdc2(void);
707 # endif
708 # ifndef OPENSSL_NO_RMD160
709 const EVP_MD *EVP_ripemd160(void);
710 # endif
711 # ifndef OPENSSL_NO_WHIRLPOOL
712 const EVP_MD *EVP_whirlpool(void);
713 # endif
714 const EVP_CIPHER *EVP_enc_null(void); /* does nothing :-) */
715 # ifndef OPENSSL_NO_DES
716 const EVP_CIPHER *EVP_des_ecb(void);
717 const EVP_CIPHER *EVP_des_ede(void);
718 const EVP_CIPHER *EVP_des_ede3(void);
719 const EVP_CIPHER *EVP_des_ede_ecb(void);
720 const EVP_CIPHER *EVP_des_ede3_ecb(void);
721 const EVP_CIPHER *EVP_des_cfb64(void);
722 # define EVP_des_cfb EVP_des_cfb64
723 const EVP_CIPHER *EVP_des_cfb1(void);
724 const EVP_CIPHER *EVP_des_cfb8(void);
725 const EVP_CIPHER *EVP_des_ede_cfb64(void);
726 # define EVP_des_ede_cfb EVP_des_ede_cfb64
727 const EVP_CIPHER *EVP_des_ede3_cfb64(void);
728 # define EVP_des_ede3_cfb EVP_des_ede3_cfb64
729 const EVP_CIPHER *EVP_des_ede3_cfb1(void);
730 const EVP_CIPHER *EVP_des_ede3_cfb8(void);
731 const EVP_CIPHER *EVP_des_ofb(void);
732 const EVP_CIPHER *EVP_des_ede_ofb(void);
733 const EVP_CIPHER *EVP_des_ede3_ofb(void);
734 const EVP_CIPHER *EVP_des_cbc(void);
735 const EVP_CIPHER *EVP_des_ede_cbc(void);
736 const EVP_CIPHER *EVP_des_ede3_cbc(void);
737 const EVP_CIPHER *EVP_desx_cbc(void);
738 const EVP_CIPHER *EVP_des_ede3_wrap(void);
739 /*
740 * This should now be supported through the dev_crypto ENGINE. But also, why
741 * are rc4 and md5 declarations made here inside a "NO_DES" precompiler
742 * branch?
743 */
744 # endif
745 # ifndef OPENSSL_NO_RC4
746 const EVP_CIPHER *EVP_rc4(void);
747 const EVP_CIPHER *EVP_rc4_40(void);
748 # ifndef OPENSSL_NO_MD5
749 const EVP_CIPHER *EVP_rc4_hmac_md5(void);
750 # endif
751 # endif
752 # ifndef OPENSSL_NO_IDEA
753 const EVP_CIPHER *EVP_idea_ecb(void);
754 const EVP_CIPHER *EVP_idea_cfb64(void);
755 # define EVP_idea_cfb EVP_idea_cfb64
756 const EVP_CIPHER *EVP_idea_ofb(void);
757 const EVP_CIPHER *EVP_idea_cbc(void);
758 # endif
759 # ifndef OPENSSL_NO_RC2
760 const EVP_CIPHER *EVP_rc2_ecb(void);
761 const EVP_CIPHER *EVP_rc2_cbc(void);
762 const EVP_CIPHER *EVP_rc2_40_cbc(void);
763 const EVP_CIPHER *EVP_rc2_64_cbc(void);
764 const EVP_CIPHER *EVP_rc2_cfb64(void);
765 # define EVP_rc2_cfb EVP_rc2_cfb64
766 const EVP_CIPHER *EVP_rc2_ofb(void);
767 # endif
768 # ifndef OPENSSL_NO_BF
769 const EVP_CIPHER *EVP_bf_ecb(void);
770 const EVP_CIPHER *EVP_bf_cbc(void);
771 const EVP_CIPHER *EVP_bf_cfb64(void);
772 # define EVP_bf_cfb EVP_bf_cfb64
773 const EVP_CIPHER *EVP_bf_ofb(void);
774 # endif
775 # ifndef OPENSSL_NO_CAST
776 const EVP_CIPHER *EVP_cast5_ecb(void);
777 const EVP_CIPHER *EVP_cast5_cbc(void);
778 const EVP_CIPHER *EVP_cast5_cfb64(void);
779 # define EVP_cast5_cfb EVP_cast5_cfb64
780 const EVP_CIPHER *EVP_cast5_ofb(void);
781 # endif
782 # ifndef OPENSSL_NO_RC5
783 const EVP_CIPHER *EVP_rc5_32_12_16_cbc(void);
784 const EVP_CIPHER *EVP_rc5_32_12_16_ecb(void);
785 const EVP_CIPHER *EVP_rc5_32_12_16_cfb64(void);
786 # define EVP_rc5_32_12_16_cfb EVP_rc5_32_12_16_cfb64
787 const EVP_CIPHER *EVP_rc5_32_12_16_ofb(void);
788 # endif
789 # ifndef OPENSSL_NO_AES
790 const EVP_CIPHER *EVP_aes_128_ecb(void);
791 const EVP_CIPHER *EVP_aes_128_cbc(void);
792 const EVP_CIPHER *EVP_aes_128_cfb1(void);
793 const EVP_CIPHER *EVP_aes_128_cfb8(void);
794 const EVP_CIPHER *EVP_aes_128_cfb128(void);
795 # define EVP_aes_128_cfb EVP_aes_128_cfb128
796 const EVP_CIPHER *EVP_aes_128_ofb(void);
797 const EVP_CIPHER *EVP_aes_128_ctr(void);
798 const EVP_CIPHER *EVP_aes_128_ccm(void);
799 const EVP_CIPHER *EVP_aes_128_gcm(void);
800 const EVP_CIPHER *EVP_aes_128_xts(void);
801 const EVP_CIPHER *EVP_aes_128_wrap(void);
802 const EVP_CIPHER *EVP_aes_128_wrap_pad(void);
803 # ifndef OPENSSL_NO_OCB
804 const EVP_CIPHER *EVP_aes_128_ocb(void);
805 # endif
806 const EVP_CIPHER *EVP_aes_192_ecb(void);
807 const EVP_CIPHER *EVP_aes_192_cbc(void);
808 const EVP_CIPHER *EVP_aes_192_cfb1(void);
809 const EVP_CIPHER *EVP_aes_192_cfb8(void);
810 const EVP_CIPHER *EVP_aes_192_cfb128(void);
811 # define EVP_aes_192_cfb EVP_aes_192_cfb128
812 const EVP_CIPHER *EVP_aes_192_ofb(void);
813 const EVP_CIPHER *EVP_aes_192_ctr(void);
814 const EVP_CIPHER *EVP_aes_192_ccm(void);
815 const EVP_CIPHER *EVP_aes_192_gcm(void);
816 const EVP_CIPHER *EVP_aes_192_wrap(void);
817 const EVP_CIPHER *EVP_aes_192_wrap_pad(void);
818 # ifndef OPENSSL_NO_OCB
819 const EVP_CIPHER *EVP_aes_192_ocb(void);
820 # endif
821 const EVP_CIPHER *EVP_aes_256_ecb(void);
822 const EVP_CIPHER *EVP_aes_256_cbc(void);
823 const EVP_CIPHER *EVP_aes_256_cfb1(void);
824 const EVP_CIPHER *EVP_aes_256_cfb8(void);
825 const EVP_CIPHER *EVP_aes_256_cfb128(void);
826 # define EVP_aes_256_cfb EVP_aes_256_cfb128
827 const EVP_CIPHER *EVP_aes_256_ofb(void);
828 const EVP_CIPHER *EVP_aes_256_ctr(void);
829 const EVP_CIPHER *EVP_aes_256_ccm(void);
830 const EVP_CIPHER *EVP_aes_256_gcm(void);
831 const EVP_CIPHER *EVP_aes_256_xts(void);
832 const EVP_CIPHER *EVP_aes_256_wrap(void);
833 const EVP_CIPHER *EVP_aes_256_wrap_pad(void);
834 # ifndef OPENSSL_NO_OCB
835 const EVP_CIPHER *EVP_aes_256_ocb(void);
836 # endif
837 const EVP_CIPHER *EVP_aes_128_cbc_hmac_sha1(void);
838 const EVP_CIPHER *EVP_aes_256_cbc_hmac_sha1(void);
839 const EVP_CIPHER *EVP_aes_128_cbc_hmac_sha256(void);
840 const EVP_CIPHER *EVP_aes_256_cbc_hmac_sha256(void);
841 # endif
842 # ifndef OPENSSL_NO_CAMELLIA
843 const EVP_CIPHER *EVP_camellia_128_ecb(void);
844 const EVP_CIPHER *EVP_camellia_128_cbc(void);
845 const EVP_CIPHER *EVP_camellia_128_cfb1(void);
846 const EVP_CIPHER *EVP_camellia_128_cfb8(void);
847 const EVP_CIPHER *EVP_camellia_128_cfb128(void);
848 # define EVP_camellia_128_cfb EVP_camellia_128_cfb128
849 const EVP_CIPHER *EVP_camellia_128_ofb(void);
850 const EVP_CIPHER *EVP_camellia_128_ctr(void);
851 const EVP_CIPHER *EVP_camellia_192_ecb(void);
852 const EVP_CIPHER *EVP_camellia_192_cbc(void);
853 const EVP_CIPHER *EVP_camellia_192_cfb1(void);
854 const EVP_CIPHER *EVP_camellia_192_cfb8(void);
855 const EVP_CIPHER *EVP_camellia_192_cfb128(void);
856 # define EVP_camellia_192_cfb EVP_camellia_192_cfb128
857 const EVP_CIPHER *EVP_camellia_192_ofb(void);
858 const EVP_CIPHER *EVP_camellia_192_ctr(void);
859 const EVP_CIPHER *EVP_camellia_256_ecb(void);
860 const EVP_CIPHER *EVP_camellia_256_cbc(void);
861 const EVP_CIPHER *EVP_camellia_256_cfb1(void);
862 const EVP_CIPHER *EVP_camellia_256_cfb8(void);
863 const EVP_CIPHER *EVP_camellia_256_cfb128(void);
864 # define EVP_camellia_256_cfb EVP_camellia_256_cfb128
865 const EVP_CIPHER *EVP_camellia_256_ofb(void);
866 const EVP_CIPHER *EVP_camellia_256_ctr(void);
867 # endif
868 # ifndef OPENSSL_NO_CHACHA
869 const EVP_CIPHER *EVP_chacha20(void);
870 # ifndef OPENSSL_NO_POLY1305
871 const EVP_CIPHER *EVP_chacha20_poly1305(void);
872 # endif
873 # endif
874
875 # ifndef OPENSSL_NO_SEED
876 const EVP_CIPHER *EVP_seed_ecb(void);
877 const EVP_CIPHER *EVP_seed_cbc(void);
878 const EVP_CIPHER *EVP_seed_cfb128(void);
879 # define EVP_seed_cfb EVP_seed_cfb128
880 const EVP_CIPHER *EVP_seed_ofb(void);
881 # endif
882
883 void OPENSSL_add_all_algorithms_noconf(void);
884 void OPENSSL_add_all_algorithms_conf(void);
885
886 # ifdef OPENSSL_LOAD_CONF
887 # define OpenSSL_add_all_algorithms() \
888 OPENSSL_add_all_algorithms_conf()
889 # else
890 # define OpenSSL_add_all_algorithms() \
891 OPENSSL_add_all_algorithms_noconf()
892 # endif
893
894 void OpenSSL_add_all_ciphers(void);
895 void OpenSSL_add_all_digests(void);
896
897 int EVP_add_cipher(const EVP_CIPHER *cipher);
898 int EVP_add_digest(const EVP_MD *digest);
899
900 const EVP_CIPHER *EVP_get_cipherbyname(const char *name);
901 const EVP_MD *EVP_get_digestbyname(const char *name);
902 void EVP_cleanup(void);
903
904 void EVP_CIPHER_do_all(void (*fn) (const EVP_CIPHER *ciph,
905 const char *from, const char *to, void *x),
906 void *arg);
907 void EVP_CIPHER_do_all_sorted(void (*fn)
908 (const EVP_CIPHER *ciph, const char *from,
909 const char *to, void *x), void *arg);
910
911 void EVP_MD_do_all(void (*fn) (const EVP_MD *ciph,
912 const char *from, const char *to, void *x),
913 void *arg);
914 void EVP_MD_do_all_sorted(void (*fn)
915 (const EVP_MD *ciph, const char *from,
916 const char *to, void *x), void *arg);
917
918 int EVP_PKEY_decrypt_old(unsigned char *dec_key,
919 const unsigned char *enc_key, int enc_key_len,
920 EVP_PKEY *private_key);
921 int EVP_PKEY_encrypt_old(unsigned char *enc_key,
922 const unsigned char *key, int key_len,
923 EVP_PKEY *pub_key);
924 int EVP_PKEY_type(int type);
925 int EVP_PKEY_id(const EVP_PKEY *pkey);
926 int EVP_PKEY_base_id(const EVP_PKEY *pkey);
927 int EVP_PKEY_bits(EVP_PKEY *pkey);
928 int EVP_PKEY_security_bits(const EVP_PKEY *pkey);
929 int EVP_PKEY_size(EVP_PKEY *pkey);
930 int EVP_PKEY_set_type(EVP_PKEY *pkey, int type);
931 int EVP_PKEY_set_type_str(EVP_PKEY *pkey, const char *str, int len);
932 int EVP_PKEY_assign(EVP_PKEY *pkey, int type, void *key);
933 void *EVP_PKEY_get0(const EVP_PKEY *pkey);
934
935 # ifndef OPENSSL_NO_RSA
936 struct rsa_st;
937 int EVP_PKEY_set1_RSA(EVP_PKEY *pkey, struct rsa_st *key);
938 struct rsa_st *EVP_PKEY_get0_RSA(EVP_PKEY *pkey);
939 struct rsa_st *EVP_PKEY_get1_RSA(EVP_PKEY *pkey);
940 # endif
941 # ifndef OPENSSL_NO_DSA
942 struct dsa_st;
943 int EVP_PKEY_set1_DSA(EVP_PKEY *pkey, struct dsa_st *key);
944 struct dsa_st *EVP_PKEY_get0_DSA(EVP_PKEY *pkey);
945 struct dsa_st *EVP_PKEY_get1_DSA(EVP_PKEY *pkey);
946 # endif
947 # ifndef OPENSSL_NO_DH
948 struct dh_st;
949 int EVP_PKEY_set1_DH(EVP_PKEY *pkey, struct dh_st *key);
950 struct dh_st *EVP_PKEY_get0_DH(EVP_PKEY *pkey);
951 struct dh_st *EVP_PKEY_get1_DH(EVP_PKEY *pkey);
952 # endif
953 # ifndef OPENSSL_NO_EC
954 struct ec_key_st;
955 int EVP_PKEY_set1_EC_KEY(EVP_PKEY *pkey, struct ec_key_st *key);
956 struct ec_key_st *EVP_PKEY_get0_EC_KEY(EVP_PKEY *pkey);
957 struct ec_key_st *EVP_PKEY_get1_EC_KEY(EVP_PKEY *pkey);
958 # endif
959
960 EVP_PKEY *EVP_PKEY_new(void);
961 void EVP_PKEY_up_ref(EVP_PKEY *pkey);
962 void EVP_PKEY_free(EVP_PKEY *pkey);
963
964 EVP_PKEY *d2i_PublicKey(int type, EVP_PKEY **a, const unsigned char **pp,
965 long length);
966 int i2d_PublicKey(EVP_PKEY *a, unsigned char **pp);
967
968 EVP_PKEY *d2i_PrivateKey(int type, EVP_PKEY **a, const unsigned char **pp,
969 long length);
970 EVP_PKEY *d2i_AutoPrivateKey(EVP_PKEY **a, const unsigned char **pp,
971 long length);
972 int i2d_PrivateKey(EVP_PKEY *a, unsigned char **pp);
973
974 int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);
975 int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);
976 int EVP_PKEY_save_parameters(EVP_PKEY *pkey, int mode);
977 int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);
978
979 int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);
980
981 int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey,
982 int indent, ASN1_PCTX *pctx);
983 int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey,
984 int indent, ASN1_PCTX *pctx);
985 int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey,
986 int indent, ASN1_PCTX *pctx);
987
988 int EVP_PKEY_get_default_digest_nid(EVP_PKEY *pkey, int *pnid);
989
990 int EVP_CIPHER_type(const EVP_CIPHER *ctx);
991
992 /* calls methods */
993 int EVP_CIPHER_param_to_asn1(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
994 int EVP_CIPHER_asn1_to_param(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
995
996 /* These are used by EVP_CIPHER methods */
997 int EVP_CIPHER_set_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
998 int EVP_CIPHER_get_asn1_iv(EVP_CIPHER_CTX *c, ASN1_TYPE *type);
999
1000 /* PKCS5 password based encryption */
1001 int PKCS5_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
1002 ASN1_TYPE *param, const EVP_CIPHER *cipher,
1003 const EVP_MD *md, int en_de);
1004 int PKCS5_PBKDF2_HMAC_SHA1(const char *pass, int passlen,
1005 const unsigned char *salt, int saltlen, int iter,
1006 int keylen, unsigned char *out);
1007 int PKCS5_PBKDF2_HMAC(const char *pass, int passlen,
1008 const unsigned char *salt, int saltlen, int iter,
1009 const EVP_MD *digest, int keylen, unsigned char *out);
1010 int PKCS5_v2_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
1011 ASN1_TYPE *param, const EVP_CIPHER *cipher,
1012 const EVP_MD *md, int en_de);
1013
1014 #ifndef OPENSSL_NO_SCRYPT
1015 int EVP_PBE_scrypt(const char *pass, size_t passlen,
1016 const unsigned char *salt, size_t saltlen,
1017 uint64_t N, uint64_t r, uint64_t p, uint64_t maxmem,
1018 unsigned char *key, size_t keylen);
1019
1020 int PKCS5_v2_scrypt_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass,
1021 int passlen, ASN1_TYPE *param,
1022 const EVP_CIPHER *c, const EVP_MD *md, int en_de);
1023 #endif
1024
1025 void PKCS5_PBE_add(void);
1026
1027 int EVP_PBE_CipherInit(ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
1028 ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de);
1029
1030 /* PBE type */
1031
1032 /* Can appear as the outermost AlgorithmIdentifier */
1033 # define EVP_PBE_TYPE_OUTER 0x0
1034 /* Is an PRF type OID */
1035 # define EVP_PBE_TYPE_PRF 0x1
1036 /* Is a PKCS#5 v2.0 KDF */
1037 # define EVP_PBE_TYPE_KDF 0x2
1038
1039 int EVP_PBE_alg_add_type(int pbe_type, int pbe_nid, int cipher_nid,
1040 int md_nid, EVP_PBE_KEYGEN *keygen);
1041 int EVP_PBE_alg_add(int nid, const EVP_CIPHER *cipher, const EVP_MD *md,
1042 EVP_PBE_KEYGEN *keygen);
1043 int EVP_PBE_find(int type, int pbe_nid, int *pcnid, int *pmnid,
1044 EVP_PBE_KEYGEN **pkeygen);
1045 void EVP_PBE_cleanup(void);
1046 int EVP_PBE_get(int *ptype, int *ppbe_nid, size_t num);
1047
1048 # define ASN1_PKEY_ALIAS 0x1
1049 # define ASN1_PKEY_DYNAMIC 0x2
1050 # define ASN1_PKEY_SIGPARAM_NULL 0x4
1051
1052 # define ASN1_PKEY_CTRL_PKCS7_SIGN 0x1
1053 # define ASN1_PKEY_CTRL_PKCS7_ENCRYPT 0x2
1054 # define ASN1_PKEY_CTRL_DEFAULT_MD_NID 0x3
1055 # define ASN1_PKEY_CTRL_CMS_SIGN 0x5
1056 # define ASN1_PKEY_CTRL_CMS_ENVELOPE 0x7
1057 # define ASN1_PKEY_CTRL_CMS_RI_TYPE 0x8
1058
1059 int EVP_PKEY_asn1_get_count(void);
1060 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_get0(int idx);
1061 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find(ENGINE **pe, int type);
1062 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_find_str(ENGINE **pe,
1063 const char *str, int len);
1064 int EVP_PKEY_asn1_add0(const EVP_PKEY_ASN1_METHOD *ameth);
1065 int EVP_PKEY_asn1_add_alias(int to, int from);
1066 int EVP_PKEY_asn1_get0_info(int *ppkey_id, int *pkey_base_id,
1067 int *ppkey_flags, const char **pinfo,
1068 const char **ppem_str,
1069 const EVP_PKEY_ASN1_METHOD *ameth);
1070
1071 const EVP_PKEY_ASN1_METHOD *EVP_PKEY_get0_asn1(EVP_PKEY *pkey);
1072 EVP_PKEY_ASN1_METHOD *EVP_PKEY_asn1_new(int id, int flags,
1073 const char *pem_str,
1074 const char *info);
1075 void EVP_PKEY_asn1_copy(EVP_PKEY_ASN1_METHOD *dst,
1076 const EVP_PKEY_ASN1_METHOD *src);
1077 void EVP_PKEY_asn1_free(EVP_PKEY_ASN1_METHOD *ameth);
1078 void EVP_PKEY_asn1_set_public(EVP_PKEY_ASN1_METHOD *ameth,
1079 int (*pub_decode) (EVP_PKEY *pk,
1080 X509_PUBKEY *pub),
1081 int (*pub_encode) (X509_PUBKEY *pub,
1082 const EVP_PKEY *pk),
1083 int (*pub_cmp) (const EVP_PKEY *a,
1084 const EVP_PKEY *b),
1085 int (*pub_print) (BIO *out,
1086 const EVP_PKEY *pkey,
1087 int indent, ASN1_PCTX *pctx),
1088 int (*pkey_size) (const EVP_PKEY *pk),
1089 int (*pkey_bits) (const EVP_PKEY *pk));
1090 void EVP_PKEY_asn1_set_private(EVP_PKEY_ASN1_METHOD *ameth,
1091 int (*priv_decode) (EVP_PKEY *pk,
1092 PKCS8_PRIV_KEY_INFO
1093 *p8inf),
1094 int (*priv_encode) (PKCS8_PRIV_KEY_INFO *p8,
1095 const EVP_PKEY *pk),
1096 int (*priv_print) (BIO *out,
1097 const EVP_PKEY *pkey,
1098 int indent,
1099 ASN1_PCTX *pctx));
1100 void EVP_PKEY_asn1_set_param(EVP_PKEY_ASN1_METHOD *ameth,
1101 int (*param_decode) (EVP_PKEY *pkey,
1102 const unsigned char **pder,
1103 int derlen),
1104 int (*param_encode) (const EVP_PKEY *pkey,
1105 unsigned char **pder),
1106 int (*param_missing) (const EVP_PKEY *pk),
1107 int (*param_copy) (EVP_PKEY *to,
1108 const EVP_PKEY *from),
1109 int (*param_cmp) (const EVP_PKEY *a,
1110 const EVP_PKEY *b),
1111 int (*param_print) (BIO *out,
1112 const EVP_PKEY *pkey,
1113 int indent,
1114 ASN1_PCTX *pctx));
1115
1116 void EVP_PKEY_asn1_set_free(EVP_PKEY_ASN1_METHOD *ameth,
1117 void (*pkey_free) (EVP_PKEY *pkey));
1118 void EVP_PKEY_asn1_set_ctrl(EVP_PKEY_ASN1_METHOD *ameth,
1119 int (*pkey_ctrl) (EVP_PKEY *pkey, int op,
1120 long arg1, void *arg2));
1121 void EVP_PKEY_asn1_set_item(EVP_PKEY_ASN1_METHOD *ameth,
1122 int (*item_verify) (EVP_MD_CTX *ctx,
1123 const ASN1_ITEM *it,
1124 void *asn,
1125 X509_ALGOR *a,
1126 ASN1_BIT_STRING *sig,
1127 EVP_PKEY *pkey),
1128 int (*item_sign) (EVP_MD_CTX *ctx,
1129 const ASN1_ITEM *it,
1130 void *asn,
1131 X509_ALGOR *alg1,
1132 X509_ALGOR *alg2,
1133 ASN1_BIT_STRING *sig));
1134
1135 void EVP_PKEY_asn1_set_security_bits(EVP_PKEY_ASN1_METHOD *ameth,
1136 int (*pkey_security_bits) (const EVP_PKEY
1137 *pk));
1138
1139 # define EVP_PKEY_OP_UNDEFINED 0
1140 # define EVP_PKEY_OP_PARAMGEN (1<<1)
1141 # define EVP_PKEY_OP_KEYGEN (1<<2)
1142 # define EVP_PKEY_OP_SIGN (1<<3)
1143 # define EVP_PKEY_OP_VERIFY (1<<4)
1144 # define EVP_PKEY_OP_VERIFYRECOVER (1<<5)
1145 # define EVP_PKEY_OP_SIGNCTX (1<<6)
1146 # define EVP_PKEY_OP_VERIFYCTX (1<<7)
1147 # define EVP_PKEY_OP_ENCRYPT (1<<8)
1148 # define EVP_PKEY_OP_DECRYPT (1<<9)
1149 # define EVP_PKEY_OP_DERIVE (1<<10)
1150
1151 # define EVP_PKEY_OP_TYPE_SIG \
1152 (EVP_PKEY_OP_SIGN | EVP_PKEY_OP_VERIFY | EVP_PKEY_OP_VERIFYRECOVER \
1153 | EVP_PKEY_OP_SIGNCTX | EVP_PKEY_OP_VERIFYCTX)
1154
1155 # define EVP_PKEY_OP_TYPE_CRYPT \
1156 (EVP_PKEY_OP_ENCRYPT | EVP_PKEY_OP_DECRYPT)
1157
1158 # define EVP_PKEY_OP_TYPE_NOGEN \
1159 (EVP_PKEY_OP_TYPE_SIG | EVP_PKEY_OP_TYPE_CRYPT | EVP_PKEY_OP_DERIVE)
1160
1161 # define EVP_PKEY_OP_TYPE_GEN \
1162 (EVP_PKEY_OP_PARAMGEN | EVP_PKEY_OP_KEYGEN)
1163
1164 # define EVP_PKEY_CTX_set_signature_md(ctx, md) \
1165 EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_TYPE_SIG, \
1166 EVP_PKEY_CTRL_MD, 0, (void *)md)
1167
1168 # define EVP_PKEY_CTX_get_signature_md(ctx, pmd) \
1169 EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_TYPE_SIG, \
1170 EVP_PKEY_CTRL_GET_MD, 0, (void *)pmd)
1171
1172 # define EVP_PKEY_CTX_set_mac_key(ctx, key, len) \
1173 EVP_PKEY_CTX_ctrl(ctx, -1, EVP_PKEY_OP_KEYGEN, \
1174 EVP_PKEY_CTRL_SET_MAC_KEY, len, (void *)key)
1175
1176 # define EVP_PKEY_CTRL_MD 1
1177 # define EVP_PKEY_CTRL_PEER_KEY 2
1178
1179 # define EVP_PKEY_CTRL_PKCS7_ENCRYPT 3
1180 # define EVP_PKEY_CTRL_PKCS7_DECRYPT 4
1181
1182 # define EVP_PKEY_CTRL_PKCS7_SIGN 5
1183
1184 # define EVP_PKEY_CTRL_SET_MAC_KEY 6
1185
1186 # define EVP_PKEY_CTRL_DIGESTINIT 7
1187
1188 /* Used by GOST key encryption in TLS */
1189 # define EVP_PKEY_CTRL_SET_IV 8
1190
1191 # define EVP_PKEY_CTRL_CMS_ENCRYPT 9
1192 # define EVP_PKEY_CTRL_CMS_DECRYPT 10
1193 # define EVP_PKEY_CTRL_CMS_SIGN 11
1194
1195 # define EVP_PKEY_CTRL_CIPHER 12
1196
1197 # define EVP_PKEY_CTRL_GET_MD 13
1198
1199 # define EVP_PKEY_ALG_CTRL 0x1000
1200
1201 # define EVP_PKEY_FLAG_AUTOARGLEN 2
1202 /*
1203 * Method handles all operations: don't assume any digest related defaults.
1204 */
1205 # define EVP_PKEY_FLAG_SIGCTX_CUSTOM 4
1206
1207 const EVP_PKEY_METHOD *EVP_PKEY_meth_find(int type);
1208 EVP_PKEY_METHOD *EVP_PKEY_meth_new(int id, int flags);
1209 void EVP_PKEY_meth_get0_info(int *ppkey_id, int *pflags,
1210 const EVP_PKEY_METHOD *meth);
1211 void EVP_PKEY_meth_copy(EVP_PKEY_METHOD *dst, const EVP_PKEY_METHOD *src);
1212 void EVP_PKEY_meth_free(EVP_PKEY_METHOD *pmeth);
1213 int EVP_PKEY_meth_add0(const EVP_PKEY_METHOD *pmeth);
1214
1215 EVP_PKEY_CTX *EVP_PKEY_CTX_new(EVP_PKEY *pkey, ENGINE *e);
1216 EVP_PKEY_CTX *EVP_PKEY_CTX_new_id(int id, ENGINE *e);
1217 EVP_PKEY_CTX *EVP_PKEY_CTX_dup(EVP_PKEY_CTX *ctx);
1218 void EVP_PKEY_CTX_free(EVP_PKEY_CTX *ctx);
1219
1220 int EVP_PKEY_CTX_ctrl(EVP_PKEY_CTX *ctx, int keytype, int optype,
1221 int cmd, int p1, void *p2);
1222 int EVP_PKEY_CTX_ctrl_str(EVP_PKEY_CTX *ctx, const char *type,
1223 const char *value);
1224
1225 int EVP_PKEY_CTX_get_operation(EVP_PKEY_CTX *ctx);
1226 void EVP_PKEY_CTX_set0_keygen_info(EVP_PKEY_CTX *ctx, int *dat, int datlen);
1227
1228 EVP_PKEY *EVP_PKEY_new_mac_key(int type, ENGINE *e,
1229 const unsigned char *key, int keylen);
1230
1231 void EVP_PKEY_CTX_set_data(EVP_PKEY_CTX *ctx, void *data);
1232 void *EVP_PKEY_CTX_get_data(EVP_PKEY_CTX *ctx);
1233 EVP_PKEY *EVP_PKEY_CTX_get0_pkey(EVP_PKEY_CTX *ctx);
1234
1235 EVP_PKEY *EVP_PKEY_CTX_get0_peerkey(EVP_PKEY_CTX *ctx);
1236
1237 void EVP_PKEY_CTX_set_app_data(EVP_PKEY_CTX *ctx, void *data);
1238 void *EVP_PKEY_CTX_get_app_data(EVP_PKEY_CTX *ctx);
1239
1240 int EVP_PKEY_sign_init(EVP_PKEY_CTX *ctx);
1241 int EVP_PKEY_sign(EVP_PKEY_CTX *ctx,
1242 unsigned char *sig, size_t *siglen,
1243 const unsigned char *tbs, size_t tbslen);
1244 int EVP_PKEY_verify_init(EVP_PKEY_CTX *ctx);
1245 int EVP_PKEY_verify(EVP_PKEY_CTX *ctx,
1246 const unsigned char *sig, size_t siglen,
1247 const unsigned char *tbs, size_t tbslen);
1248 int EVP_PKEY_verify_recover_init(EVP_PKEY_CTX *ctx);
1249 int EVP_PKEY_verify_recover(EVP_PKEY_CTX *ctx,
1250 unsigned char *rout, size_t *routlen,
1251 const unsigned char *sig, size_t siglen);
1252 int EVP_PKEY_encrypt_init(EVP_PKEY_CTX *ctx);
1253 int EVP_PKEY_encrypt(EVP_PKEY_CTX *ctx,
1254 unsigned char *out, size_t *outlen,
1255 const unsigned char *in, size_t inlen);
1256 int EVP_PKEY_decrypt_init(EVP_PKEY_CTX *ctx);
1257 int EVP_PKEY_decrypt(EVP_PKEY_CTX *ctx,
1258 unsigned char *out, size_t *outlen,
1259 const unsigned char *in, size_t inlen);
1260
1261 int EVP_PKEY_derive_init(EVP_PKEY_CTX *ctx);
1262 int EVP_PKEY_derive_set_peer(EVP_PKEY_CTX *ctx, EVP_PKEY *peer);
1263 int EVP_PKEY_derive(EVP_PKEY_CTX *ctx, unsigned char *key, size_t *keylen);
1264
1265 typedef int EVP_PKEY_gen_cb(EVP_PKEY_CTX *ctx);
1266
1267 int EVP_PKEY_paramgen_init(EVP_PKEY_CTX *ctx);
1268 int EVP_PKEY_paramgen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey);
1269 int EVP_PKEY_keygen_init(EVP_PKEY_CTX *ctx);
1270 int EVP_PKEY_keygen(EVP_PKEY_CTX *ctx, EVP_PKEY **ppkey);
1271
1272 void EVP_PKEY_CTX_set_cb(EVP_PKEY_CTX *ctx, EVP_PKEY_gen_cb *cb);
1273 EVP_PKEY_gen_cb *EVP_PKEY_CTX_get_cb(EVP_PKEY_CTX *ctx);
1274
1275 int EVP_PKEY_CTX_get_keygen_info(EVP_PKEY_CTX *ctx, int idx);
1276
1277 void EVP_PKEY_meth_set_init(EVP_PKEY_METHOD *pmeth,
1278 int (*init) (EVP_PKEY_CTX *ctx));
1279
1280 void EVP_PKEY_meth_set_copy(EVP_PKEY_METHOD *pmeth,
1281 int (*copy) (EVP_PKEY_CTX *dst,
1282 EVP_PKEY_CTX *src));
1283
1284 void EVP_PKEY_meth_set_cleanup(EVP_PKEY_METHOD *pmeth,
1285 void (*cleanup) (EVP_PKEY_CTX *ctx));
1286
1287 void EVP_PKEY_meth_set_paramgen(EVP_PKEY_METHOD *pmeth,
1288 int (*paramgen_init) (EVP_PKEY_CTX *ctx),
1289 int (*paramgen) (EVP_PKEY_CTX *ctx,
1290 EVP_PKEY *pkey));
1291
1292 void EVP_PKEY_meth_set_keygen(EVP_PKEY_METHOD *pmeth,
1293 int (*keygen_init) (EVP_PKEY_CTX *ctx),
1294 int (*keygen) (EVP_PKEY_CTX *ctx,
1295 EVP_PKEY *pkey));
1296
1297 void EVP_PKEY_meth_set_sign(EVP_PKEY_METHOD *pmeth,
1298 int (*sign_init) (EVP_PKEY_CTX *ctx),
1299 int (*sign) (EVP_PKEY_CTX *ctx,
1300 unsigned char *sig, size_t *siglen,
1301 const unsigned char *tbs,
1302 size_t tbslen));
1303
1304 void EVP_PKEY_meth_set_verify(EVP_PKEY_METHOD *pmeth,
1305 int (*verify_init) (EVP_PKEY_CTX *ctx),
1306 int (*verify) (EVP_PKEY_CTX *ctx,
1307 const unsigned char *sig,
1308 size_t siglen,
1309 const unsigned char *tbs,
1310 size_t tbslen));
1311
1312 void EVP_PKEY_meth_set_verify_recover(EVP_PKEY_METHOD *pmeth,
1313 int (*verify_recover_init) (EVP_PKEY_CTX
1314 *ctx),
1315 int (*verify_recover) (EVP_PKEY_CTX
1316 *ctx,
1317 unsigned char
1318 *sig,
1319 size_t *siglen,
1320 const unsigned
1321 char *tbs,
1322 size_t tbslen));
1323
1324 void EVP_PKEY_meth_set_signctx(EVP_PKEY_METHOD *pmeth,
1325 int (*signctx_init) (EVP_PKEY_CTX *ctx,
1326 EVP_MD_CTX *mctx),
1327 int (*signctx) (EVP_PKEY_CTX *ctx,
1328 unsigned char *sig,
1329 size_t *siglen,
1330 EVP_MD_CTX *mctx));
1331
1332 void EVP_PKEY_meth_set_verifyctx(EVP_PKEY_METHOD *pmeth,
1333 int (*verifyctx_init) (EVP_PKEY_CTX *ctx,
1334 EVP_MD_CTX *mctx),
1335 int (*verifyctx) (EVP_PKEY_CTX *ctx,
1336 const unsigned char *sig,
1337 int siglen,
1338 EVP_MD_CTX *mctx));
1339
1340 void EVP_PKEY_meth_set_encrypt(EVP_PKEY_METHOD *pmeth,
1341 int (*encrypt_init) (EVP_PKEY_CTX *ctx),
1342 int (*encryptfn) (EVP_PKEY_CTX *ctx,
1343 unsigned char *out,
1344 size_t *outlen,
1345 const unsigned char *in,
1346 size_t inlen));
1347
1348 void EVP_PKEY_meth_set_decrypt(EVP_PKEY_METHOD *pmeth,
1349 int (*decrypt_init) (EVP_PKEY_CTX *ctx),
1350 int (*decrypt) (EVP_PKEY_CTX *ctx,
1351 unsigned char *out,
1352 size_t *outlen,
1353 const unsigned char *in,
1354 size_t inlen));
1355
1356 void EVP_PKEY_meth_set_derive(EVP_PKEY_METHOD *pmeth,
1357 int (*derive_init) (EVP_PKEY_CTX *ctx),
1358 int (*derive) (EVP_PKEY_CTX *ctx,
1359 unsigned char *key,
1360 size_t *keylen));
1361
1362 void EVP_PKEY_meth_set_ctrl(EVP_PKEY_METHOD *pmeth,
1363 int (*ctrl) (EVP_PKEY_CTX *ctx, int type, int p1,
1364 void *p2),
1365 int (*ctrl_str) (EVP_PKEY_CTX *ctx,
1366 const char *type,
1367 const char *value));
1368
1369 void EVP_PKEY_meth_get_init(EVP_PKEY_METHOD *pmeth,
1370 int (**pinit) (EVP_PKEY_CTX *ctx));
1371
1372 void EVP_PKEY_meth_get_copy(EVP_PKEY_METHOD *pmeth,
1373 int (**pcopy) (EVP_PKEY_CTX *dst,
1374 EVP_PKEY_CTX *src));
1375
1376 void EVP_PKEY_meth_get_cleanup(EVP_PKEY_METHOD *pmeth,
1377 void (**pcleanup) (EVP_PKEY_CTX *ctx));
1378
1379 void EVP_PKEY_meth_get_paramgen(EVP_PKEY_METHOD *pmeth,
1380 int (**pparamgen_init) (EVP_PKEY_CTX *ctx),
1381 int (**pparamgen) (EVP_PKEY_CTX *ctx,
1382 EVP_PKEY *pkey));
1383
1384 void EVP_PKEY_meth_get_keygen(EVP_PKEY_METHOD *pmeth,
1385 int (**pkeygen_init) (EVP_PKEY_CTX *ctx),
1386 int (**pkeygen) (EVP_PKEY_CTX *ctx,
1387 EVP_PKEY *pkey));
1388
1389 void EVP_PKEY_meth_get_sign(EVP_PKEY_METHOD *pmeth,
1390 int (**psign_init) (EVP_PKEY_CTX *ctx),
1391 int (**psign) (EVP_PKEY_CTX *ctx,
1392 unsigned char *sig, size_t *siglen,
1393 const unsigned char *tbs,
1394 size_t tbslen));
1395
1396 void EVP_PKEY_meth_get_verify(EVP_PKEY_METHOD *pmeth,
1397 int (**pverify_init) (EVP_PKEY_CTX *ctx),
1398 int (**pverify) (EVP_PKEY_CTX *ctx,
1399 const unsigned char *sig,
1400 size_t siglen,
1401 const unsigned char *tbs,
1402 size_t tbslen));
1403
1404 void EVP_PKEY_meth_get_verify_recover(EVP_PKEY_METHOD *pmeth,
1405 int (**pverify_recover_init) (EVP_PKEY_CTX
1406 *ctx),
1407 int (**pverify_recover) (EVP_PKEY_CTX
1408 *ctx,
1409 unsigned char
1410 *sig,
1411 size_t *siglen,
1412 const unsigned
1413 char *tbs,
1414 size_t tbslen));
1415
1416 void EVP_PKEY_meth_get_signctx(EVP_PKEY_METHOD *pmeth,
1417 int (**psignctx_init) (EVP_PKEY_CTX *ctx,
1418 EVP_MD_CTX *mctx),
1419 int (**psignctx) (EVP_PKEY_CTX *ctx,
1420 unsigned char *sig,
1421 size_t *siglen,
1422 EVP_MD_CTX *mctx));
1423
1424 void EVP_PKEY_meth_get_verifyctx(EVP_PKEY_METHOD *pmeth,
1425 int (**pverifyctx_init) (EVP_PKEY_CTX *ctx,
1426 EVP_MD_CTX *mctx),
1427 int (**pverifyctx) (EVP_PKEY_CTX *ctx,
1428 const unsigned char *sig,
1429 int siglen,
1430 EVP_MD_CTX *mctx));
1431
1432 void EVP_PKEY_meth_get_encrypt(EVP_PKEY_METHOD *pmeth,
1433 int (**pencrypt_init) (EVP_PKEY_CTX *ctx),
1434 int (**pencryptfn) (EVP_PKEY_CTX *ctx,
1435 unsigned char *out,
1436 size_t *outlen,
1437 const unsigned char *in,
1438 size_t inlen));
1439
1440 void EVP_PKEY_meth_get_decrypt(EVP_PKEY_METHOD *pmeth,
1441 int (**pdecrypt_init) (EVP_PKEY_CTX *ctx),
1442 int (**pdecrypt) (EVP_PKEY_CTX *ctx,
1443 unsigned char *out,
1444 size_t *outlen,
1445 const unsigned char *in,
1446 size_t inlen));
1447
1448 void EVP_PKEY_meth_get_derive(EVP_PKEY_METHOD *pmeth,
1449 int (**pderive_init) (EVP_PKEY_CTX *ctx),
1450 int (**pderive) (EVP_PKEY_CTX *ctx,
1451 unsigned char *key,
1452 size_t *keylen));
1453
1454 void EVP_PKEY_meth_get_ctrl(EVP_PKEY_METHOD *pmeth,
1455 int (**pctrl) (EVP_PKEY_CTX *ctx, int type, int p1,
1456 void *p2),
1457 int (**pctrl_str) (EVP_PKEY_CTX *ctx,
1458 const char *type,
1459 const char *value));
1460
1461 void EVP_add_alg_module(void);
1462
1463 /* BEGIN ERROR CODES */
1464 /*
1465 * The following lines are auto generated by the script mkerr.pl. Any changes
1466 * made after this point may be overwritten when the script is next run.
1467 */
1468 void ERR_load_EVP_strings(void);
1469
1470 /* Error codes for the EVP functions. */
1471
1472 /* Function codes. */
1473 # define EVP_F_AESNI_INIT_KEY 165
1474 # define EVP_F_AESNI_XTS_CIPHER 176
1475 # define EVP_F_AES_INIT_KEY 133
1476 # define EVP_F_AES_T4_INIT_KEY 178
1477 # define EVP_F_AES_XTS 172
1478 # define EVP_F_AES_XTS_CIPHER 175
1479 # define EVP_F_ALG_MODULE_INIT 177
1480 # define EVP_F_CAMELLIA_INIT_KEY 159
1481 # define EVP_F_CHACHA20_POLY1305_CTRL 182
1482 # define EVP_F_CMAC_INIT 173
1483 # define EVP_F_CMLL_T4_INIT_KEY 179
1484 # define EVP_F_D2I_PKEY 100
1485 # define EVP_F_DO_SIGVER_INIT 161
1486 # define EVP_F_DSAPKEY2PKCS8 134
1487 # define EVP_F_DSA_PKEY2PKCS8 135
1488 # define EVP_F_ECDSA_PKEY2PKCS8 129
1489 # define EVP_F_ECKEY_PKEY2PKCS8 132
1490 # define EVP_F_EVP_CIPHERINIT_EX 123
1491 # define EVP_F_EVP_CIPHER_CTX_COPY 163
1492 # define EVP_F_EVP_CIPHER_CTX_CTRL 124
1493 # define EVP_F_EVP_CIPHER_CTX_SET_KEY_LENGTH 122
1494 # define EVP_F_EVP_DECRYPTFINAL_EX 101
1495 # define EVP_F_EVP_DIGESTINIT_EX 128
1496 # define EVP_F_EVP_ENCRYPTFINAL_EX 127
1497 # define EVP_F_EVP_MD_CTX_COPY_EX 110
1498 # define EVP_F_EVP_MD_SIZE 162
1499 # define EVP_F_EVP_OPENINIT 102
1500 # define EVP_F_EVP_PBE_ALG_ADD 115
1501 # define EVP_F_EVP_PBE_ALG_ADD_TYPE 160
1502 # define EVP_F_EVP_PBE_CIPHERINIT 116
1503 # define EVP_F_EVP_PBE_SCRYPT 181
1504 # define EVP_F_EVP_PKCS82PKEY 111
1505 # define EVP_F_EVP_PKCS82PKEY_BROKEN 136
1506 # define EVP_F_EVP_PKEY2PKCS8_BROKEN 113
1507 # define EVP_F_EVP_PKEY_COPY_PARAMETERS 103
1508 # define EVP_F_EVP_PKEY_CTX_CTRL 137
1509 # define EVP_F_EVP_PKEY_CTX_CTRL_STR 150
1510 # define EVP_F_EVP_PKEY_CTX_DUP 156
1511 # define EVP_F_EVP_PKEY_DECRYPT 104
1512 # define EVP_F_EVP_PKEY_DECRYPT_INIT 138
1513 # define EVP_F_EVP_PKEY_DECRYPT_OLD 151
1514 # define EVP_F_EVP_PKEY_DERIVE 153
1515 # define EVP_F_EVP_PKEY_DERIVE_INIT 154
1516 # define EVP_F_EVP_PKEY_DERIVE_SET_PEER 155
1517 # define EVP_F_EVP_PKEY_ENCRYPT 105
1518 # define EVP_F_EVP_PKEY_ENCRYPT_INIT 139
1519 # define EVP_F_EVP_PKEY_ENCRYPT_OLD 152
1520 # define EVP_F_EVP_PKEY_GET0_DH 119
1521 # define EVP_F_EVP_PKEY_GET0_DSA 120
1522 # define EVP_F_EVP_PKEY_GET0_ECDSA 130
1523 # define EVP_F_EVP_PKEY_GET0_EC_KEY 131
1524 # define EVP_F_EVP_PKEY_GET0_RSA 121
1525 # define EVP_F_EVP_PKEY_KEYGEN 146
1526 # define EVP_F_EVP_PKEY_KEYGEN_INIT 147
1527 # define EVP_F_EVP_PKEY_NEW 106
1528 # define EVP_F_EVP_PKEY_PARAMGEN 148
1529 # define EVP_F_EVP_PKEY_PARAMGEN_INIT 149
1530 # define EVP_F_EVP_PKEY_SIGN 140
1531 # define EVP_F_EVP_PKEY_SIGN_INIT 141
1532 # define EVP_F_EVP_PKEY_VERIFY 142
1533 # define EVP_F_EVP_PKEY_VERIFY_INIT 143
1534 # define EVP_F_EVP_PKEY_VERIFY_RECOVER 144
1535 # define EVP_F_EVP_PKEY_VERIFY_RECOVER_INIT 145
1536 # define EVP_F_EVP_RIJNDAEL 126
1537 # define EVP_F_EVP_SIGNFINAL 107
1538 # define EVP_F_EVP_VERIFYFINAL 108
1539 # define EVP_F_FIPS_CIPHERINIT 166
1540 # define EVP_F_FIPS_CIPHER_CTX_COPY 170
1541 # define EVP_F_FIPS_CIPHER_CTX_CTRL 167
1542 # define EVP_F_FIPS_CIPHER_CTX_SET_KEY_LENGTH 171
1543 # define EVP_F_FIPS_DIGESTINIT 168
1544 # define EVP_F_FIPS_MD_CTX_COPY 169
1545 # define EVP_F_HMAC_INIT_EX 174
1546 # define EVP_F_INT_CTX_NEW 157
1547 # define EVP_F_PKCS5_PBE_KEYIVGEN 117
1548 # define EVP_F_PKCS5_V2_PBE_KEYIVGEN 118
1549 # define EVP_F_PKCS5_V2_PBKDF2_KEYIVGEN 164
1550 # define EVP_F_PKCS5_V2_SCRYPT_KEYIVGEN 180
1551 # define EVP_F_PKCS8_SET_BROKEN 112
1552 # define EVP_F_PKEY_SET_TYPE 158
1553 # define EVP_F_RC2_MAGIC_TO_METH 109
1554 # define EVP_F_RC5_CTRL 125
1555
1556 /* Reason codes. */
1557 # define EVP_R_AES_IV_SETUP_FAILED 162
1558 # define EVP_R_AES_KEY_SETUP_FAILED 143
1559 # define EVP_R_ASN1_LIB 140
1560 # define EVP_R_BAD_BLOCK_LENGTH 136
1561 # define EVP_R_BAD_DECRYPT 100
1562 # define EVP_R_BAD_KEY_LENGTH 137
1563 # define EVP_R_BN_DECODE_ERROR 112
1564 # define EVP_R_BN_PUBKEY_ERROR 113
1565 # define EVP_R_BUFFER_TOO_SMALL 155
1566 # define EVP_R_CAMELLIA_KEY_SETUP_FAILED 157
1567 # define EVP_R_CIPHER_PARAMETER_ERROR 122
1568 # define EVP_R_COMMAND_NOT_SUPPORTED 147
1569 # define EVP_R_COPY_ERROR 173
1570 # define EVP_R_CTRL_NOT_IMPLEMENTED 132
1571 # define EVP_R_CTRL_OPERATION_NOT_IMPLEMENTED 133
1572 # define EVP_R_DATA_NOT_MULTIPLE_OF_BLOCK_LENGTH 138
1573 # define EVP_R_DECODE_ERROR 114
1574 # define EVP_R_DIFFERENT_KEY_TYPES 101
1575 # define EVP_R_DIFFERENT_PARAMETERS 153
1576 # define EVP_R_DISABLED_FOR_FIPS 163
1577 # define EVP_R_ENCODE_ERROR 115
1578 # define EVP_R_ERROR_LOADING_SECTION 165
1579 # define EVP_R_ERROR_SETTING_FIPS_MODE 166
1580 # define EVP_R_EVP_PBE_CIPHERINIT_ERROR 119
1581 # define EVP_R_EXPECTING_AN_RSA_KEY 127
1582 # define EVP_R_EXPECTING_A_DH_KEY 128
1583 # define EVP_R_EXPECTING_A_DSA_KEY 129
1584 # define EVP_R_EXPECTING_A_ECDSA_KEY 141
1585 # define EVP_R_EXPECTING_A_EC_KEY 142
1586 # define EVP_R_FIPS_MODE_NOT_SUPPORTED 167
1587 # define EVP_R_ILLEGAL_SCRYPT_PARAMETERS 171
1588 # define EVP_R_INITIALIZATION_ERROR 134
1589 # define EVP_R_INPUT_NOT_INITIALIZED 111
1590 # define EVP_R_INVALID_DIGEST 152
1591 # define EVP_R_INVALID_FIPS_MODE 168
1592 # define EVP_R_INVALID_KEY_LENGTH 130
1593 # define EVP_R_INVALID_OPERATION 148
1594 # define EVP_R_IV_TOO_LARGE 102
1595 # define EVP_R_KEYGEN_FAILURE 120
1596 # define EVP_R_MEMORY_LIMIT_EXCEEDED 172
1597 # define EVP_R_MESSAGE_DIGEST_IS_NULL 159
1598 # define EVP_R_METHOD_NOT_SUPPORTED 144
1599 # define EVP_R_MISSING_PARAMETERS 103
1600 # define EVP_R_NO_CIPHER_SET 131
1601 # define EVP_R_NO_DEFAULT_DIGEST 158
1602 # define EVP_R_NO_DIGEST_SET 139
1603 # define EVP_R_NO_DSA_PARAMETERS 116
1604 # define EVP_R_NO_KEY_SET 154
1605 # define EVP_R_NO_OPERATION_SET 149
1606 # define EVP_R_NO_SIGN_FUNCTION_CONFIGURED 104
1607 # define EVP_R_NO_VERIFY_FUNCTION_CONFIGURED 105
1608 # define EVP_R_OPERATION_NOT_SUPPORTED_FOR_THIS_KEYTYPE 150
1609 # define EVP_R_OPERATON_NOT_INITIALIZED 151
1610 # define EVP_R_PKCS8_UNKNOWN_BROKEN_TYPE 117
1611 # define EVP_R_PRIVATE_KEY_DECODE_ERROR 145
1612 # define EVP_R_PRIVATE_KEY_ENCODE_ERROR 146
1613 # define EVP_R_PUBLIC_KEY_NOT_RSA 106
1614 # define EVP_R_TOO_LARGE 164
1615 # define EVP_R_UNKNOWN_CIPHER 160
1616 # define EVP_R_UNKNOWN_DIGEST 161
1617 # define EVP_R_UNKNOWN_OPTION 169
1618 # define EVP_R_UNKNOWN_PBE_ALGORITHM 121
1619 # define EVP_R_UNSUPORTED_NUMBER_OF_ROUNDS 135
1620 # define EVP_R_UNSUPPORTED_ALGORITHM 156
1621 # define EVP_R_UNSUPPORTED_CIPHER 107
1622 # define EVP_R_UNSUPPORTED_KEYLENGTH 123
1623 # define EVP_R_UNSUPPORTED_KEY_DERIVATION_FUNCTION 124
1624 # define EVP_R_UNSUPPORTED_KEY_SIZE 108
1625 # define EVP_R_UNSUPPORTED_PRF 125
1626 # define EVP_R_UNSUPPORTED_PRIVATE_KEY_ALGORITHM 118
1627 # define EVP_R_UNSUPPORTED_SALT_TYPE 126
1628 # define EVP_R_WRAP_MODE_NOT_ALLOWED 170
1629 # define EVP_R_WRONG_FINAL_BLOCK_LENGTH 109
1630 # define EVP_R_WRONG_PUBLIC_KEY_TYPE 110
1631
1632 #ifdef __cplusplus
1633 }
1634 #endif
1635 #endif