2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
13 #include "internal/cryptlib_int.h"
14 #include "internal/err.h"
15 #include "internal/err_int.h"
16 #include <openssl/err.h>
17 #include <openssl/crypto.h>
18 #include <openssl/buffer.h>
19 #include <openssl/bio.h>
20 #include <openssl/opensslconf.h>
21 #include "internal/thread_once.h"
22 #include "internal/ctype.h"
23 #include "internal/constant_time_locl.h"
26 static int err_load_strings(const ERR_STRING_DATA *str);
28 static void ERR_STATE_free(ERR_STATE *s);
29 #ifndef OPENSSL_NO_ERR
30 static ERR_STRING_DATA ERR_str_libraries[] = {
31 {ERR_PACK(ERR_LIB_NONE, 0, 0), "unknown library"},
32 {ERR_PACK(ERR_LIB_SYS, 0, 0), "system library"},
33 {ERR_PACK(ERR_LIB_BN, 0, 0), "bignum routines"},
34 {ERR_PACK(ERR_LIB_RSA, 0, 0), "rsa routines"},
35 {ERR_PACK(ERR_LIB_DH, 0, 0), "Diffie-Hellman routines"},
36 {ERR_PACK(ERR_LIB_EVP, 0, 0), "digital envelope routines"},
37 {ERR_PACK(ERR_LIB_BUF, 0, 0), "memory buffer routines"},
38 {ERR_PACK(ERR_LIB_OBJ, 0, 0), "object identifier routines"},
39 {ERR_PACK(ERR_LIB_PEM, 0, 0), "PEM routines"},
40 {ERR_PACK(ERR_LIB_DSA, 0, 0), "dsa routines"},
41 {ERR_PACK(ERR_LIB_X509, 0, 0), "x509 certificate routines"},
42 {ERR_PACK(ERR_LIB_ASN1, 0, 0), "asn1 encoding routines"},
43 {ERR_PACK(ERR_LIB_CONF, 0, 0), "configuration file routines"},
44 {ERR_PACK(ERR_LIB_CRYPTO, 0, 0), "common libcrypto routines"},
45 {ERR_PACK(ERR_LIB_EC, 0, 0), "elliptic curve routines"},
46 {ERR_PACK(ERR_LIB_ECDSA, 0, 0), "ECDSA routines"},
47 {ERR_PACK(ERR_LIB_ECDH, 0, 0), "ECDH routines"},
48 {ERR_PACK(ERR_LIB_SSL, 0, 0), "SSL routines"},
49 {ERR_PACK(ERR_LIB_BIO, 0, 0), "BIO routines"},
50 {ERR_PACK(ERR_LIB_PKCS7, 0, 0), "PKCS7 routines"},
51 {ERR_PACK(ERR_LIB_X509V3, 0, 0), "X509 V3 routines"},
52 {ERR_PACK(ERR_LIB_PKCS12, 0, 0), "PKCS12 routines"},
53 {ERR_PACK(ERR_LIB_RAND, 0, 0), "random number generator"},
54 {ERR_PACK(ERR_LIB_DSO, 0, 0), "DSO support routines"},
55 {ERR_PACK(ERR_LIB_TS, 0, 0), "time stamp routines"},
56 {ERR_PACK(ERR_LIB_ENGINE, 0, 0), "engine routines"},
57 {ERR_PACK(ERR_LIB_OCSP, 0, 0), "OCSP routines"},
58 {ERR_PACK(ERR_LIB_UI, 0, 0), "UI routines"},
59 {ERR_PACK(ERR_LIB_FIPS, 0, 0), "FIPS routines"},
60 {ERR_PACK(ERR_LIB_CMS, 0, 0), "CMS routines"},
61 {ERR_PACK(ERR_LIB_CRMF, 0, 0), "CRMF routines"},
62 {ERR_PACK(ERR_LIB_HMAC, 0, 0), "HMAC routines"},
63 {ERR_PACK(ERR_LIB_CT, 0, 0), "CT routines"},
64 {ERR_PACK(ERR_LIB_ASYNC, 0, 0), "ASYNC routines"},
65 {ERR_PACK(ERR_LIB_KDF, 0, 0), "KDF routines"},
66 {ERR_PACK(ERR_LIB_OSSL_STORE, 0, 0), "STORE routines"},
67 {ERR_PACK(ERR_LIB_SM2, 0, 0), "SM2 routines"},
68 {ERR_PACK(ERR_LIB_ESS, 0, 0), "ESS routines"},
72 static ERR_STRING_DATA ERR_str_functs[] = {
73 {ERR_PACK(0, SYS_F_FOPEN, 0), "fopen"},
74 {ERR_PACK(0, SYS_F_CONNECT, 0), "connect"},
75 {ERR_PACK(0, SYS_F_GETSERVBYNAME, 0), "getservbyname"},
76 {ERR_PACK(0, SYS_F_SOCKET, 0), "socket"},
77 {ERR_PACK(0, SYS_F_IOCTLSOCKET, 0), "ioctlsocket"},
78 {ERR_PACK(0, SYS_F_BIND, 0), "bind"},
79 {ERR_PACK(0, SYS_F_LISTEN, 0), "listen"},
80 {ERR_PACK(0, SYS_F_ACCEPT, 0), "accept"},
81 # ifdef OPENSSL_SYS_WINDOWS
82 {ERR_PACK(0, SYS_F_WSASTARTUP, 0), "WSAstartup"},
84 {ERR_PACK(0, SYS_F_OPENDIR, 0), "opendir"},
85 {ERR_PACK(0, SYS_F_FREAD, 0), "fread"},
86 {ERR_PACK(0, SYS_F_GETADDRINFO, 0), "getaddrinfo"},
87 {ERR_PACK(0, SYS_F_GETNAMEINFO, 0), "getnameinfo"},
88 {ERR_PACK(0, SYS_F_SETSOCKOPT, 0), "setsockopt"},
89 {ERR_PACK(0, SYS_F_GETSOCKOPT, 0), "getsockopt"},
90 {ERR_PACK(0, SYS_F_GETSOCKNAME, 0), "getsockname"},
91 {ERR_PACK(0, SYS_F_GETHOSTBYNAME, 0), "gethostbyname"},
92 {ERR_PACK(0, SYS_F_FFLUSH, 0), "fflush"},
93 {ERR_PACK(0, SYS_F_OPEN, 0), "open"},
94 {ERR_PACK(0, SYS_F_CLOSE, 0), "close"},
95 {ERR_PACK(0, SYS_F_IOCTL, 0), "ioctl"},
96 {ERR_PACK(0, SYS_F_STAT, 0), "stat"},
97 {ERR_PACK(0, SYS_F_FCNTL, 0), "fcntl"},
98 {ERR_PACK(0, SYS_F_FSTAT, 0), "fstat"},
102 static ERR_STRING_DATA ERR_str_reasons[] = {
103 {ERR_R_SYS_LIB, "system lib"},
104 {ERR_R_BN_LIB, "BN lib"},
105 {ERR_R_RSA_LIB, "RSA lib"},
106 {ERR_R_DH_LIB, "DH lib"},
107 {ERR_R_EVP_LIB, "EVP lib"},
108 {ERR_R_BUF_LIB, "BUF lib"},
109 {ERR_R_OBJ_LIB, "OBJ lib"},
110 {ERR_R_PEM_LIB, "PEM lib"},
111 {ERR_R_DSA_LIB, "DSA lib"},
112 {ERR_R_X509_LIB, "X509 lib"},
113 {ERR_R_ASN1_LIB, "ASN1 lib"},
114 {ERR_R_EC_LIB, "EC lib"},
115 {ERR_R_BIO_LIB, "BIO lib"},
116 {ERR_R_PKCS7_LIB, "PKCS7 lib"},
117 {ERR_R_X509V3_LIB, "X509V3 lib"},
118 {ERR_R_ENGINE_LIB, "ENGINE lib"},
119 {ERR_R_UI_LIB, "UI lib"},
120 {ERR_R_OSSL_STORE_LIB, "STORE lib"},
121 {ERR_R_ECDSA_LIB, "ECDSA lib"},
123 {ERR_R_NESTED_ASN1_ERROR, "nested asn1 error"},
124 {ERR_R_MISSING_ASN1_EOS, "missing asn1 eos"},
126 {ERR_R_FATAL, "fatal"},
127 {ERR_R_MALLOC_FAILURE, "malloc failure"},
128 {ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED,
129 "called a function you should not call"},
130 {ERR_R_PASSED_NULL_PARAMETER, "passed a null parameter"},
131 {ERR_R_INTERNAL_ERROR, "internal error"},
132 {ERR_R_DISABLED, "called a function that was disabled at compile-time"},
133 {ERR_R_INIT_FAIL, "init fail"},
134 {ERR_R_OPERATION_FAIL, "operation fail"},
140 static CRYPTO_ONCE err_init = CRYPTO_ONCE_STATIC_INIT;
141 static int set_err_thread_local;
142 static CRYPTO_THREAD_LOCAL err_thread_local;
144 static CRYPTO_ONCE err_string_init = CRYPTO_ONCE_STATIC_INIT;
145 static CRYPTO_RWLOCK *err_string_lock;
147 static ERR_STRING_DATA *int_err_get_item(const ERR_STRING_DATA *);
153 static LHASH_OF(ERR_STRING_DATA) *int_error_hash = NULL;
154 static int int_err_library_number = ERR_LIB_USER;
156 static unsigned long get_error_values(int inc, int top, const char **file,
157 int *line, const char **data,
160 static unsigned long err_string_data_hash(const ERR_STRING_DATA *a)
162 unsigned long ret, l;
165 ret = l ^ ERR_GET_LIB(l) ^ ERR_GET_FUNC(l);
166 return (ret ^ ret % 19 * 13);
169 static int err_string_data_cmp(const ERR_STRING_DATA *a,
170 const ERR_STRING_DATA *b)
172 if (a->error == b->error)
174 return a->error > b->error ? 1 : -1;
177 static ERR_STRING_DATA *int_err_get_item(const ERR_STRING_DATA *d)
179 ERR_STRING_DATA *p = NULL;
181 CRYPTO_THREAD_read_lock(err_string_lock);
182 p = lh_ERR_STRING_DATA_retrieve(int_error_hash, d);
183 CRYPTO_THREAD_unlock(err_string_lock);
188 #ifndef OPENSSL_NO_ERR
189 /* A measurement on Linux 2018-11-21 showed about 3.5kib */
190 # define SPACE_SYS_STR_REASONS 4 * 1024
191 # define NUM_SYS_STR_REASONS 127
193 static ERR_STRING_DATA SYS_str_reasons[NUM_SYS_STR_REASONS + 1];
195 * SYS_str_reasons is filled with copies of strerror() results at
196 * initialization. 'errno' values up to 127 should cover all usual errors,
197 * others will be displayed numerically by ERR_error_string. It is crucial
198 * that we have something for each reason code that occurs in
199 * ERR_str_reasons, or bogus reason strings will be returned for SYSerr(),
200 * which always gets an errno value and never one of those 'standard' reason
204 static void build_SYS_str_reasons(void)
206 /* OPENSSL_malloc cannot be used here, use static storage instead */
207 static char strerror_pool[SPACE_SYS_STR_REASONS];
208 char *cur = strerror_pool;
212 int saveerrno = get_last_sys_error();
214 CRYPTO_THREAD_write_lock(err_string_lock);
216 CRYPTO_THREAD_unlock(err_string_lock);
220 for (i = 1; i <= NUM_SYS_STR_REASONS; i++) {
221 ERR_STRING_DATA *str = &SYS_str_reasons[i - 1];
223 str->error = ERR_PACK(ERR_LIB_SYS, 0, i);
224 if (str->string == NULL) {
225 if (openssl_strerror_r(i, cur, sizeof(strerror_pool) - cnt)) {
226 size_t l = strlen(cur);
230 if (cnt > sizeof(strerror_pool))
231 cnt = sizeof(strerror_pool);
235 * VMS has an unusual quirk of adding spaces at the end of
236 * some (most? all?) messages. Lets trim them off.
238 while (ossl_isspace(cur[-1])) {
246 if (str->string == NULL)
247 str->string = "unknown";
251 * Now we still have SYS_str_reasons[NUM_SYS_STR_REASONS] = {0, NULL}, as
252 * required by ERR_load_strings.
257 CRYPTO_THREAD_unlock(err_string_lock);
258 /* openssl_strerror_r could change errno, but we want to preserve it */
259 set_sys_error(saveerrno);
260 err_load_strings(SYS_str_reasons);
264 #define err_clear_data(p, i) \
266 if ((p)->err_data_flags[i] & ERR_TXT_MALLOCED) {\
267 OPENSSL_free((p)->err_data[i]); \
268 (p)->err_data[i] = NULL; \
270 (p)->err_data_flags[i] = 0; \
273 #define err_clear(p, i) \
275 err_clear_data(p, i); \
276 (p)->err_flags[i] = 0; \
277 (p)->err_buffer[i] = 0; \
278 (p)->err_file[i] = NULL; \
279 (p)->err_line[i] = -1; \
282 static void ERR_STATE_free(ERR_STATE *s)
288 for (i = 0; i < ERR_NUM_ERRORS; i++) {
289 err_clear_data(s, i);
294 DEFINE_RUN_ONCE_STATIC(do_err_strings_init)
296 if (!OPENSSL_init_crypto(0, NULL))
298 err_string_lock = CRYPTO_THREAD_lock_new();
299 if (err_string_lock == NULL)
301 int_error_hash = lh_ERR_STRING_DATA_new(err_string_data_hash,
302 err_string_data_cmp);
303 if (int_error_hash == NULL) {
304 CRYPTO_THREAD_lock_free(err_string_lock);
305 err_string_lock = NULL;
311 void err_cleanup(void)
313 if (set_err_thread_local != 0)
314 CRYPTO_THREAD_cleanup_local(&err_thread_local);
315 CRYPTO_THREAD_lock_free(err_string_lock);
316 err_string_lock = NULL;
317 lh_ERR_STRING_DATA_free(int_error_hash);
318 int_error_hash = NULL;
322 * Legacy; pack in the library.
324 static void err_patch(int lib, ERR_STRING_DATA *str)
326 unsigned long plib = ERR_PACK(lib, 0, 0);
328 for (; str->error != 0; str++)
333 * Hash in |str| error strings. Assumes the URN_ONCE was done.
335 static int err_load_strings(const ERR_STRING_DATA *str)
337 CRYPTO_THREAD_write_lock(err_string_lock);
338 for (; str->error; str++)
339 (void)lh_ERR_STRING_DATA_insert(int_error_hash,
340 (ERR_STRING_DATA *)str);
341 CRYPTO_THREAD_unlock(err_string_lock);
345 int ERR_load_ERR_strings(void)
347 #ifndef OPENSSL_NO_ERR
348 if (!RUN_ONCE(&err_string_init, do_err_strings_init))
351 err_load_strings(ERR_str_libraries);
352 err_load_strings(ERR_str_reasons);
353 err_patch(ERR_LIB_SYS, ERR_str_functs);
354 err_load_strings(ERR_str_functs);
355 build_SYS_str_reasons();
360 int ERR_load_strings(int lib, ERR_STRING_DATA *str)
362 if (ERR_load_ERR_strings() == 0)
366 err_load_strings(str);
370 int ERR_load_strings_const(const ERR_STRING_DATA *str)
372 if (ERR_load_ERR_strings() == 0)
374 err_load_strings(str);
378 int ERR_unload_strings(int lib, ERR_STRING_DATA *str)
380 if (!RUN_ONCE(&err_string_init, do_err_strings_init))
383 CRYPTO_THREAD_write_lock(err_string_lock);
385 * We don't need to ERR_PACK the lib, since that was done (to
386 * the table) when it was loaded.
388 for (; str->error; str++)
389 (void)lh_ERR_STRING_DATA_delete(int_error_hash, str);
390 CRYPTO_THREAD_unlock(err_string_lock);
395 void err_free_strings_int(void)
397 if (!RUN_ONCE(&err_string_init, do_err_strings_init))
401 /********************************************************/
403 void ERR_put_error(int lib, int func, int reason, const char *file, int line)
409 * In the BS2000-OSD POSIX subsystem, the compiler generates path names
410 * in the form "*POSIX(/etc/passwd)". This dirty hack strips them to
411 * something sensible. @@@ We shouldn't modify a const string, though.
413 if (strncmp(file, "*POSIX(", sizeof("*POSIX(") - 1) == 0) {
416 /* Skip the "*POSIX(" prefix */
417 file += sizeof("*POSIX(") - 1;
418 end = &file[strlen(file) - 1];
421 /* Optional: use the basename of the path only. */
422 if ((end = strrchr(file, '/')) != NULL)
426 es = ERR_get_state();
430 es->top = (es->top + 1) % ERR_NUM_ERRORS;
431 if (es->top == es->bottom)
432 es->bottom = (es->bottom + 1) % ERR_NUM_ERRORS;
433 es->err_flags[es->top] = 0;
434 es->err_buffer[es->top] = ERR_PACK(lib, func, reason);
435 es->err_file[es->top] = file;
436 es->err_line[es->top] = line;
437 err_clear_data(es, es->top);
440 void ERR_clear_error(void)
445 es = ERR_get_state();
449 for (i = 0; i < ERR_NUM_ERRORS; i++) {
452 es->top = es->bottom = 0;
455 unsigned long ERR_get_error(void)
457 return get_error_values(1, 0, NULL, NULL, NULL, NULL);
460 unsigned long ERR_get_error_line(const char **file, int *line)
462 return get_error_values(1, 0, file, line, NULL, NULL);
465 unsigned long ERR_get_error_line_data(const char **file, int *line,
466 const char **data, int *flags)
468 return get_error_values(1, 0, file, line, data, flags);
471 unsigned long ERR_peek_error(void)
473 return get_error_values(0, 0, NULL, NULL, NULL, NULL);
476 unsigned long ERR_peek_error_line(const char **file, int *line)
478 return get_error_values(0, 0, file, line, NULL, NULL);
481 unsigned long ERR_peek_error_line_data(const char **file, int *line,
482 const char **data, int *flags)
484 return get_error_values(0, 0, file, line, data, flags);
487 unsigned long ERR_peek_last_error(void)
489 return get_error_values(0, 1, NULL, NULL, NULL, NULL);
492 unsigned long ERR_peek_last_error_line(const char **file, int *line)
494 return get_error_values(0, 1, file, line, NULL, NULL);
497 unsigned long ERR_peek_last_error_line_data(const char **file, int *line,
498 const char **data, int *flags)
500 return get_error_values(0, 1, file, line, data, flags);
503 static unsigned long get_error_values(int inc, int top, const char **file,
504 int *line, const char **data,
511 es = ERR_get_state();
525 return ERR_R_INTERNAL_ERROR;
528 if (es->bottom == es->top)
531 i = es->top; /* last error */
533 i = (es->bottom + 1) % ERR_NUM_ERRORS; /* first error */
535 ret = es->err_buffer[i];
538 es->err_buffer[i] = 0;
541 if (file != NULL && line != NULL) {
542 if (es->err_file[i] == NULL) {
546 *file = es->err_file[i];
547 *line = es->err_line[i];
553 err_clear_data(es, i);
556 if (es->err_data[i] == NULL) {
561 *data = es->err_data[i];
563 *flags = es->err_data_flags[i];
569 void ERR_error_string_n(unsigned long e, char *buf, size_t len)
571 char lsbuf[64], fsbuf[64], rsbuf[64];
572 const char *ls, *fs, *rs;
573 unsigned long l, f, r;
579 ls = ERR_lib_error_string(e);
581 BIO_snprintf(lsbuf, sizeof(lsbuf), "lib(%lu)", l);
585 fs = ERR_func_error_string(e);
588 BIO_snprintf(fsbuf, sizeof(fsbuf), "func(%lu)", f);
592 rs = ERR_reason_error_string(e);
593 r = ERR_GET_REASON(e);
595 BIO_snprintf(rsbuf, sizeof(rsbuf), "reason(%lu)", r);
599 BIO_snprintf(buf, len, "error:%08lX:%s:%s:%s", e, ls, fs, rs);
600 if (strlen(buf) == len - 1) {
601 /* Didn't fit; use a minimal format. */
602 BIO_snprintf(buf, len, "err:%lx:%lx:%lx:%lx", e, l, f, r);
607 * ERR_error_string_n should be used instead for ret != NULL as
608 * ERR_error_string cannot know how large the buffer is
610 char *ERR_error_string(unsigned long e, char *ret)
612 static char buf[256];
616 ERR_error_string_n(e, ret, (int)sizeof(buf));
620 const char *ERR_lib_error_string(unsigned long e)
622 ERR_STRING_DATA d, *p;
625 if (!RUN_ONCE(&err_string_init, do_err_strings_init)) {
630 d.error = ERR_PACK(l, 0, 0);
631 p = int_err_get_item(&d);
632 return ((p == NULL) ? NULL : p->string);
635 const char *ERR_func_error_string(unsigned long e)
637 ERR_STRING_DATA d, *p;
640 if (!RUN_ONCE(&err_string_init, do_err_strings_init)) {
646 d.error = ERR_PACK(l, f, 0);
647 p = int_err_get_item(&d);
648 return ((p == NULL) ? NULL : p->string);
651 const char *ERR_reason_error_string(unsigned long e)
653 ERR_STRING_DATA d, *p = NULL;
656 if (!RUN_ONCE(&err_string_init, do_err_strings_init)) {
661 r = ERR_GET_REASON(e);
662 d.error = ERR_PACK(l, 0, r);
663 p = int_err_get_item(&d);
665 d.error = ERR_PACK(0, 0, r);
666 p = int_err_get_item(&d);
668 return ((p == NULL) ? NULL : p->string);
671 void err_delete_thread_state(void)
673 ERR_STATE *state = CRYPTO_THREAD_get_local(&err_thread_local);
677 CRYPTO_THREAD_set_local(&err_thread_local, NULL);
678 ERR_STATE_free(state);
681 #if !OPENSSL_API_1_1_0
682 void ERR_remove_thread_state(void *dummy)
687 #if !OPENSSL_API_1_0_0
688 void ERR_remove_state(unsigned long pid)
693 DEFINE_RUN_ONCE_STATIC(err_do_init)
695 set_err_thread_local = 1;
696 return CRYPTO_THREAD_init_local(&err_thread_local, NULL);
699 ERR_STATE *ERR_get_state(void)
702 int saveerrno = get_last_sys_error();
704 if (!OPENSSL_init_crypto(OPENSSL_INIT_BASE_ONLY, NULL))
707 if (!RUN_ONCE(&err_init, err_do_init))
710 state = CRYPTO_THREAD_get_local(&err_thread_local);
711 if (state == (ERR_STATE*)-1)
715 if (!CRYPTO_THREAD_set_local(&err_thread_local, (ERR_STATE*)-1))
718 if ((state = OPENSSL_zalloc(sizeof(*state))) == NULL) {
719 CRYPTO_THREAD_set_local(&err_thread_local, NULL);
723 if (!ossl_init_thread_start(OPENSSL_INIT_THREAD_ERR_STATE)
724 || !CRYPTO_THREAD_set_local(&err_thread_local, state)) {
725 ERR_STATE_free(state);
726 CRYPTO_THREAD_set_local(&err_thread_local, NULL);
730 /* Ignore failures from these */
731 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CRYPTO_STRINGS, NULL);
734 set_sys_error(saveerrno);
739 * err_shelve_state returns the current thread local error state
740 * and freezes the error module until err_unshelve_state is called.
742 int err_shelve_state(void **state)
744 int saveerrno = get_last_sys_error();
747 * Note, at present our only caller is OPENSSL_init_crypto(), indirectly
748 * via ossl_init_load_crypto_nodelete(), by which point the requested
749 * "base" initialization has already been performed, so the below call is a
750 * NOOP, that re-enters OPENSSL_init_crypto() only to quickly return.
752 * If are no other valid callers of this function, the call below can be
753 * removed, avoiding the re-entry into OPENSSL_init_crypto(). If there are
754 * potential uses that are not from inside OPENSSL_init_crypto(), then this
755 * call is needed, but some care is required to make sure that the re-entry
758 if (!OPENSSL_init_crypto(OPENSSL_INIT_BASE_ONLY, NULL))
761 if (!RUN_ONCE(&err_init, err_do_init))
764 *state = CRYPTO_THREAD_get_local(&err_thread_local);
765 if (!CRYPTO_THREAD_set_local(&err_thread_local, (ERR_STATE*)-1))
768 set_sys_error(saveerrno);
773 * err_unshelve_state restores the error state that was returned
774 * by err_shelve_state previously.
776 void err_unshelve_state(void* state)
778 if (state != (void*)-1)
779 CRYPTO_THREAD_set_local(&err_thread_local, (ERR_STATE*)state);
782 int ERR_get_next_error_library(void)
786 if (!RUN_ONCE(&err_string_init, do_err_strings_init))
789 CRYPTO_THREAD_write_lock(err_string_lock);
790 ret = int_err_library_number++;
791 CRYPTO_THREAD_unlock(err_string_lock);
795 static int err_set_error_data_int(char *data, int flags)
800 es = ERR_get_state();
806 err_clear_data(es, i);
807 es->err_data[i] = data;
808 es->err_data_flags[i] = flags;
813 void ERR_set_error_data(char *data, int flags)
816 * This function is void so we cannot propagate the error return. Since it
817 * is also in the public API we can't change the return type.
819 err_set_error_data_int(data, flags);
822 void ERR_add_error_data(int num, ...)
826 ERR_add_error_vdata(num, args);
830 void ERR_add_error_vdata(int num, va_list args)
836 if ((str = OPENSSL_malloc(s + 1)) == NULL) {
837 /* ERRerr(ERR_F_ERR_ADD_ERROR_VDATA, ERR_R_MALLOC_FAILURE); */
843 for (i = 0; i < num; i++) {
844 a = va_arg(args, char *);
850 p = OPENSSL_realloc(str, s + 1);
857 OPENSSL_strlcat(str, a, (size_t)s + 1);
859 if (!err_set_error_data_int(str, ERR_TXT_MALLOCED | ERR_TXT_STRING))
863 int ERR_set_mark(void)
867 es = ERR_get_state();
871 if (es->bottom == es->top)
873 es->err_flags[es->top] |= ERR_FLAG_MARK;
877 int ERR_pop_to_mark(void)
881 es = ERR_get_state();
885 while (es->bottom != es->top
886 && (es->err_flags[es->top] & ERR_FLAG_MARK) == 0) {
887 err_clear(es, es->top);
888 es->top = es->top > 0 ? es->top - 1 : ERR_NUM_ERRORS - 1;
891 if (es->bottom == es->top)
893 es->err_flags[es->top] &= ~ERR_FLAG_MARK;
897 int ERR_clear_last_mark(void)
902 es = ERR_get_state();
907 while (es->bottom != top
908 && (es->err_flags[top] & ERR_FLAG_MARK) == 0) {
909 top = top > 0 ? top - 1 : ERR_NUM_ERRORS - 1;
912 if (es->bottom == top)
914 es->err_flags[top] &= ~ERR_FLAG_MARK;
922 * uintptr_t is the answer, but unfortunately C89, current "least common
923 * denominator" doesn't define it. Most legacy platforms typedef it anyway,
924 * so that attempt to fill the gaps means that one would have to identify
925 * that track these gaps, which would be undesirable. Macro it is...
927 #if defined(__VMS) && __INITIAL_POINTER_SIZE==64
929 * But we can't use size_t on VMS, because it adheres to sizeof(size_t)==4
930 * even in 64-bit builds, which means that it won't work as mask.
932 # define UINTPTR_T unsigned long long
934 # define UINTPTR_T size_t
937 void err_clear_last_constant_time(int clear)
942 es = ERR_get_state();
948 es->err_flags[top] &= ~(0 - clear);
949 es->err_buffer[top] &= ~(0UL - clear);
950 es->err_file[top] = (const char *)((UINTPTR_T)es->err_file[top] &
951 ~((UINTPTR_T)0 - clear));
952 es->err_line[top] |= 0 - clear;
954 es->top = (top + ERR_NUM_ERRORS - clear) % ERR_NUM_ERRORS;