]>
Commit | Line | Data |
---|---|---|
d02b48c6 | 1 | /* crypto/crypto.h */ |
19b8d06a | 2 | /* ==================================================================== |
48fc582f | 3 | * Copyright (c) 1998-2006 The OpenSSL Project. All rights reserved. |
19b8d06a BM |
4 | * |
5 | * Redistribution and use in source and binary forms, with or without | |
6 | * modification, are permitted provided that the following conditions | |
7 | * are met: | |
8 | * | |
9 | * 1. Redistributions of source code must retain the above copyright | |
ae5c8664 | 10 | * notice, this list of conditions and the following disclaimer. |
19b8d06a BM |
11 | * |
12 | * 2. Redistributions in binary form must reproduce the above copyright | |
13 | * notice, this list of conditions and the following disclaimer in | |
14 | * the documentation and/or other materials provided with the | |
15 | * distribution. | |
16 | * | |
17 | * 3. All advertising materials mentioning features or use of this | |
18 | * software must display the following acknowledgment: | |
19 | * "This product includes software developed by the OpenSSL Project | |
20 | * for use in the OpenSSL Toolkit. (http://www.openssl.org/)" | |
21 | * | |
22 | * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to | |
23 | * endorse or promote products derived from this software without | |
24 | * prior written permission. For written permission, please contact | |
25 | * openssl-core@openssl.org. | |
26 | * | |
27 | * 5. Products derived from this software may not be called "OpenSSL" | |
28 | * nor may "OpenSSL" appear in their names without prior written | |
29 | * permission of the OpenSSL Project. | |
30 | * | |
31 | * 6. Redistributions of any form whatsoever must retain the following | |
32 | * acknowledgment: | |
33 | * "This product includes software developed by the OpenSSL Project | |
34 | * for use in the OpenSSL Toolkit (http://www.openssl.org/)" | |
35 | * | |
36 | * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY | |
37 | * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
38 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | |
39 | * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR | |
40 | * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
41 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | |
42 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; | |
43 | * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
44 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, | |
45 | * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | |
46 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED | |
47 | * OF THE POSSIBILITY OF SUCH DAMAGE. | |
48 | * ==================================================================== | |
49 | * | |
50 | * This product includes cryptographic software written by Eric Young | |
51 | * (eay@cryptsoft.com). This product includes software written by Tim | |
52 | * Hudson (tjh@cryptsoft.com). | |
53 | * | |
54 | */ | |
58964a49 | 55 | /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) |
d02b48c6 RE |
56 | * All rights reserved. |
57 | * | |
58 | * This package is an SSL implementation written | |
59 | * by Eric Young (eay@cryptsoft.com). | |
60 | * The implementation was written so as to conform with Netscapes SSL. | |
ae5c8664 | 61 | * |
d02b48c6 RE |
62 | * This library is free for commercial and non-commercial use as long as |
63 | * the following conditions are aheared to. The following conditions | |
64 | * apply to all code found in this distribution, be it the RC4, RSA, | |
65 | * lhash, DES, etc., code; not just the SSL code. The SSL documentation | |
66 | * included with this distribution is covered by the same copyright terms | |
67 | * except that the holder is Tim Hudson (tjh@cryptsoft.com). | |
ae5c8664 | 68 | * |
d02b48c6 RE |
69 | * Copyright remains Eric Young's, and as such any Copyright notices in |
70 | * the code are not to be removed. | |
71 | * If this package is used in a product, Eric Young should be given attribution | |
72 | * as the author of the parts of the library used. | |
73 | * This can be in the form of a textual message at program startup or | |
74 | * in documentation (online or textual) provided with the package. | |
ae5c8664 | 75 | * |
d02b48c6 RE |
76 | * Redistribution and use in source and binary forms, with or without |
77 | * modification, are permitted provided that the following conditions | |
78 | * are met: | |
79 | * 1. Redistributions of source code must retain the copyright | |
80 | * notice, this list of conditions and the following disclaimer. | |
81 | * 2. Redistributions in binary form must reproduce the above copyright | |
82 | * notice, this list of conditions and the following disclaimer in the | |
83 | * documentation and/or other materials provided with the distribution. | |
84 | * 3. All advertising materials mentioning features or use of this software | |
85 | * must display the following acknowledgement: | |
86 | * "This product includes cryptographic software written by | |
87 | * Eric Young (eay@cryptsoft.com)" | |
88 | * The word 'cryptographic' can be left out if the rouines from the library | |
89 | * being used are not cryptographic related :-). | |
ae5c8664 | 90 | * 4. If you include any Windows specific code (or a derivative thereof) from |
d02b48c6 RE |
91 | * the apps directory (application code) you must include an acknowledgement: |
92 | * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" | |
ae5c8664 | 93 | * |
d02b48c6 RE |
94 | * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND |
95 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
96 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
97 | * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | |
98 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
99 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
100 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
101 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
102 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
103 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
104 | * SUCH DAMAGE. | |
ae5c8664 | 105 | * |
d02b48c6 RE |
106 | * The licence and distribution terms for any publically available version or |
107 | * derivative of this code cannot be changed. i.e. this code cannot simply be | |
108 | * copied and put under another distribution licence | |
109 | * [including the GNU Public Licence.] | |
110 | */ | |
e172d60d BM |
111 | /* ==================================================================== |
112 | * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED. | |
ae5c8664 | 113 | * ECDH support in OpenSSL originally developed by |
e172d60d BM |
114 | * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project. |
115 | */ | |
d02b48c6 RE |
116 | |
117 | #ifndef HEADER_CRYPTO_H | |
ae5c8664 | 118 | # define HEADER_CRYPTO_H |
d02b48c6 | 119 | |
ae5c8664 | 120 | # include <stdlib.h> |
f3e9b338 | 121 | |
ae5c8664 | 122 | # include <openssl/e_os2.h> |
7b5a6c7a | 123 | |
ae5c8664 MC |
124 | # ifndef OPENSSL_NO_FP_API |
125 | # include <stdio.h> | |
126 | # endif | |
0b86eb3e | 127 | |
ae5c8664 MC |
128 | # include <openssl/stack.h> |
129 | # include <openssl/safestack.h> | |
130 | # include <openssl/opensslv.h> | |
131 | # include <openssl/ossl_typ.h> | |
5f326803 | 132 | |
ae5c8664 MC |
133 | # ifdef CHARSET_EBCDIC |
134 | # include <openssl/ebcdic.h> | |
135 | # endif | |
a53955d8 | 136 | |
ae5c8664 MC |
137 | /* |
138 | * Resolve problems on some operating systems with symbol names that clash | |
139 | * one way or another | |
140 | */ | |
141 | # include <openssl/symhacks.h> | |
c29b6d56 | 142 | |
65962686 RL |
143 | #ifdef __cplusplus |
144 | extern "C" { | |
145 | #endif | |
146 | ||
5f326803 | 147 | /* Backward compatibility to SSLeay */ |
ae5c8664 MC |
148 | /* |
149 | * This is more to be used to check the correct DLL is being used in the MS | |
150 | * world. | |
151 | */ | |
152 | # define SSLEAY_VERSION_NUMBER OPENSSL_VERSION_NUMBER | |
153 | # define SSLEAY_VERSION 0 | |
154 | /* #define SSLEAY_OPTIONS 1 no longer supported */ | |
155 | # define SSLEAY_CFLAGS 2 | |
156 | # define SSLEAY_BUILT_ON 3 | |
157 | # define SSLEAY_PLATFORM 4 | |
158 | # define SSLEAY_DIR 5 | |
d02b48c6 | 159 | |
210a21bc | 160 | /* Already declared in ossl_typ.h */ |
ae5c8664 | 161 | # if 0 |
210a21bc GT |
162 | typedef struct crypto_ex_data_st CRYPTO_EX_DATA; |
163 | /* Called when a new object is created */ | |
ae5c8664 MC |
164 | typedef int CRYPTO_EX_new (void *parent, void *ptr, CRYPTO_EX_DATA *ad, |
165 | int idx, long argl, void *argp); | |
210a21bc | 166 | /* Called when an object is free()ed */ |
ae5c8664 MC |
167 | typedef void CRYPTO_EX_free (void *parent, void *ptr, CRYPTO_EX_DATA *ad, |
168 | int idx, long argl, void *argp); | |
210a21bc | 169 | /* Called when we need to dup an object */ |
ae5c8664 MC |
170 | typedef int CRYPTO_EX_dup (CRYPTO_EX_DATA *to, CRYPTO_EX_DATA *from, |
171 | void *from_d, int idx, long argl, void *argp); | |
172 | # endif | |
210a21bc | 173 | |
535fba49 | 174 | /* A generic structure to pass assorted data in a expandable way */ |
ae5c8664 MC |
175 | typedef struct openssl_item_st { |
176 | int code; | |
177 | void *value; /* Not used for flag attributes */ | |
178 | size_t value_size; /* Max size of value for output, length for | |
179 | * input */ | |
180 | size_t *value_length; /* Returned length of value for output */ | |
181 | } OPENSSL_ITEM; | |
182 | ||
183 | /* | |
184 | * When changing the CRYPTO_LOCK_* list, be sure to maintin the text lock | |
d02b48c6 RE |
185 | * names in cryptlib.c |
186 | */ | |
187 | ||
ae5c8664 MC |
188 | # define CRYPTO_LOCK_ERR 1 |
189 | # define CRYPTO_LOCK_EX_DATA 2 | |
190 | # define CRYPTO_LOCK_X509 3 | |
191 | # define CRYPTO_LOCK_X509_INFO 4 | |
192 | # define CRYPTO_LOCK_X509_PKEY 5 | |
193 | # define CRYPTO_LOCK_X509_CRL 6 | |
194 | # define CRYPTO_LOCK_X509_REQ 7 | |
195 | # define CRYPTO_LOCK_DSA 8 | |
196 | # define CRYPTO_LOCK_RSA 9 | |
197 | # define CRYPTO_LOCK_EVP_PKEY 10 | |
198 | # define CRYPTO_LOCK_X509_STORE 11 | |
199 | # define CRYPTO_LOCK_SSL_CTX 12 | |
200 | # define CRYPTO_LOCK_SSL_CERT 13 | |
201 | # define CRYPTO_LOCK_SSL_SESSION 14 | |
202 | # define CRYPTO_LOCK_SSL_SESS_CERT 15 | |
203 | # define CRYPTO_LOCK_SSL 16 | |
204 | # define CRYPTO_LOCK_SSL_METHOD 17 | |
205 | # define CRYPTO_LOCK_RAND 18 | |
206 | # define CRYPTO_LOCK_RAND2 19 | |
207 | # define CRYPTO_LOCK_MALLOC 20 | |
208 | # define CRYPTO_LOCK_BIO 21 | |
209 | # define CRYPTO_LOCK_GETHOSTBYNAME 22 | |
210 | # define CRYPTO_LOCK_GETSERVBYNAME 23 | |
211 | # define CRYPTO_LOCK_READDIR 24 | |
212 | # define CRYPTO_LOCK_RSA_BLINDING 25 | |
213 | # define CRYPTO_LOCK_DH 26 | |
214 | # define CRYPTO_LOCK_MALLOC2 27 | |
215 | # define CRYPTO_LOCK_DSO 28 | |
216 | # define CRYPTO_LOCK_DYNLOCK 29 | |
217 | # define CRYPTO_LOCK_ENGINE 30 | |
218 | # define CRYPTO_LOCK_UI 31 | |
219 | # define CRYPTO_LOCK_ECDSA 32 | |
220 | # define CRYPTO_LOCK_EC 33 | |
221 | # define CRYPTO_LOCK_ECDH 34 | |
222 | # define CRYPTO_LOCK_BN 35 | |
223 | # define CRYPTO_LOCK_EC_PRE_COMP 36 | |
224 | # define CRYPTO_LOCK_STORE 37 | |
225 | # define CRYPTO_LOCK_COMP 38 | |
226 | # define CRYPTO_LOCK_FIPS 39 | |
227 | # define CRYPTO_LOCK_FIPS2 40 | |
228 | # define CRYPTO_NUM_LOCKS 41 | |
229 | ||
230 | # define CRYPTO_LOCK 1 | |
231 | # define CRYPTO_UNLOCK 2 | |
232 | # define CRYPTO_READ 4 | |
233 | # define CRYPTO_WRITE 8 | |
234 | ||
235 | # ifndef OPENSSL_NO_LOCKING | |
236 | # ifndef CRYPTO_w_lock | |
237 | # define CRYPTO_w_lock(type) \ | |
238 | CRYPTO_lock(CRYPTO_LOCK|CRYPTO_WRITE,type,__FILE__,__LINE__) | |
239 | # define CRYPTO_w_unlock(type) \ | |
240 | CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_WRITE,type,__FILE__,__LINE__) | |
241 | # define CRYPTO_r_lock(type) \ | |
242 | CRYPTO_lock(CRYPTO_LOCK|CRYPTO_READ,type,__FILE__,__LINE__) | |
243 | # define CRYPTO_r_unlock(type) \ | |
244 | CRYPTO_lock(CRYPTO_UNLOCK|CRYPTO_READ,type,__FILE__,__LINE__) | |
245 | # define CRYPTO_add(addr,amount,type) \ | |
246 | CRYPTO_add_lock(addr,amount,type,__FILE__,__LINE__) | |
247 | # endif | |
248 | # else | |
249 | # define CRYPTO_w_lock(a) | |
250 | # define CRYPTO_w_unlock(a) | |
251 | # define CRYPTO_r_lock(a) | |
252 | # define CRYPTO_r_unlock(a) | |
253 | # define CRYPTO_add(a,b,c) ((*(a))+=(b)) | |
254 | # endif | |
d02b48c6 | 255 | |
ae5c8664 MC |
256 | /* |
257 | * Some applications as well as some parts of OpenSSL need to allocate and | |
258 | * deallocate locks in a dynamic fashion. The following typedef makes this | |
259 | * possible in a type-safe manner. | |
260 | */ | |
e73a6965 | 261 | /* struct CRYPTO_dynlock_value has to be defined by the application. */ |
ae5c8664 MC |
262 | typedef struct { |
263 | int references; | |
264 | struct CRYPTO_dynlock_value *data; | |
265 | } CRYPTO_dynlock; | |
266 | ||
267 | /* | |
268 | * The following can be used to detect memory leaks in the SSLeay library. It | |
269 | * used, it turns on malloc checking | |
270 | */ | |
d02b48c6 | 271 | |
ae5c8664 MC |
272 | # define CRYPTO_MEM_CHECK_OFF 0x0/* an enume */ |
273 | # define CRYPTO_MEM_CHECK_ON 0x1/* a bit */ | |
274 | # define CRYPTO_MEM_CHECK_ENABLE 0x2/* a bit */ | |
275 | # define CRYPTO_MEM_CHECK_DISABLE 0x3/* an enume */ | |
d02b48c6 | 276 | |
ae5c8664 MC |
277 | /* |
278 | * The following are bit values to turn on or off options connected to the | |
279 | * malloc checking functionality | |
280 | */ | |
d8df48a9 RL |
281 | |
282 | /* Adds time to the memory checking information */ | |
ae5c8664 | 283 | # define V_CRYPTO_MDEBUG_TIME 0x1/* a bit */ |
d8df48a9 | 284 | /* Adds thread number to the memory checking information */ |
ae5c8664 | 285 | # define V_CRYPTO_MDEBUG_THREAD 0x2/* a bit */ |
b64e735b | 286 | |
ae5c8664 | 287 | # define V_CRYPTO_MDEBUG_ALL (V_CRYPTO_MDEBUG_TIME | V_CRYPTO_MDEBUG_THREAD) |
d02b48c6 | 288 | |
58964a49 RE |
289 | /* predec of the BIO type */ |
290 | typedef struct bio_st BIO_dummy; | |
291 | ||
ae5c8664 MC |
292 | struct crypto_ex_data_st { |
293 | STACK_OF(void) *sk; | |
294 | /* gcc is screwing up this data structure :-( */ | |
295 | int dummy; | |
296 | }; | |
5ce278a7 | 297 | DECLARE_STACK_OF(void) |
dd9d233e | 298 | |
ae5c8664 MC |
299 | /* |
300 | * This stuff is basically class callback functions The current classes are | |
301 | * SSL_CTX, SSL, SSL_SESSION, and a few more | |
302 | */ | |
dd9d233e | 303 | |
ae5c8664 MC |
304 | typedef struct crypto_ex_data_func_st { |
305 | long argl; /* Arbitary long */ | |
306 | void *argp; /* Arbitary void * */ | |
307 | CRYPTO_EX_new *new_func; | |
308 | CRYPTO_EX_free *free_func; | |
309 | CRYPTO_EX_dup *dup_func; | |
310 | } CRYPTO_EX_DATA_FUNCS; | |
58964a49 | 311 | |
dd9d233e DSH |
312 | DECLARE_STACK_OF(CRYPTO_EX_DATA_FUNCS) |
313 | ||
ae5c8664 MC |
314 | /* |
315 | * Per class, we have a STACK of CRYPTO_EX_DATA_FUNCS for each CRYPTO_EX_DATA | |
58964a49 RE |
316 | * entry. |
317 | */ | |
318 | ||
ae5c8664 MC |
319 | # define CRYPTO_EX_INDEX_BIO 0 |
320 | # define CRYPTO_EX_INDEX_SSL 1 | |
321 | # define CRYPTO_EX_INDEX_SSL_CTX 2 | |
322 | # define CRYPTO_EX_INDEX_SSL_SESSION 3 | |
323 | # define CRYPTO_EX_INDEX_X509_STORE 4 | |
324 | # define CRYPTO_EX_INDEX_X509_STORE_CTX 5 | |
325 | # define CRYPTO_EX_INDEX_RSA 6 | |
326 | # define CRYPTO_EX_INDEX_DSA 7 | |
327 | # define CRYPTO_EX_INDEX_DH 8 | |
328 | # define CRYPTO_EX_INDEX_ENGINE 9 | |
329 | # define CRYPTO_EX_INDEX_X509 10 | |
330 | # define CRYPTO_EX_INDEX_UI 11 | |
331 | # define CRYPTO_EX_INDEX_ECDSA 12 | |
332 | # define CRYPTO_EX_INDEX_ECDH 13 | |
333 | # define CRYPTO_EX_INDEX_COMP 14 | |
334 | # define CRYPTO_EX_INDEX_STORE 15 | |
335 | ||
336 | /* | |
337 | * Dynamically assigned indexes start from this value (don't use directly, | |
338 | * use via CRYPTO_ex_data_new_class). | |
3d14b9d0 | 339 | */ |
ae5c8664 | 340 | # define CRYPTO_EX_INDEX_USER 100 |
0cd08cce | 341 | |
ae5c8664 MC |
342 | /* |
343 | * This is the default callbacks, but we can have others as well: this is | |
344 | * needed in Win32 where the application malloc and the library malloc may | |
345 | * not be the same. | |
346 | */ | |
347 | # define CRYPTO_malloc_init() CRYPTO_set_mem_functions(\ | |
348 | malloc, realloc, free) | |
349 | ||
350 | # if defined CRYPTO_MDEBUG_ALL || defined CRYPTO_MDEBUG_TIME || defined CRYPTO_MDEBUG_THREAD | |
351 | # ifndef CRYPTO_MDEBUG /* avoid duplicate #define */ | |
352 | # define CRYPTO_MDEBUG | |
353 | # endif | |
0cd08cce | 354 | # endif |
d02b48c6 | 355 | |
ae5c8664 MC |
356 | /* |
357 | * Set standard debugging functions (not done by default unless CRYPTO_MDEBUG | |
358 | * is defined) | |
359 | */ | |
360 | # define CRYPTO_malloc_debug_init() do {\ | |
361 | CRYPTO_set_mem_debug_functions(\ | |
362 | CRYPTO_dbg_malloc,\ | |
363 | CRYPTO_dbg_realloc,\ | |
364 | CRYPTO_dbg_free,\ | |
365 | CRYPTO_dbg_set_options,\ | |
366 | CRYPTO_dbg_get_options);\ | |
367 | } while(0) | |
9ac42ed8 | 368 | |
0cd08cce BM |
369 | int CRYPTO_mem_ctrl(int mode); |
370 | int CRYPTO_is_mem_check_on(void); | |
458cddc1 | 371 | |
0cd08cce | 372 | /* for applications */ |
ae5c8664 MC |
373 | # define MemCheck_start() CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ON) |
374 | # define MemCheck_stop() CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_OFF) | |
0cd08cce BM |
375 | |
376 | /* for library-internal use */ | |
ae5c8664 MC |
377 | # define MemCheck_on() CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_ENABLE) |
378 | # define MemCheck_off() CRYPTO_mem_ctrl(CRYPTO_MEM_CHECK_DISABLE) | |
379 | # define is_MemCheck_on() CRYPTO_is_mem_check_on() | |
380 | ||
381 | # define OPENSSL_malloc(num) CRYPTO_malloc((int)num,__FILE__,__LINE__) | |
382 | # define OPENSSL_strdup(str) CRYPTO_strdup((str),__FILE__,__LINE__) | |
383 | # define OPENSSL_realloc(addr,num) \ | |
384 | CRYPTO_realloc((char *)addr,(int)num,__FILE__,__LINE__) | |
385 | # define OPENSSL_realloc_clean(addr,old_num,num) \ | |
386 | CRYPTO_realloc_clean(addr,old_num,num,__FILE__,__LINE__) | |
387 | # define OPENSSL_remalloc(addr,num) \ | |
388 | CRYPTO_remalloc((char **)addr,(int)num,__FILE__,__LINE__) | |
389 | # define OPENSSL_freeFunc CRYPTO_free | |
390 | # define OPENSSL_free(addr) CRYPTO_free(addr) | |
391 | ||
392 | # define OPENSSL_malloc_locked(num) \ | |
393 | CRYPTO_malloc_locked((int)num,__FILE__,__LINE__) | |
394 | # define OPENSSL_free_locked(addr) CRYPTO_free_locked(addr) | |
d02b48c6 | 395 | |
e778802f | 396 | const char *SSLeay_version(int type); |
d02b48c6 RE |
397 | unsigned long SSLeay(void); |
398 | ||
36fafffa UM |
399 | int OPENSSL_issetugid(void); |
400 | ||
3a079997 | 401 | /* An opaque type representing an implementation of "ex_data" support */ |
ae5c8664 | 402 | typedef struct st_CRYPTO_EX_DATA_IMPL CRYPTO_EX_DATA_IMPL; |
3a079997 GT |
403 | /* Return an opaque pointer to the current "ex_data" implementation */ |
404 | const CRYPTO_EX_DATA_IMPL *CRYPTO_get_ex_data_implementation(void); | |
405 | /* Sets the "ex_data" implementation to be used (if it's not too late) */ | |
406 | int CRYPTO_set_ex_data_implementation(const CRYPTO_EX_DATA_IMPL *i); | |
407 | /* Get a new "ex_data" class, and return the corresponding "class_index" */ | |
408 | int CRYPTO_ex_data_new_class(void); | |
409 | /* Within a given class, get/register a new index */ | |
410 | int CRYPTO_get_ex_new_index(int class_index, long argl, void *argp, | |
ae5c8664 MC |
411 | CRYPTO_EX_new *new_func, CRYPTO_EX_dup *dup_func, |
412 | CRYPTO_EX_free *free_func); | |
413 | /* | |
414 | * Initialise/duplicate/free CRYPTO_EX_DATA variables corresponding to a | |
415 | * given class (invokes whatever per-class callbacks are applicable) | |
416 | */ | |
3a079997 GT |
417 | int CRYPTO_new_ex_data(int class_index, void *obj, CRYPTO_EX_DATA *ad); |
418 | int CRYPTO_dup_ex_data(int class_index, CRYPTO_EX_DATA *to, | |
ae5c8664 | 419 | CRYPTO_EX_DATA *from); |
3a079997 | 420 | void CRYPTO_free_ex_data(int class_index, void *obj, CRYPTO_EX_DATA *ad); |
ae5c8664 MC |
421 | /* |
422 | * Get/set data in a CRYPTO_EX_DATA variable corresponding to a particular | |
423 | * index (relative to the class type involved) | |
424 | */ | |
dd9d233e | 425 | int CRYPTO_set_ex_data(CRYPTO_EX_DATA *ad, int idx, void *val); |
ae5c8664 MC |
426 | void *CRYPTO_get_ex_data(const CRYPTO_EX_DATA *ad, int idx); |
427 | /* | |
428 | * This function cleans up all "ex_data" state. It mustn't be called under | |
429 | * potential race-conditions. | |
430 | */ | |
3a079997 | 431 | void CRYPTO_cleanup_all_ex_data(void); |
58964a49 | 432 | |
58964a49 | 433 | int CRYPTO_get_new_lockid(char *name); |
a111306b | 434 | |
ae5c8664 MC |
435 | int CRYPTO_num_locks(void); /* return CRYPTO_NUM_LOCKS (shared libs!) */ |
436 | void CRYPTO_lock(int mode, int type, const char *file, int line); | |
437 | void CRYPTO_set_locking_callback(void (*func) (int mode, int type, | |
438 | const char *file, int line)); | |
439 | void (*CRYPTO_get_locking_callback(void)) (int mode, int type, | |
440 | const char *file, int line); | |
441 | void CRYPTO_set_add_lock_callback(int (*func) | |
442 | (int *num, int mount, int type, | |
443 | const char *file, int line)); | |
444 | int (*CRYPTO_get_add_lock_callback(void)) (int *num, int mount, int type, | |
445 | const char *file, int line); | |
4c329696 GT |
446 | |
447 | /* Don't use this structure directly. */ | |
ae5c8664 MC |
448 | typedef struct crypto_threadid_st { |
449 | void *ptr; | |
450 | unsigned long val; | |
451 | } CRYPTO_THREADID; | |
4c329696 GT |
452 | /* Only use CRYPTO_THREADID_set_[numeric|pointer]() within callbacks */ |
453 | void CRYPTO_THREADID_set_numeric(CRYPTO_THREADID *id, unsigned long val); | |
454 | void CRYPTO_THREADID_set_pointer(CRYPTO_THREADID *id, void *ptr); | |
ae5c8664 MC |
455 | int CRYPTO_THREADID_set_callback(void (*threadid_func) (CRYPTO_THREADID *)); |
456 | void (*CRYPTO_THREADID_get_callback(void)) (CRYPTO_THREADID *); | |
4c329696 GT |
457 | void CRYPTO_THREADID_current(CRYPTO_THREADID *id); |
458 | int CRYPTO_THREADID_cmp(const CRYPTO_THREADID *a, const CRYPTO_THREADID *b); | |
459 | void CRYPTO_THREADID_cpy(CRYPTO_THREADID *dest, const CRYPTO_THREADID *src); | |
460 | unsigned long CRYPTO_THREADID_hash(const CRYPTO_THREADID *id); | |
ae5c8664 MC |
461 | # ifndef OPENSSL_NO_DEPRECATED |
462 | void CRYPTO_set_id_callback(unsigned long (*func) (void)); | |
463 | unsigned long (*CRYPTO_get_id_callback(void)) (void); | |
d02b48c6 | 464 | unsigned long CRYPTO_thread_id(void); |
ae5c8664 | 465 | # endif |
f7ccba3e | 466 | |
e778802f | 467 | const char *CRYPTO_get_lock_name(int type); |
ae5c8664 MC |
468 | int CRYPTO_add_lock(int *pointer, int amount, int type, const char *file, |
469 | int line); | |
55b7688e | 470 | |
c7922304 RL |
471 | int CRYPTO_get_new_dynlockid(void); |
472 | void CRYPTO_destroy_dynlockid(int i); | |
e73a6965 | 473 | struct CRYPTO_dynlock_value *CRYPTO_get_dynlock_value(int i); |
ae5c8664 MC |
474 | void CRYPTO_set_dynlock_create_callback(struct CRYPTO_dynlock_value |
475 | *(*dyn_create_function) (const char | |
476 | *file, | |
477 | int line)); | |
478 | void CRYPTO_set_dynlock_lock_callback(void (*dyn_lock_function) | |
479 | (int mode, | |
480 | struct CRYPTO_dynlock_value *l, | |
481 | const char *file, int line)); | |
482 | void CRYPTO_set_dynlock_destroy_callback(void (*dyn_destroy_function) | |
483 | (struct CRYPTO_dynlock_value *l, | |
484 | const char *file, int line)); | |
485 | struct CRYPTO_dynlock_value | |
486 | *(*CRYPTO_get_dynlock_create_callback(void)) (const char *file, int line); | |
487 | void (*CRYPTO_get_dynlock_lock_callback(void)) (int mode, | |
488 | struct CRYPTO_dynlock_value | |
489 | *l, const char *file, | |
490 | int line); | |
491 | void (*CRYPTO_get_dynlock_destroy_callback(void)) (struct CRYPTO_dynlock_value | |
492 | *l, const char *file, | |
493 | int line); | |
494 | ||
495 | /* | |
496 | * CRYPTO_set_mem_functions includes CRYPTO_set_locked_mem_functions -- call | |
497 | * the latter last if you need different functions | |
498 | */ | |
499 | int CRYPTO_set_mem_functions(void *(*m) (size_t), void *(*r) (void *, size_t), | |
500 | void (*f) (void *)); | |
501 | int CRYPTO_set_locked_mem_functions(void *(*m) (size_t), | |
502 | void (*free_func) (void *)); | |
503 | int CRYPTO_set_mem_ex_functions(void *(*m) (size_t, const char *, int), | |
504 | void *(*r) (void *, size_t, const char *, | |
505 | int), void (*f) (void *)); | |
506 | int CRYPTO_set_locked_mem_ex_functions(void *(*m) (size_t, const char *, int), | |
507 | void (*free_func) (void *)); | |
508 | int CRYPTO_set_mem_debug_functions(void (*m) | |
509 | (void *, int, const char *, int, int), | |
510 | void (*r) (void *, void *, int, | |
511 | const char *, int, int), | |
512 | void (*f) (void *, int), void (*so) (long), | |
513 | long (*go) (void)); | |
514 | void CRYPTO_get_mem_functions(void *(**m) (size_t), | |
515 | void *(**r) (void *, size_t), | |
516 | void (**f) (void *)); | |
517 | void CRYPTO_get_locked_mem_functions(void *(**m) (size_t), | |
518 | void (**f) (void *)); | |
519 | void CRYPTO_get_mem_ex_functions(void *(**m) (size_t, const char *, int), | |
520 | void *(**r) (void *, size_t, const char *, | |
521 | int), void (**f) (void *)); | |
522 | void CRYPTO_get_locked_mem_ex_functions(void | |
523 | *(**m) (size_t, const char *, int), | |
524 | void (**f) (void *)); | |
525 | void CRYPTO_get_mem_debug_functions(void (**m) | |
526 | (void *, int, const char *, int, int), | |
527 | void (**r) (void *, void *, int, | |
528 | const char *, int, int), | |
529 | void (**f) (void *, int), | |
530 | void (**so) (long), long (**go) (void)); | |
d02b48c6 | 531 | |
6343829a | 532 | void *CRYPTO_malloc_locked(int num, const char *file, int line); |
68d2cf51 | 533 | void CRYPTO_free_locked(void *ptr); |
6343829a | 534 | void *CRYPTO_malloc(int num, const char *file, int line); |
6caa4edd | 535 | char *CRYPTO_strdup(const char *str, const char *file, int line); |
68d2cf51 | 536 | void CRYPTO_free(void *ptr); |
ae5c8664 MC |
537 | void *CRYPTO_realloc(void *addr, int num, const char *file, int line); |
538 | void *CRYPTO_realloc_clean(void *addr, int old_num, int num, const char *file, | |
539 | int line); | |
540 | void *CRYPTO_remalloc(void *addr, int num, const char *file, int line); | |
5a88a6ea | 541 | |
df29cc8f RL |
542 | void OPENSSL_cleanse(void *ptr, size_t len); |
543 | ||
0cd08cce | 544 | void CRYPTO_set_mem_debug_options(long bits); |
667ac4ec | 545 | long CRYPTO_get_mem_debug_options(void); |
0cd08cce | 546 | |
ae5c8664 | 547 | # define CRYPTO_push_info(info) \ |
2b6313d0 BM |
548 | CRYPTO_push_info_(info, __FILE__, __LINE__); |
549 | int CRYPTO_push_info_(const char *info, const char *file, int line); | |
550 | int CRYPTO_pop_info(void); | |
9ac42ed8 RL |
551 | int CRYPTO_remove_all_info(void); |
552 | ||
ae5c8664 MC |
553 | /* |
554 | * Default debugging functions (enabled by CRYPTO_malloc_debug_init() macro; | |
555 | * used as default in CRYPTO_MDEBUG compilations): | |
556 | */ | |
c695ebe2 MC |
557 | /*- |
558 | * The last argument has the following significance: | |
9ac42ed8 | 559 | * |
ae5c8664 MC |
560 | * 0: called before the actual memory allocation has taken place |
561 | * 1: called after the actual memory allocation has taken place | |
9ac42ed8 | 562 | */ |
ae5c8664 MC |
563 | void CRYPTO_dbg_malloc(void *addr, int num, const char *file, int line, |
564 | int before_p); | |
565 | void CRYPTO_dbg_realloc(void *addr1, void *addr2, int num, const char *file, | |
566 | int line, int before_p); | |
567 | void CRYPTO_dbg_free(void *addr, int before_p); | |
6977c7e2 TH |
568 | /*- |
569 | * Tell the debugging code about options. By default, the following values | |
9ac42ed8 RL |
570 | * apply: |
571 | * | |
384eff87 BM |
572 | * 0: Clear all options. |
573 | * V_CRYPTO_MDEBUG_TIME (1): Set the "Show Time" option. | |
574 | * V_CRYPTO_MDEBUG_THREAD (2): Set the "Show Thread Number" option. | |
575 | * V_CRYPTO_MDEBUG_ALL (3): 1 + 2 | |
9ac42ed8 | 576 | */ |
0cd08cce | 577 | void CRYPTO_dbg_set_options(long bits); |
667ac4ec | 578 | long CRYPTO_dbg_get_options(void); |
1f575f1b | 579 | |
ae5c8664 | 580 | # ifndef OPENSSL_NO_FP_API |
d02b48c6 | 581 | void CRYPTO_mem_leaks_fp(FILE *); |
ae5c8664 | 582 | # endif |
58964a49 | 583 | void CRYPTO_mem_leaks(struct bio_st *bio); |
d02b48c6 | 584 | /* unsigned long order, char *file, int line, int num_bytes, char *addr */ |
ae5c8664 MC |
585 | typedef void *CRYPTO_MEM_LEAK_CB (unsigned long, const char *, int, int, |
586 | void *); | |
32654e79 | 587 | void CRYPTO_mem_leaks_cb(CRYPTO_MEM_LEAK_CB *cb); |
d02b48c6 | 588 | |
17ed6c06 | 589 | /* die if we have to */ |
ae5c8664 MC |
590 | void OpenSSLDie(const char *file, int line, const char *assertion); |
591 | # define OPENSSL_assert(e) (void)((e) ? 0 : (OpenSSLDie(__FILE__, __LINE__, #e),1)) | |
17ed6c06 | 592 | |
3547478f | 593 | unsigned long *OPENSSL_ia32cap_loc(void); |
ae5c8664 | 594 | # define OPENSSL_ia32cap (*(OPENSSL_ia32cap_loc())) |
c7d5edbf | 595 | int OPENSSL_isservice(void); |
3547478f | 596 | |
f98d2e5c DSH |
597 | int FIPS_mode(void); |
598 | int FIPS_mode_set(int r); | |
599 | ||
7207eca1 DSH |
600 | void OPENSSL_init(void); |
601 | ||
ae5c8664 MC |
602 | # define fips_md_init(alg) fips_md_init_ctx(alg, alg) |
603 | ||
604 | # ifdef OPENSSL_FIPS | |
605 | # define fips_md_init_ctx(alg, cx) \ | |
606 | int alg##_Init(cx##_CTX *c) \ | |
607 | { \ | |
608 | if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \ | |
609 | "Low level API call to digest " #alg " forbidden in FIPS mode!"); \ | |
610 | return private_##alg##_Init(c); \ | |
611 | } \ | |
612 | int private_##alg##_Init(cx##_CTX *c) | |
613 | ||
614 | # define fips_cipher_abort(alg) \ | |
615 | if (FIPS_mode()) OpenSSLDie(__FILE__, __LINE__, \ | |
616 | "Low level API call to cipher " #alg " forbidden in FIPS mode!") | |
617 | ||
618 | # else | |
619 | # define fips_md_init_ctx(alg, cx) \ | |
620 | int alg##_Init(cx##_CTX *c) | |
621 | # define fips_cipher_abort(alg) while(0) | |
622 | # endif | |
65300dcf | 623 | |
ae5c8664 MC |
624 | /* |
625 | * CRYPTO_memcmp returns zero iff the |len| bytes at |a| and |b| are equal. | |
626 | * It takes an amount of time dependent on |len|, but independent of the | |
627 | * contents of |a| and |b|. Unlike memcmp, it cannot be used to put elements | |
628 | * into a defined order as the return value when a != b is undefined, other | |
629 | * than to be non-zero. | |
630 | */ | |
e0fde613 | 631 | int CRYPTO_memcmp(const volatile void *a, const volatile void *b, size_t len); |
f5cd3561 | 632 | |
58964a49 | 633 | /* BEGIN ERROR CODES */ |
ae5c8664 MC |
634 | /* |
635 | * The following lines are auto generated by the script mkerr.pl. Any changes | |
6d311938 DSH |
636 | * made after this point may be overwritten when the script is next run. |
637 | */ | |
3a079997 | 638 | void ERR_load_CRYPTO_strings(void); |
6d311938 | 639 | |
58964a49 RE |
640 | /* Error codes for the CRYPTO functions. */ |
641 | ||
642 | /* Function codes. */ | |
ae5c8664 MC |
643 | # define CRYPTO_F_CRYPTO_GET_EX_NEW_INDEX 100 |
644 | # define CRYPTO_F_CRYPTO_GET_NEW_DYNLOCKID 103 | |
645 | # define CRYPTO_F_CRYPTO_GET_NEW_LOCKID 101 | |
646 | # define CRYPTO_F_CRYPTO_SET_EX_DATA 102 | |
647 | # define CRYPTO_F_DEF_ADD_INDEX 104 | |
648 | # define CRYPTO_F_DEF_GET_CLASS 105 | |
649 | # define CRYPTO_F_FIPS_MODE_SET 109 | |
650 | # define CRYPTO_F_INT_DUP_EX_DATA 106 | |
651 | # define CRYPTO_F_INT_FREE_EX_DATA 107 | |
652 | # define CRYPTO_F_INT_NEW_EX_DATA 108 | |
58964a49 RE |
653 | |
654 | /* Reason codes. */ | |
ae5c8664 MC |
655 | # define CRYPTO_R_FIPS_MODE_NOT_SUPPORTED 101 |
656 | # define CRYPTO_R_NO_DYNLOCK_CREATE_CALLBACK 100 | |
6d311938 | 657 | |
d02b48c6 RE |
658 | #ifdef __cplusplus |
659 | } | |
660 | #endif | |
d02b48c6 | 661 | #endif |