2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
5 * This package is an SSL implementation written
6 * by Eric Young (eay@cryptsoft.com).
7 * The implementation was written so as to conform with Netscapes SSL.
9 * This library is free for commercial and non-commercial use as long as
10 * the following conditions are aheared to. The following conditions
11 * apply to all code found in this distribution, be it the RC4, RSA,
12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
13 * included with this distribution is covered by the same copyright terms
14 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
16 * Copyright remains Eric Young's, and as such any Copyright notices in
17 * the code are not to be removed.
18 * If this package is used in a product, Eric Young should be given attribution
19 * as the author of the parts of the library used.
20 * This can be in the form of a textual message at program startup or
21 * in documentation (online or textual) provided with the package.
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
26 * 1. Redistributions of source code must retain the copyright
27 * notice, this list of conditions and the following disclaimer.
28 * 2. Redistributions in binary form must reproduce the above copyright
29 * notice, this list of conditions and the following disclaimer in the
30 * documentation and/or other materials provided with the distribution.
31 * 3. All advertising materials mentioning features or use of this software
32 * must display the following acknowledgement:
33 * "This product includes cryptographic software written by
34 * Eric Young (eay@cryptsoft.com)"
35 * The word 'cryptographic' can be left out if the rouines from the library
36 * being used are not cryptographic related :-).
37 * 4. If you include any Windows specific code (or a derivative thereof) from
38 * the apps directory (application code) you must include an acknowledgement:
39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53 * The licence and distribution terms for any publically available version or
54 * derivative of this code cannot be changed. i.e. this code cannot simply be
55 * copied and put under another distribution licence
56 * [including the GNU Public Licence.]
58 /* ====================================================================
59 * Copyright (c) 1998-2001 The OpenSSL Project. All rights reserved.
61 * Redistribution and use in source and binary forms, with or without
62 * modification, are permitted provided that the following conditions
65 * 1. Redistributions of source code must retain the above copyright
66 * notice, this list of conditions and the following disclaimer.
68 * 2. Redistributions in binary form must reproduce the above copyright
69 * notice, this list of conditions and the following disclaimer in
70 * the documentation and/or other materials provided with the
73 * 3. All advertising materials mentioning features or use of this
74 * software must display the following acknowledgment:
75 * "This product includes software developed by the OpenSSL Project
76 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
78 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
79 * endorse or promote products derived from this software without
80 * prior written permission. For written permission, please contact
81 * openssl-core@openssl.org.
83 * 5. Products derived from this software may not be called "OpenSSL"
84 * nor may "OpenSSL" appear in their names without prior written
85 * permission of the OpenSSL Project.
87 * 6. Redistributions of any form whatsoever must retain the following
89 * "This product includes software developed by the OpenSSL Project
90 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
92 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
93 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
94 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
95 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
96 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
98 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
99 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
100 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
101 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
102 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
103 * OF THE POSSIBILITY OF SUCH DAMAGE.
104 * ====================================================================
106 * This product includes cryptographic software written by Eric Young
107 * (eay@cryptsoft.com). This product includes software written by Tim
108 * Hudson (tjh@cryptsoft.com).
115 #include <openssl/lhash.h>
116 #include <openssl/crypto.h>
117 #include "cryptlib.h"
118 #include <openssl/buffer.h>
119 #include <openssl/bio.h>
120 #include <openssl/err.h>
122 static void err_load_strings(int lib, ERR_STRING_DATA *str);
124 static void ERR_STATE_free(ERR_STATE *s);
125 #ifndef OPENSSL_NO_ERR
126 static ERR_STRING_DATA ERR_str_libraries[]=
128 {ERR_PACK(ERR_LIB_NONE,0,0) ,"unknown library"},
129 {ERR_PACK(ERR_LIB_SYS,0,0) ,"system library"},
130 {ERR_PACK(ERR_LIB_BN,0,0) ,"bignum routines"},
131 {ERR_PACK(ERR_LIB_RSA,0,0) ,"rsa routines"},
132 {ERR_PACK(ERR_LIB_DH,0,0) ,"Diffie-Hellman routines"},
133 {ERR_PACK(ERR_LIB_EVP,0,0) ,"digital envelope routines"},
134 {ERR_PACK(ERR_LIB_BUF,0,0) ,"memory buffer routines"},
135 {ERR_PACK(ERR_LIB_OBJ,0,0) ,"object identifier routines"},
136 {ERR_PACK(ERR_LIB_PEM,0,0) ,"PEM routines"},
137 {ERR_PACK(ERR_LIB_DSA,0,0) ,"dsa routines"},
138 {ERR_PACK(ERR_LIB_X509,0,0) ,"x509 certificate routines"},
139 {ERR_PACK(ERR_LIB_ASN1,0,0) ,"asn1 encoding routines"},
140 {ERR_PACK(ERR_LIB_CONF,0,0) ,"configuration file routines"},
141 {ERR_PACK(ERR_LIB_CRYPTO,0,0) ,"common libcrypto routines"},
142 {ERR_PACK(ERR_LIB_EC,0,0) ,"elliptic curve routines"},
143 {ERR_PACK(ERR_LIB_SSL,0,0) ,"SSL routines"},
144 {ERR_PACK(ERR_LIB_BIO,0,0) ,"BIO routines"},
145 {ERR_PACK(ERR_LIB_PKCS7,0,0) ,"PKCS7 routines"},
146 {ERR_PACK(ERR_LIB_X509V3,0,0) ,"X509 V3 routines"},
147 {ERR_PACK(ERR_LIB_PKCS12,0,0) ,"PKCS12 routines"},
148 {ERR_PACK(ERR_LIB_RAND,0,0) ,"random number generator"},
149 {ERR_PACK(ERR_LIB_DSO,0,0) ,"DSO support routines"},
150 {ERR_PACK(ERR_LIB_ENGINE,0,0) ,"engine routines"},
151 {ERR_PACK(ERR_LIB_OCSP,0,0) ,"OCSP routines"},
155 static ERR_STRING_DATA ERR_str_functs[]=
157 {ERR_PACK(0,SYS_F_FOPEN,0), "fopen"},
158 {ERR_PACK(0,SYS_F_CONNECT,0), "connect"},
159 {ERR_PACK(0,SYS_F_GETSERVBYNAME,0), "getservbyname"},
160 {ERR_PACK(0,SYS_F_SOCKET,0), "socket"},
161 {ERR_PACK(0,SYS_F_IOCTLSOCKET,0), "ioctlsocket"},
162 {ERR_PACK(0,SYS_F_BIND,0), "bind"},
163 {ERR_PACK(0,SYS_F_LISTEN,0), "listen"},
164 {ERR_PACK(0,SYS_F_ACCEPT,0), "accept"},
165 #ifdef OPENSSL_SYS_WINDOWS
166 {ERR_PACK(0,SYS_F_WSASTARTUP,0), "WSAstartup"},
168 {ERR_PACK(0,SYS_F_OPENDIR,0), "opendir"},
169 {ERR_PACK(0,SYS_F_FREAD,0), "fread"},
173 static ERR_STRING_DATA ERR_str_reasons[]=
175 {ERR_R_SYS_LIB ,"system lib"},
176 {ERR_R_BN_LIB ,"BN lib"},
177 {ERR_R_RSA_LIB ,"RSA lib"},
178 {ERR_R_DH_LIB ,"DH lib"},
179 {ERR_R_EVP_LIB ,"EVP lib"},
180 {ERR_R_BUF_LIB ,"BUF lib"},
181 {ERR_R_OBJ_LIB ,"OBJ lib"},
182 {ERR_R_PEM_LIB ,"PEM lib"},
183 {ERR_R_DSA_LIB ,"DSA lib"},
184 {ERR_R_X509_LIB ,"X509 lib"},
185 {ERR_R_ASN1_LIB ,"ASN1 lib"},
186 {ERR_R_CONF_LIB ,"CONF lib"},
187 {ERR_R_CRYPTO_LIB ,"CRYPTO lib"},
188 {ERR_R_EC_LIB ,"EC lib"},
189 {ERR_R_SSL_LIB ,"SSL lib"},
190 {ERR_R_BIO_LIB ,"BIO lib"},
191 {ERR_R_PKCS7_LIB ,"PKCS7 lib"},
192 {ERR_R_X509V3_LIB ,"X509V3 lib"},
193 {ERR_R_PKCS12_LIB ,"PKCS12 lib"},
194 {ERR_R_RAND_LIB ,"RAND lib"},
195 {ERR_R_DSO_LIB ,"DSO lib"},
196 {ERR_R_ENGINE_LIB ,"ENGINE lib"},
197 {ERR_R_OCSP_LIB ,"OCSP lib"},
199 {ERR_R_NESTED_ASN1_ERROR ,"nested asn1 error"},
200 {ERR_R_BAD_ASN1_OBJECT_HEADER ,"bad asn1 object header"},
201 {ERR_R_BAD_GET_ASN1_OBJECT_CALL ,"bad get asn1 object call"},
202 {ERR_R_EXPECTING_AN_ASN1_SEQUENCE ,"expecting an asn1 sequence"},
203 {ERR_R_ASN1_LENGTH_MISMATCH ,"asn1 length mismatch"},
204 {ERR_R_MISSING_ASN1_EOS ,"missing asn1 eos"},
206 {ERR_R_FATAL ,"fatal"},
207 {ERR_R_MALLOC_FAILURE ,"malloc failure"},
208 {ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED ,"called a function you should not call"},
209 {ERR_R_PASSED_NULL_PARAMETER ,"passed a null parameter"},
210 {ERR_R_INTERNAL_ERROR ,"internal error"},
211 {ERR_R_DISABLED ,"called a function that was disabled at compile-time"},
218 /* Define the predeclared (but externally opaque) "ERR_FNS" type */
221 /* Works on the "error_hash" string table */
222 LHASH *(*cb_err_get)(int create);
223 void (*cb_err_del)(void);
224 ERR_STRING_DATA *(*cb_err_get_item)(const ERR_STRING_DATA *);
225 ERR_STRING_DATA *(*cb_err_set_item)(ERR_STRING_DATA *);
226 ERR_STRING_DATA *(*cb_err_del_item)(ERR_STRING_DATA *);
227 /* Works on the "thread_hash" error-state table */
228 LHASH *(*cb_thread_get)(int create);
229 void (*cb_thread_release)(LHASH **hash);
230 ERR_STATE *(*cb_thread_get_item)(const ERR_STATE *);
231 ERR_STATE *(*cb_thread_set_item)(ERR_STATE *);
232 void (*cb_thread_del_item)(const ERR_STATE *);
233 /* Returns the next available error "library" numbers */
234 int (*cb_get_next_lib)(void);
237 /* Predeclarations of the "err_defaults" functions */
238 static LHASH *int_err_get(int create);
239 static void int_err_del(void);
240 static ERR_STRING_DATA *int_err_get_item(const ERR_STRING_DATA *);
241 static ERR_STRING_DATA *int_err_set_item(ERR_STRING_DATA *);
242 static ERR_STRING_DATA *int_err_del_item(ERR_STRING_DATA *);
243 static LHASH *int_thread_get(int create);
244 static void int_thread_release(LHASH **hash);
245 static ERR_STATE *int_thread_get_item(const ERR_STATE *);
246 static ERR_STATE *int_thread_set_item(ERR_STATE *);
247 static void int_thread_del_item(const ERR_STATE *);
248 static int int_err_get_next_lib(void);
249 /* The static ERR_FNS table using these defaults functions */
250 static const ERR_FNS err_defaults =
265 /* The replacable table of ERR_FNS functions we use at run-time */
266 static const ERR_FNS *err_fns = NULL;
268 /* Eg. rather than using "err_get()", use "ERRFN(err_get)()". */
269 #define ERRFN(a) err_fns->cb_##a
271 /* The internal state used by "err_defaults" - as such, the setting, reading,
272 * creating, and deleting of this data should only be permitted via the
273 * "err_defaults" functions. This way, a linked module can completely defer all
274 * ERR state operation (together with requisite locking) to the implementations
275 * and state in the loading application. */
276 static LHASH *int_error_hash = NULL;
277 static LHASH *int_thread_hash = NULL;
278 static int int_thread_hash_references = 0;
279 static int int_err_library_number= ERR_LIB_USER;
281 /* Internal function that checks whether "err_fns" is set and if not, sets it to
283 static void err_fns_check(void)
287 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
289 err_fns = &err_defaults;
290 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
293 /* API functions to get or set the underlying ERR functions. */
295 const ERR_FNS *ERR_get_implementation(void)
301 int ERR_set_implementation(const ERR_FNS *fns)
305 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
306 /* It's too late if 'err_fns' is non-NULL. BTW: not much point setting
307 * an error is there?! */
313 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
317 /* These are the callbacks provided to "lh_new()" when creating the LHASH tables
318 * internal to the "err_defaults" implementation. */
320 /* static unsigned long err_hash(ERR_STRING_DATA *a); */
321 static unsigned long err_hash(const void *a_void);
322 /* static int err_cmp(ERR_STRING_DATA *a, ERR_STRING_DATA *b); */
323 static int err_cmp(const void *a_void, const void *b_void);
324 /* static unsigned long pid_hash(ERR_STATE *pid); */
325 static unsigned long pid_hash(const void *pid_void);
326 /* static int pid_cmp(ERR_STATE *a,ERR_STATE *pid); */
327 static int pid_cmp(const void *a_void,const void *pid_void);
328 static unsigned long get_error_values(int inc,int top,const char **file,int *line,
329 const char **data,int *flags);
331 /* The internal functions used in the "err_defaults" implementation */
333 static LHASH *int_err_get(int create)
337 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
338 if (!int_error_hash && create)
340 CRYPTO_push_info("int_err_get (err.c)");
341 int_error_hash = lh_new(err_hash, err_cmp);
345 ret = int_error_hash;
346 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
351 static void int_err_del(void)
353 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
356 lh_free(int_error_hash);
357 int_error_hash = NULL;
359 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
362 static ERR_STRING_DATA *int_err_get_item(const ERR_STRING_DATA *d)
368 hash = ERRFN(err_get)(0);
372 CRYPTO_r_lock(CRYPTO_LOCK_ERR);
373 p = (ERR_STRING_DATA *)lh_retrieve(hash, d);
374 CRYPTO_r_unlock(CRYPTO_LOCK_ERR);
379 static ERR_STRING_DATA *int_err_set_item(ERR_STRING_DATA *d)
385 hash = ERRFN(err_get)(1);
389 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
390 p = (ERR_STRING_DATA *)lh_insert(hash, d);
391 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
396 static ERR_STRING_DATA *int_err_del_item(ERR_STRING_DATA *d)
402 hash = ERRFN(err_get)(0);
406 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
407 p = (ERR_STRING_DATA *)lh_delete(hash, d);
408 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
413 static LHASH *int_thread_get(int create)
417 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
418 if (!int_thread_hash && create)
420 CRYPTO_push_info("int_thread_get (err.c)");
421 int_thread_hash = lh_new(pid_hash, pid_cmp);
426 int_thread_hash_references++;
427 ret = int_thread_hash;
429 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
433 static void int_thread_release(LHASH **hash)
437 if (hash == NULL || *hash == NULL)
440 i = CRYPTO_add(&int_thread_hash_references, -1, CRYPTO_LOCK_ERR);
443 fprintf(stderr,"%4d:%s\n",int_thread_hash_references,"ERR");
449 fprintf(stderr,"int_thread_release, bad reference count\n");
456 static ERR_STATE *int_thread_get_item(const ERR_STATE *d)
462 hash = ERRFN(thread_get)(0);
466 CRYPTO_r_lock(CRYPTO_LOCK_ERR);
467 p = (ERR_STATE *)lh_retrieve(hash, d);
468 CRYPTO_r_unlock(CRYPTO_LOCK_ERR);
470 ERRFN(thread_release)(&hash);
474 static ERR_STATE *int_thread_set_item(ERR_STATE *d)
480 hash = ERRFN(thread_get)(1);
484 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
485 p = (ERR_STATE *)lh_insert(hash, d);
486 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
488 ERRFN(thread_release)(&hash);
492 static void int_thread_del_item(const ERR_STATE *d)
498 hash = ERRFN(thread_get)(0);
502 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
503 p = (ERR_STATE *)lh_delete(hash, d);
504 /* make sure we don't leak memory */
505 if (int_thread_hash_references == 1
506 && int_thread_hash && (lh_num_items(int_thread_hash) == 0))
508 lh_free(int_thread_hash);
509 int_thread_hash = NULL;
511 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
513 ERRFN(thread_release)(&hash);
518 static int int_err_get_next_lib(void)
522 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
523 ret = int_err_library_number++;
524 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
530 #ifndef OPENSSL_NO_ERR
531 #define NUM_SYS_STR_REASONS 127
532 #define LEN_SYS_STR_REASON 32
534 static ERR_STRING_DATA SYS_str_reasons[NUM_SYS_STR_REASONS + 1];
535 /* SYS_str_reasons is filled with copies of strerror() results at
537 * 'errno' values up to 127 should cover all usual errors,
538 * others will be displayed numerically by ERR_error_string.
539 * It is crucial that we have something for each reason code
540 * that occurs in ERR_str_reasons, or bogus reason strings
541 * will be returned for SYSerr(), which always gets an errno
542 * value and never one of those 'standard' reason codes. */
544 static void build_SYS_str_reasons()
546 /* OPENSSL_malloc cannot be used here, use static storage instead */
547 static char strerror_tab[NUM_SYS_STR_REASONS][LEN_SYS_STR_REASON];
553 CRYPTO_w_lock(CRYPTO_LOCK_ERR);
555 for (i = 1; i <= NUM_SYS_STR_REASONS; i++)
557 ERR_STRING_DATA *str = &SYS_str_reasons[i - 1];
559 str->error = (unsigned long)i;
560 if (str->string == NULL)
562 char (*dest)[LEN_SYS_STR_REASON] = &(strerror_tab[i - 1]);
563 char *src = strerror(i);
566 strncpy(*dest, src, sizeof *dest);
567 (*dest)[sizeof *dest - 1] = '\0';
571 if (str->string == NULL)
572 str->string = "unknown";
575 /* Now we still have SYS_str_reasons[NUM_SYS_STR_REASONS] = {0, NULL},
576 * as required by ERR_load_strings. */
580 CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
584 #define err_clear_data(p,i) \
586 if (((p)->err_data[i] != NULL) && \
587 (p)->err_data_flags[i] & ERR_TXT_MALLOCED) \
589 OPENSSL_free((p)->err_data[i]); \
590 (p)->err_data[i]=NULL; \
592 (p)->err_data_flags[i]=0; \
595 #define err_clear(p,i) \
597 es->err_flags[i]=0; \
598 es->err_buffer[i]=0; \
599 err_clear_data(p,i); \
600 es->err_file[i]=NULL; \
601 es->err_line[i]= -1; \
604 static void ERR_STATE_free(ERR_STATE *s)
611 for (i=0; i<ERR_NUM_ERRORS; i++)
618 void ERR_load_ERR_strings(void)
621 #ifndef OPENSSL_NO_ERR
622 err_load_strings(0,ERR_str_libraries);
623 err_load_strings(0,ERR_str_reasons);
624 err_load_strings(ERR_LIB_SYS,ERR_str_functs);
625 build_SYS_str_reasons();
626 err_load_strings(ERR_LIB_SYS,SYS_str_reasons);
630 static void err_load_strings(int lib, ERR_STRING_DATA *str)
634 str->error|=ERR_PACK(lib,0,0);
635 ERRFN(err_set_item)(str);
640 void ERR_load_strings(int lib, ERR_STRING_DATA *str)
642 ERR_load_ERR_strings();
643 err_load_strings(lib, str);
646 void ERR_unload_strings(int lib, ERR_STRING_DATA *str)
650 str->error|=ERR_PACK(lib,0,0);
651 ERRFN(err_del_item)(str);
656 void ERR_free_strings(void)
662 /********************************************************/
664 void ERR_put_error(int lib, int func, int reason, const char *file,
670 /* In the BS2000-OSD POSIX subsystem, the compiler generates
671 * path names in the form "*POSIX(/etc/passwd)".
672 * This dirty hack strips them to something sensible.
673 * @@@ We shouldn't modify a const string, though.
675 if (strncmp(file,"*POSIX(", sizeof("*POSIX(")-1) == 0) {
678 /* Skip the "*POSIX(" prefix */
679 file += sizeof("*POSIX(")-1;
680 end = &file[strlen(file)-1];
683 /* Optional: use the basename of the path only. */
684 if ((end = strrchr(file, '/')) != NULL)
690 es->top=(es->top+1)%ERR_NUM_ERRORS;
691 if (es->top == es->bottom)
692 es->bottom=(es->bottom+1)%ERR_NUM_ERRORS;
693 es->err_flags[es->top]=0;
694 es->err_buffer[es->top]=ERR_PACK(lib,func,reason);
695 es->err_file[es->top]=file;
696 es->err_line[es->top]=line;
697 err_clear_data(es,es->top);
700 void ERR_clear_error(void)
707 for (i=0; i<ERR_NUM_ERRORS; i++)
711 es->top=es->bottom=0;
715 unsigned long ERR_get_error(void)
716 { return(get_error_values(1,0,NULL,NULL,NULL,NULL)); }
718 unsigned long ERR_get_error_line(const char **file,
720 { return(get_error_values(1,0,file,line,NULL,NULL)); }
722 unsigned long ERR_get_error_line_data(const char **file, int *line,
723 const char **data, int *flags)
724 { return(get_error_values(1,0,file,line,data,flags)); }
727 unsigned long ERR_peek_error(void)
728 { return(get_error_values(0,0,NULL,NULL,NULL,NULL)); }
730 unsigned long ERR_peek_error_line(const char **file, int *line)
731 { return(get_error_values(0,0,file,line,NULL,NULL)); }
733 unsigned long ERR_peek_error_line_data(const char **file, int *line,
734 const char **data, int *flags)
735 { return(get_error_values(0,0,file,line,data,flags)); }
738 unsigned long ERR_peek_last_error(void)
739 { return(get_error_values(0,1,NULL,NULL,NULL,NULL)); }
741 unsigned long ERR_peek_last_error_line(const char **file, int *line)
742 { return(get_error_values(0,1,file,line,NULL,NULL)); }
744 unsigned long ERR_peek_last_error_line_data(const char **file, int *line,
745 const char **data, int *flags)
746 { return(get_error_values(0,1,file,line,data,flags)); }
749 static unsigned long get_error_values(int inc, int top, const char **file, int *line,
750 const char **data, int *flags)
760 if (file) *file = "";
762 if (data) *data = "";
763 if (flags) *flags = 0;
765 return ERR_R_INTERNAL_ERROR;
768 if (es->bottom == es->top) return 0;
770 i=es->top; /* last error */
772 i=(es->bottom+1)%ERR_NUM_ERRORS; /* first error */
774 ret=es->err_buffer[i];
781 if ((file != NULL) && (line != NULL))
783 if (es->err_file[i] == NULL)
786 if (line != NULL) *line=0;
790 *file=es->err_file[i];
791 if (line != NULL) *line=es->err_line[i];
799 err_clear_data(es, i);
804 if (es->err_data[i] == NULL)
807 if (flags != NULL) *flags=0;
811 *data=es->err_data[i];
812 if (flags != NULL) *flags=es->err_data_flags[i];
818 void ERR_error_string_n(unsigned long e, char *buf, size_t len)
820 char lsbuf[64], fsbuf[64], rsbuf[64];
821 const char *ls,*fs,*rs;
828 ls=ERR_lib_error_string(e);
829 fs=ERR_func_error_string(e);
830 rs=ERR_reason_error_string(e);
833 BIO_snprintf(lsbuf, sizeof(lsbuf), "lib(%lu)", l);
835 BIO_snprintf(fsbuf, sizeof(fsbuf), "func(%lu)", f);
837 BIO_snprintf(rsbuf, sizeof(rsbuf), "reason(%lu)", r);
839 BIO_snprintf(buf, len,"error:%08lX:%s:%s:%s", e, ls?ls:lsbuf,
840 fs?fs:fsbuf, rs?rs:rsbuf);
841 if (strlen(buf) == len-1)
843 /* output may be truncated; make sure we always have 5
844 * colon-separated fields, i.e. 4 colons ... */
846 if (len > NUM_COLONS) /* ... if possible */
851 for (i = 0; i < NUM_COLONS; i++)
853 char *colon = strchr(s, ':');
854 if (colon == NULL || colon > &buf[len-1] - NUM_COLONS + i)
856 /* set colon no. i at last possible position
857 * (buf[len-1] is the terminating 0)*/
858 colon = &buf[len-1] - NUM_COLONS + i;
867 /* BAD for multi-threading: uses a local buffer if ret == NULL */
868 /* ERR_error_string_n should be used instead for ret != NULL
869 * as ERR_error_string cannot know how large the buffer is */
870 char *ERR_error_string(unsigned long e, char *ret)
872 static char buf[256];
874 if (ret == NULL) ret=buf;
875 ERR_error_string_n(e, ret, 256);
880 LHASH *ERR_get_string_table(void)
883 return ERRFN(err_get)(0);
886 LHASH *ERR_get_err_state_table(void)
889 return ERRFN(thread_get)(0);
892 void ERR_release_err_state_table(LHASH **hash)
895 ERRFN(thread_release)(hash);
898 const char *ERR_lib_error_string(unsigned long e)
900 ERR_STRING_DATA d,*p;
905 d.error=ERR_PACK(l,0,0);
906 p=ERRFN(err_get_item)(&d);
907 return((p == NULL)?NULL:p->string);
910 const char *ERR_func_error_string(unsigned long e)
912 ERR_STRING_DATA d,*p;
918 d.error=ERR_PACK(l,f,0);
919 p=ERRFN(err_get_item)(&d);
920 return((p == NULL)?NULL:p->string);
923 const char *ERR_reason_error_string(unsigned long e)
925 ERR_STRING_DATA d,*p=NULL;
931 d.error=ERR_PACK(l,0,r);
932 p=ERRFN(err_get_item)(&d);
935 d.error=ERR_PACK(0,0,r);
936 p=ERRFN(err_get_item)(&d);
938 return((p == NULL)?NULL:p->string);
941 /* static unsigned long err_hash(ERR_STRING_DATA *a) */
942 static unsigned long err_hash(const void *a_void)
946 l=((ERR_STRING_DATA *)a_void)->error;
947 ret=l^ERR_GET_LIB(l)^ERR_GET_FUNC(l);
948 return(ret^ret%19*13);
951 /* static int err_cmp(ERR_STRING_DATA *a, ERR_STRING_DATA *b) */
952 static int err_cmp(const void *a_void, const void *b_void)
954 return((int)(((ERR_STRING_DATA *)a_void)->error -
955 ((ERR_STRING_DATA *)b_void)->error));
958 /* static unsigned long pid_hash(ERR_STATE *a) */
959 static unsigned long pid_hash(const void *a_void)
961 return(((ERR_STATE *)a_void)->pid*13);
964 /* static int pid_cmp(ERR_STATE *a, ERR_STATE *b) */
965 static int pid_cmp(const void *a_void, const void *b_void)
967 return((int)((long)((ERR_STATE *)a_void)->pid -
968 (long)((ERR_STATE *)b_void)->pid));
971 void ERR_remove_state(unsigned long pid)
977 pid=(unsigned long)CRYPTO_thread_id();
979 /* thread_del_item automatically destroys the LHASH if the number of
980 * items reaches zero. */
981 ERRFN(thread_del_item)(&tmp);
984 ERR_STATE *ERR_get_state(void)
986 static ERR_STATE fallback;
987 ERR_STATE *ret,tmp,*tmpp=NULL;
992 pid=(unsigned long)CRYPTO_thread_id();
994 ret=ERRFN(thread_get_item)(&tmp);
996 /* ret == the error state, if NULL, make a new one */
999 ret=(ERR_STATE *)OPENSSL_malloc(sizeof(ERR_STATE));
1000 if (ret == NULL) return(&fallback);
1004 for (i=0; i<ERR_NUM_ERRORS; i++)
1006 ret->err_data[i]=NULL;
1007 ret->err_data_flags[i]=0;
1009 tmpp = ERRFN(thread_set_item)(ret);
1010 /* To check if insertion failed, do a get. */
1011 if (ERRFN(thread_get_item)(ret) != ret)
1013 ERR_STATE_free(ret); /* could not insert it */
1016 /* If a race occured in this function and we came second, tmpp
1017 * is the first one that we just replaced. */
1019 ERR_STATE_free(tmpp);
1024 int ERR_get_next_error_library(void)
1027 return ERRFN(get_next_lib)();
1030 void ERR_set_error_data(char *data, int flags)
1041 err_clear_data(es,i);
1042 es->err_data[i]=data;
1043 es->err_data_flags[i]=flags;
1046 void ERR_add_error_data(int num, ...)
1053 str=OPENSSL_malloc(s+1);
1054 if (str == NULL) return;
1057 va_start(args, num);
1059 for (i=0; i<num; i++)
1061 a=va_arg(args, char*);
1062 /* ignore NULLs, thanks to Bob Beck <beck@obtuse.com> */
1069 p=OPENSSL_realloc(str,s+1);
1081 ERR_set_error_data(str,ERR_TXT_MALLOCED|ERR_TXT_STRING);
1087 int ERR_set_mark(void)
1093 if (es->bottom == es->top) return 0;
1094 es->err_flags[es->top]|=ERR_FLAG_MARK;
1098 int ERR_pop_to_mark(void)
1104 while(es->bottom != es->top
1105 && (es->err_flags[es->top] & ERR_FLAG_MARK) == 0)
1107 err_clear(es,es->top);
1109 if (es->top == -1) es->top=ERR_NUM_ERRORS;
1112 if (es->bottom == es->top) return 0;
1113 es->err_flags[es->top]&=~ERR_FLAG_MARK;