xref: /openbsd-src/lib/libcrypto/err/err.c (revision b2ea75c1b17e1a9a339660e7ed45cd24946b230e)
1 /* crypto/err/err.c */
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  * Copyright (c) 1998-2000 The OpenSSL Project.  All rights reserved.
60  *
61  * Redistribution and use in source and binary forms, with or without
62  * modification, are permitted provided that the following conditions
63  * are met:
64  *
65  * 1. Redistributions of source code must retain the above copyright
66  *    notice, this list of conditions and the following disclaimer.
67  *
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
71  *    distribution.
72  *
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/)"
77  *
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.
82  *
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.
86  *
87  * 6. Redistributions of any form whatsoever must retain the following
88  *    acknowledgment:
89  *    "This product includes software developed by the OpenSSL Project
90  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
91  *
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  * ====================================================================
105  *
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).
109  *
110  */
111 
112 #include <stdio.h>
113 #include <stdarg.h>
114 #include <string.h>
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>
121 
122 
123 static LHASH *error_hash=NULL;
124 static LHASH *thread_hash=NULL;
125 
126 static unsigned long err_hash(ERR_STRING_DATA *a);
127 static int err_cmp(ERR_STRING_DATA *a, ERR_STRING_DATA *b);
128 static unsigned long pid_hash(ERR_STATE *pid);
129 static int pid_cmp(ERR_STATE *a,ERR_STATE *pid);
130 static unsigned long get_error_values(int inc,const char **file,int *line,
131 				      const char **data,int *flags);
132 static void ERR_STATE_free(ERR_STATE *s);
133 #ifndef NO_ERR
134 static ERR_STRING_DATA ERR_str_libraries[]=
135 	{
136 {ERR_PACK(ERR_LIB_NONE,0,0)		,"unknown library"},
137 {ERR_PACK(ERR_LIB_SYS,0,0)		,"system library"},
138 {ERR_PACK(ERR_LIB_BN,0,0)		,"bignum routines"},
139 {ERR_PACK(ERR_LIB_RSA,0,0)		,"rsa routines"},
140 {ERR_PACK(ERR_LIB_DSA,0,0)		,"dsa routines"},
141 {ERR_PACK(ERR_LIB_DH,0,0)		,"Diffie-Hellman routines"},
142 {ERR_PACK(ERR_LIB_EVP,0,0)		,"digital envelope routines"},
143 {ERR_PACK(ERR_LIB_BUF,0,0)		,"memory buffer routines"},
144 {ERR_PACK(ERR_LIB_BIO,0,0)		,"BIO routines"},
145 {ERR_PACK(ERR_LIB_OBJ,0,0)		,"object identifier routines"},
146 {ERR_PACK(ERR_LIB_PEM,0,0)		,"PEM routines"},
147 {ERR_PACK(ERR_LIB_ASN1,0,0)		,"asn1 encoding routines"},
148 {ERR_PACK(ERR_LIB_X509,0,0)		,"x509 certificate routines"},
149 {ERR_PACK(ERR_LIB_CONF,0,0)		,"configuration file routines"},
150 {ERR_PACK(ERR_LIB_METH,0,0)		,"X509 lookup 'method' routines"},
151 {ERR_PACK(ERR_LIB_SSL,0,0)		,"SSL routines"},
152 {ERR_PACK(ERR_LIB_RSAREF,0,0)		,"RSAref routines"},
153 {ERR_PACK(ERR_LIB_PROXY,0,0)		,"Proxy routines"},
154 {ERR_PACK(ERR_LIB_BIO,0,0)		,"BIO routines"},
155 {ERR_PACK(ERR_LIB_PKCS7,0,0)		,"PKCS7 routines"},
156 {ERR_PACK(ERR_LIB_X509V3,0,0)		,"X509 V3 routines"},
157 {ERR_PACK(ERR_LIB_PKCS12,0,0)		,"PKCS12 routines"},
158 {ERR_PACK(ERR_LIB_RAND,0,0)		,"random number generator"},
159 {ERR_PACK(ERR_LIB_DSO,0,0)		,"DSO support routines"},
160 {ERR_PACK(ERR_LIB_ENGINE,0,0)		,"engine routines"},
161 {0,NULL},
162 	};
163 
164 static ERR_STRING_DATA ERR_str_functs[]=
165 	{
166 	{ERR_PACK(0,SYS_F_FOPEN,0),     	"fopen"},
167 	{ERR_PACK(0,SYS_F_CONNECT,0),		"connect"},
168 	{ERR_PACK(0,SYS_F_GETSERVBYNAME,0),	"getservbyname"},
169 	{ERR_PACK(0,SYS_F_SOCKET,0),		"socket"},
170 	{ERR_PACK(0,SYS_F_IOCTLSOCKET,0),	"ioctlsocket"},
171 	{ERR_PACK(0,SYS_F_BIND,0),		"bind"},
172 	{ERR_PACK(0,SYS_F_LISTEN,0),		"listen"},
173 	{ERR_PACK(0,SYS_F_ACCEPT,0),		"accept"},
174 #ifdef WINDOWS
175 	{ERR_PACK(0,SYS_F_WSASTARTUP,0),	"WSAstartup"},
176 #endif
177 	{ERR_PACK(0,SYS_F_OPENDIR,0),		"opendir"},
178 	{0,NULL},
179 	};
180 
181 static ERR_STRING_DATA ERR_str_reasons[]=
182 	{
183 {ERR_R_FATAL                             ,"fatal"},
184 {ERR_R_SYS_LIB				,"system lib"},
185 {ERR_R_BN_LIB				,"BN lib"},
186 {ERR_R_RSA_LIB				,"RSA lib"},
187 {ERR_R_DH_LIB				,"DH lib"},
188 {ERR_R_EVP_LIB				,"EVP lib"},
189 {ERR_R_BUF_LIB				,"BUF lib"},
190 {ERR_R_BIO_LIB				,"BIO lib"},
191 {ERR_R_OBJ_LIB				,"OBJ lib"},
192 {ERR_R_PEM_LIB				,"PEM lib"},
193 {ERR_R_X509_LIB				,"X509 lib"},
194 {ERR_R_METH_LIB				,"METH lib"},
195 {ERR_R_ASN1_LIB				,"ASN1 lib"},
196 {ERR_R_CONF_LIB				,"CONF lib"},
197 {ERR_R_SSL_LIB				,"SSL lib"},
198 {ERR_R_PROXY_LIB			,"PROXY lib"},
199 {ERR_R_BIO_LIB				,"BIO lib"},
200 {ERR_R_PKCS7_LIB			,"PKCS7 lib"},
201 {ERR_R_PKCS12_LIB			,"PKCS12 lib"},
202 {ERR_R_MALLOC_FAILURE			,"Malloc failure"},
203 {ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED	,"called a function you should not call"},
204 {ERR_R_PASSED_NULL_PARAMETER		,"passed a null parameter"},
205 {ERR_R_NESTED_ASN1_ERROR		,"nested asn1 error"},
206 {ERR_R_BAD_ASN1_OBJECT_HEADER		,"bad asn1 object header"},
207 {ERR_R_BAD_GET_ASN1_OBJECT_CALL		,"bad get asn1 object call"},
208 {ERR_R_EXPECTING_AN_ASN1_SEQUENCE	,"expecting an asn1 sequence"},
209 {ERR_R_ASN1_LENGTH_MISMATCH		,"asn1 length mismatch"},
210 {ERR_R_MISSING_ASN1_EOS			,"missing asn1 eos"},
211 {ERR_R_DSO_LIB				,"DSO lib"},
212 {ERR_R_ENGINE_LIB			,"ENGINE lib"},
213 
214 {0,NULL},
215 	};
216 
217 
218 #define NUM_SYS_STR_REASONS 127
219 #define LEN_SYS_STR_REASON 32
220 
221 static ERR_STRING_DATA SYS_str_reasons[NUM_SYS_STR_REASONS + 1];
222 /* SYS_str_reasons is filled with copies of strerror() results at
223  * initialization.
224  * 'errno' values up to 127 should cover all usual errors,
225  * others will be displayed numerically by ERR_error_string.
226  * It is crucial that we have something for each reason code
227  * that occurs in ERR_str_reasons, or bogus reason strings
228  * will be returned for SYSerr(), which always gets an errno
229  * value and never one of those 'standard' reason codes. */
230 
231 static void build_SYS_str_reasons()
232 	{
233 	/* OPENSSL_malloc cannot be used here, use static storage instead */
234 	static char strerror_tab[NUM_SYS_STR_REASONS][LEN_SYS_STR_REASON];
235 	int i;
236 
237 	CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
238 
239 	for (i = 1; i <= NUM_SYS_STR_REASONS; i++)
240 		{
241 		ERR_STRING_DATA *str = &SYS_str_reasons[i - 1];
242 
243 		str->error = (unsigned long)i;
244 		if (str->string == NULL)
245 			{
246 			char (*dest)[LEN_SYS_STR_REASON] = &(strerror_tab[i - 1]);
247 			char *src = strerror(i);
248 			if (src != NULL)
249 				{
250 				strncpy(*dest, src, sizeof *dest);
251 				(*dest)[sizeof *dest - 1] = '\0';
252 				str->string = *dest;
253 				}
254 			}
255 		if (str->string == NULL)
256 			str->string = "unknown";
257 		}
258 
259 	/* Now we still have SYS_str_reasons[NUM_SYS_STR_REASONS] = {0, NULL},
260 	 * as required by ERR_load_strings. */
261 
262 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
263 	}
264 #endif
265 
266 #define err_clear_data(p,i) \
267 	if (((p)->err_data[i] != NULL) && \
268 		(p)->err_data_flags[i] & ERR_TXT_MALLOCED) \
269 		{  \
270 		OPENSSL_free((p)->err_data[i]); \
271 		(p)->err_data[i]=NULL; \
272 		} \
273 	(p)->err_data_flags[i]=0;
274 
275 static void ERR_STATE_free(ERR_STATE *s)
276 	{
277 	int i;
278 
279 	if(s == NULL)
280 	    return;
281 
282 	for (i=0; i<ERR_NUM_ERRORS; i++)
283 		{
284 		err_clear_data(s,i);
285 		}
286 	OPENSSL_free(s);
287 	}
288 
289 void ERR_load_ERR_strings(void)
290 	{
291 	static int init=1;
292 
293 	if (init)
294 		{
295 		CRYPTO_w_lock(CRYPTO_LOCK_ERR);
296 		if (init == 0)
297 			{
298 			CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
299 			return;
300 			}
301 		CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
302 
303 #ifndef NO_ERR
304 		ERR_load_strings(0,ERR_str_libraries);
305 		ERR_load_strings(0,ERR_str_reasons);
306 		ERR_load_strings(ERR_LIB_SYS,ERR_str_functs);
307 		build_SYS_str_reasons();
308 		ERR_load_strings(ERR_LIB_SYS,SYS_str_reasons);
309 #endif
310 		init=0;
311 		}
312 	}
313 
314 void ERR_load_strings(int lib, ERR_STRING_DATA *str)
315 	{
316 	if (error_hash == NULL)
317 		{
318 		CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
319 		error_hash=lh_new(err_hash,err_cmp);
320 		if (error_hash == NULL)
321 			{
322 			CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
323 			return;
324 			}
325 		CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
326 
327 		ERR_load_ERR_strings();
328 		}
329 
330 	CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
331 	while (str->error)
332 		{
333 		str->error|=ERR_PACK(lib,0,0);
334 		lh_insert(error_hash,str);
335 		str++;
336 		}
337 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
338 	}
339 
340 void ERR_free_strings(void)
341 	{
342 	CRYPTO_w_lock(CRYPTO_LOCK_ERR);
343 
344 	if (error_hash != NULL)
345 		{
346 		lh_free(error_hash);
347 		error_hash=NULL;
348 		}
349 
350 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
351 	}
352 
353 /********************************************************/
354 
355 void ERR_put_error(int lib, int func, int reason, const char *file,
356 	     int line)
357 	{
358 	ERR_STATE *es;
359 
360 #ifdef _OSD_POSIX
361 	/* In the BS2000-OSD POSIX subsystem, the compiler generates
362 	 * path names in the form "*POSIX(/etc/passwd)".
363 	 * This dirty hack strips them to something sensible.
364 	 * @@@ We shouldn't modify a const string, though.
365 	 */
366 	if (strncmp(file,"*POSIX(", sizeof("*POSIX(")-1) == 0) {
367 		char *end;
368 
369 		/* Skip the "*POSIX(" prefix */
370 		file += sizeof("*POSIX(")-1;
371 		end = &file[strlen(file)-1];
372 		if (*end == ')')
373 			*end = '\0';
374 		/* Optional: use the basename of the path only. */
375 		if ((end = strrchr(file, '/')) != NULL)
376 			file = &end[1];
377 	}
378 #endif
379 	es=ERR_get_state();
380 
381 	es->top=(es->top+1)%ERR_NUM_ERRORS;
382 	if (es->top == es->bottom)
383 		es->bottom=(es->bottom+1)%ERR_NUM_ERRORS;
384 	es->err_buffer[es->top]=ERR_PACK(lib,func,reason);
385 	es->err_file[es->top]=file;
386 	es->err_line[es->top]=line;
387 	err_clear_data(es,es->top);
388 	}
389 
390 void ERR_clear_error(void)
391 	{
392 	int i;
393 	ERR_STATE *es;
394 
395 	es=ERR_get_state();
396 
397 	for (i=0; i<ERR_NUM_ERRORS; i++)
398 		{
399 		es->err_buffer[i]=0;
400 		err_clear_data(es,i);
401 		es->err_file[i]=NULL;
402 		es->err_line[i]= -1;
403 		}
404 	es->top=es->bottom=0;
405 	}
406 
407 
408 unsigned long ERR_get_error(void)
409 	{ return(get_error_values(1,NULL,NULL,NULL,NULL)); }
410 
411 unsigned long ERR_get_error_line(const char **file,
412 	     int *line)
413 	{ return(get_error_values(1,file,line,NULL,NULL)); }
414 
415 unsigned long ERR_get_error_line_data(const char **file, int *line,
416 	     const char **data, int *flags)
417 	{ return(get_error_values(1,file,line,
418 	     data,flags)); }
419 
420 unsigned long ERR_peek_error(void)
421 	{ return(get_error_values(0,NULL,NULL,NULL,NULL)); }
422 
423 unsigned long ERR_peek_error_line(const char **file,
424 	     int *line)
425 	{ return(get_error_values(0,file,line,NULL,NULL)); }
426 
427 unsigned long ERR_peek_error_line_data(const char **file, int *line,
428 	     const char **data, int *flags)
429 	{ return(get_error_values(0,file,line,
430 	     data,flags)); }
431 
432 static unsigned long get_error_values(int inc, const char **file, int *line,
433 	     const char **data, int *flags)
434 	{
435 	int i=0;
436 	ERR_STATE *es;
437 	unsigned long ret;
438 
439 	es=ERR_get_state();
440 
441 	if (es->bottom == es->top) return(0);
442 	i=(es->bottom+1)%ERR_NUM_ERRORS;
443 
444 	ret=es->err_buffer[i];
445 	if (inc)
446 		{
447 		es->bottom=i;
448 		es->err_buffer[i]=0;
449 		}
450 
451 	if ((file != NULL) && (line != NULL))
452 		{
453 		if (es->err_file[i] == NULL)
454 			{
455 			*file="NA";
456 			if (line != NULL) *line=0;
457 			}
458 		else
459 			{
460 			*file=es->err_file[i];
461 			if (line != NULL) *line=es->err_line[i];
462 			}
463 		}
464 
465 	if (data == NULL)
466 		{
467 		if (inc)
468 			{
469 			err_clear_data(es, i);
470 			}
471 		}
472 	else
473 		{
474 		if (es->err_data[i] == NULL)
475 			{
476 			*data="";
477 			if (flags != NULL) *flags=0;
478 			}
479 		else
480 			{
481 			*data=es->err_data[i];
482 			if (flags != NULL) *flags=es->err_data_flags[i];
483 			}
484 		}
485 	return(ret);
486 	}
487 
488 void ERR_error_string_n(unsigned long e, char *buf, size_t len)
489 	{
490 	char lsbuf[64], fsbuf[64], rsbuf[64];
491 	const char *ls,*fs,*rs;
492 	unsigned long l,f,r;
493 
494 	l=ERR_GET_LIB(e);
495 	f=ERR_GET_FUNC(e);
496 	r=ERR_GET_REASON(e);
497 
498 	ls=ERR_lib_error_string(e);
499 	fs=ERR_func_error_string(e);
500 	rs=ERR_reason_error_string(e);
501 
502 	if (ls == NULL)
503 		BIO_snprintf(lsbuf, sizeof(lsbuf), "lib(%lu)", l);
504 	if (fs == NULL)
505 		BIO_snprintf(fsbuf, sizeof(fsbuf), "func(%lu)", f);
506 	if (rs == NULL)
507 		BIO_snprintf(rsbuf, sizeof(rsbuf), "reason(%lu)", r);
508 
509 	BIO_snprintf(buf, len,"error:%08lX:%s:%s:%s", e, ls?ls:lsbuf,
510 		fs?fs:fsbuf, rs?rs:rsbuf);
511 	if (strlen(buf) == len-1)
512 		{
513 		/* output may be truncated; make sure we always have 5
514 		 * colon-separated fields, i.e. 4 colons ... */
515 #define NUM_COLONS 4
516 		if (len > NUM_COLONS) /* ... if possible */
517 			{
518 			int i;
519 			char *s = buf;
520 
521 			for (i = 0; i < NUM_COLONS; i++)
522 				{
523 				char *colon = strchr(s, ':');
524 				if (colon == NULL || colon > &buf[len-1] - NUM_COLONS + i)
525 					{
526 					/* set colon no. i at last possible position
527 					 * (buf[len-1] is the terminating 0)*/
528 					colon = &buf[len-1] - NUM_COLONS + i;
529 					*colon = ':';
530 					}
531 				s = colon + 1;
532 				}
533 			}
534 		}
535 	}
536 
537 /* BAD for multi-threading: uses a local buffer if ret == NULL */
538 /* ERR_error_string_n should be used instead for ret != NULL
539  * as ERR_error_string cannot know how large the buffer is */
540 char *ERR_error_string(unsigned long e, char *ret)
541 	{
542 	static char buf[256];
543 
544 	if (ret == NULL) ret=buf;
545 	ERR_error_string_n(e, ret, 256);
546 
547 	return(ret);
548 	}
549 
550 LHASH *ERR_get_string_table(void)
551 	{
552 	return(error_hash);
553 	}
554 
555 /* not thread-safe */
556 LHASH *ERR_get_err_state_table(void)
557 	{
558 	return(thread_hash);
559 	}
560 
561 const char *ERR_lib_error_string(unsigned long e)
562 	{
563 	ERR_STRING_DATA d,*p=NULL;
564 	unsigned long l;
565 
566 	l=ERR_GET_LIB(e);
567 
568 	CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
569 
570 	if (error_hash != NULL)
571 		{
572 		d.error=ERR_PACK(l,0,0);
573 		p=(ERR_STRING_DATA *)lh_retrieve(error_hash,&d);
574 		}
575 
576 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
577 
578 	return((p == NULL)?NULL:p->string);
579 	}
580 
581 const char *ERR_func_error_string(unsigned long e)
582 	{
583 	ERR_STRING_DATA d,*p=NULL;
584 	unsigned long l,f;
585 
586 	l=ERR_GET_LIB(e);
587 	f=ERR_GET_FUNC(e);
588 
589 	CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
590 
591 	if (error_hash != NULL)
592 		{
593 		d.error=ERR_PACK(l,f,0);
594 		p=(ERR_STRING_DATA *)lh_retrieve(error_hash,&d);
595 		}
596 
597 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
598 
599 	return((p == NULL)?NULL:p->string);
600 	}
601 
602 const char *ERR_reason_error_string(unsigned long e)
603 	{
604 	ERR_STRING_DATA d,*p=NULL;
605 	unsigned long l,r;
606 
607 	l=ERR_GET_LIB(e);
608 	r=ERR_GET_REASON(e);
609 
610 	CRYPTO_w_lock(CRYPTO_LOCK_ERR_HASH);
611 
612 	if (error_hash != NULL)
613 		{
614 		d.error=ERR_PACK(l,0,r);
615 		p=(ERR_STRING_DATA *)lh_retrieve(error_hash,&d);
616 		if (p == NULL)
617 			{
618 			d.error=ERR_PACK(0,0,r);
619 			p=(ERR_STRING_DATA *)lh_retrieve(error_hash,&d);
620 			}
621 		}
622 
623 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR_HASH);
624 
625 	return((p == NULL)?NULL:p->string);
626 	}
627 
628 static unsigned long err_hash(ERR_STRING_DATA *a)
629 	{
630 	unsigned long ret,l;
631 
632 	l=a->error;
633 	ret=l^ERR_GET_LIB(l)^ERR_GET_FUNC(l);
634 	return(ret^ret%19*13);
635 	}
636 
637 static int err_cmp(ERR_STRING_DATA *a, ERR_STRING_DATA *b)
638 	{
639 	return((int)(a->error-b->error));
640 	}
641 
642 static unsigned long pid_hash(ERR_STATE *a)
643 	{
644 	return(a->pid*13);
645 	}
646 
647 static int pid_cmp(ERR_STATE *a, ERR_STATE *b)
648 	{
649 	return((int)((long)a->pid - (long)b->pid));
650 	}
651 
652 void ERR_remove_state(unsigned long pid)
653 	{
654 	ERR_STATE *p = NULL,tmp;
655 
656 	if (thread_hash == NULL)
657 		return;
658 	if (pid == 0)
659 		pid=(unsigned long)CRYPTO_thread_id();
660 	tmp.pid=pid;
661 	CRYPTO_w_lock(CRYPTO_LOCK_ERR);
662 	if (thread_hash)
663 		{
664 		p=(ERR_STATE *)lh_delete(thread_hash,&tmp);
665 		if (lh_num_items(thread_hash) == 0)
666 			{
667 			/* make sure we don't leak memory */
668 			lh_free(thread_hash);
669 			thread_hash = NULL;
670 			}
671 		}
672 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
673 
674 	if (p != NULL) ERR_STATE_free(p);
675 	}
676 
677 ERR_STATE *ERR_get_state(void)
678 	{
679 	static ERR_STATE fallback;
680 	ERR_STATE *ret=NULL,tmp,*tmpp=NULL;
681 	int thread_state_exists;
682 	int i;
683 	unsigned long pid;
684 
685 	pid=(unsigned long)CRYPTO_thread_id();
686 
687 	CRYPTO_w_lock(CRYPTO_LOCK_ERR);
688 	if (thread_hash != NULL)
689 		{
690 		tmp.pid=pid;
691 		ret=(ERR_STATE *)lh_retrieve(thread_hash,&tmp);
692 		}
693 	CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
694 
695 	/* ret == the error state, if NULL, make a new one */
696 	if (ret == NULL)
697 		{
698 		ret=(ERR_STATE *)OPENSSL_malloc(sizeof(ERR_STATE));
699 		if (ret == NULL) return(&fallback);
700 		ret->pid=pid;
701 		ret->top=0;
702 		ret->bottom=0;
703 		for (i=0; i<ERR_NUM_ERRORS; i++)
704 			{
705 			ret->err_data[i]=NULL;
706 			ret->err_data_flags[i]=0;
707 			}
708 
709 		CRYPTO_w_lock(CRYPTO_LOCK_ERR);
710 
711 		/* no entry yet in thread_hash for current thread -
712 		 * thus, it may have changed since we last looked at it */
713 		if (thread_hash == NULL)
714 			thread_hash = lh_new(pid_hash, pid_cmp);
715 		if (thread_hash == NULL)
716 			thread_state_exists = 0; /* allocation error */
717 		else
718 			{
719 			tmpp=(ERR_STATE *)lh_insert(thread_hash,ret);
720 			thread_state_exists = 1;
721 			}
722 
723 		CRYPTO_w_unlock(CRYPTO_LOCK_ERR);
724 
725 		if (!thread_state_exists)
726 			{
727 			ERR_STATE_free(ret); /* could not insert it */
728 			return(&fallback);
729 			}
730 
731 		if (tmpp != NULL) /* old entry - should not happen */
732 			{
733 			ERR_STATE_free(tmpp);
734 			}
735 		}
736 	return(ret);
737 	}
738 
739 int ERR_get_next_error_library(void)
740 	{
741 	static int value=ERR_LIB_USER;
742 
743 	return(value++);
744 	}
745 
746 void ERR_set_error_data(char *data, int flags)
747 	{
748 	ERR_STATE *es;
749 	int i;
750 
751 	es=ERR_get_state();
752 
753 	i=es->top;
754 	if (i == 0)
755 		i=ERR_NUM_ERRORS-1;
756 
757 	err_clear_data(es,i);
758 	es->err_data[i]=data;
759 	es->err_data_flags[i]=flags;
760 	}
761 
762 void ERR_add_error_data(int num, ...)
763 	{
764 	va_list args;
765 	int i,n,s;
766 	char *str,*p,*a;
767 
768 	s=80;
769 	str=OPENSSL_malloc(s+1);
770 	if (str == NULL) return;
771 	str[0]='\0';
772 
773 	va_start(args, num);
774 	n=0;
775 	for (i=0; i<num; i++)
776 		{
777 		a=va_arg(args, char*);
778 		/* ignore NULLs, thanks to Bob Beck <beck@obtuse.com> */
779 		if (a != NULL)
780 			{
781 			n+=strlen(a);
782 			if (n > s)
783 				{
784 				s=n+20;
785 				p=OPENSSL_realloc(str,s+1);
786 				if (p == NULL)
787 					{
788 					OPENSSL_free(str);
789 					return;
790 					}
791 				else
792 					str=p;
793 				}
794 			strcat(str,a);
795 			}
796 		}
797 	ERR_set_error_data(str,ERR_TXT_MALLOCED|ERR_TXT_STRING);
798 
799 	va_end(args);
800 	}
801 
802