crypto/err/err.c

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