2 * Copyright 1995-2020 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
10 /* TODO: When ERR_STATE becomes opaque, this musts be removed */
11 #define OSSL_FORCE_ERR_STATE
16 #include "crypto/cryptlib.h"
17 #include "internal/err.h"
18 #include "crypto/err.h"
19 #include <openssl/err.h>
20 #include <openssl/crypto.h>
21 #include <openssl/buffer.h>
22 #include <openssl/bio.h>
23 #include <openssl/opensslconf.h>
24 #include "internal/thread_once.h"
25 #include "crypto/ctype.h"
26 #include "internal/constant_time.h"
28 #include "err_local.h"
30 /* Forward declaration in case it's not published because of configuration */
31 ERR_STATE
*ERR_get_state(void);
33 static int err_load_strings(const ERR_STRING_DATA
*str
);
35 static void ERR_STATE_free(ERR_STATE
*s
);
36 #ifndef OPENSSL_NO_ERR
37 static ERR_STRING_DATA ERR_str_libraries
[] = {
38 {ERR_PACK(ERR_LIB_NONE
, 0, 0), "unknown library"},
39 {ERR_PACK(ERR_LIB_SYS
, 0, 0), "system library"},
40 {ERR_PACK(ERR_LIB_BN
, 0, 0), "bignum routines"},
41 {ERR_PACK(ERR_LIB_RSA
, 0, 0), "rsa routines"},
42 {ERR_PACK(ERR_LIB_DH
, 0, 0), "Diffie-Hellman routines"},
43 {ERR_PACK(ERR_LIB_EVP
, 0, 0), "digital envelope routines"},
44 {ERR_PACK(ERR_LIB_BUF
, 0, 0), "memory buffer routines"},
45 {ERR_PACK(ERR_LIB_OBJ
, 0, 0), "object identifier routines"},
46 {ERR_PACK(ERR_LIB_PEM
, 0, 0), "PEM routines"},
47 {ERR_PACK(ERR_LIB_DSA
, 0, 0), "dsa routines"},
48 {ERR_PACK(ERR_LIB_X509
, 0, 0), "x509 certificate routines"},
49 {ERR_PACK(ERR_LIB_ASN1
, 0, 0), "asn1 encoding routines"},
50 {ERR_PACK(ERR_LIB_CONF
, 0, 0), "configuration file routines"},
51 {ERR_PACK(ERR_LIB_CRYPTO
, 0, 0), "common libcrypto routines"},
52 {ERR_PACK(ERR_LIB_EC
, 0, 0), "elliptic curve routines"},
53 {ERR_PACK(ERR_LIB_ECDSA
, 0, 0), "ECDSA routines"},
54 {ERR_PACK(ERR_LIB_ECDH
, 0, 0), "ECDH routines"},
55 {ERR_PACK(ERR_LIB_SSL
, 0, 0), "SSL routines"},
56 {ERR_PACK(ERR_LIB_BIO
, 0, 0), "BIO routines"},
57 {ERR_PACK(ERR_LIB_PKCS7
, 0, 0), "PKCS7 routines"},
58 {ERR_PACK(ERR_LIB_X509V3
, 0, 0), "X509 V3 routines"},
59 {ERR_PACK(ERR_LIB_PKCS12
, 0, 0), "PKCS12 routines"},
60 {ERR_PACK(ERR_LIB_RAND
, 0, 0), "random number generator"},
61 {ERR_PACK(ERR_LIB_DSO
, 0, 0), "DSO support routines"},
62 {ERR_PACK(ERR_LIB_TS
, 0, 0), "time stamp routines"},
63 {ERR_PACK(ERR_LIB_ENGINE
, 0, 0), "engine routines"},
64 {ERR_PACK(ERR_LIB_OCSP
, 0, 0), "OCSP routines"},
65 {ERR_PACK(ERR_LIB_UI
, 0, 0), "UI routines"},
66 {ERR_PACK(ERR_LIB_FIPS
, 0, 0), "FIPS routines"},
67 {ERR_PACK(ERR_LIB_CMS
, 0, 0), "CMS routines"},
68 {ERR_PACK(ERR_LIB_CRMF
, 0, 0), "CRMF routines"},
69 {ERR_PACK(ERR_LIB_CMP
, 0, 0), "CMP routines"},
70 {ERR_PACK(ERR_LIB_HMAC
, 0, 0), "HMAC routines"},
71 {ERR_PACK(ERR_LIB_CT
, 0, 0), "CT routines"},
72 {ERR_PACK(ERR_LIB_ASYNC
, 0, 0), "ASYNC routines"},
73 {ERR_PACK(ERR_LIB_KDF
, 0, 0), "KDF routines"},
74 {ERR_PACK(ERR_LIB_OSSL_STORE
, 0, 0), "STORE routines"},
75 {ERR_PACK(ERR_LIB_SM2
, 0, 0), "SM2 routines"},
76 {ERR_PACK(ERR_LIB_ESS
, 0, 0), "ESS routines"},
77 {ERR_PACK(ERR_LIB_PROV
, 0, 0), "Provider routines"},
78 {ERR_PACK(ERR_LIB_OSSL_ENCODER
, 0, 0), "ENCODER routines"},
79 {ERR_PACK(ERR_LIB_OSSL_DECODER
, 0, 0), "DECODER routines"},
80 {ERR_PACK(ERR_LIB_HTTP
, 0, 0), "HTTP routines"},
84 static ERR_STRING_DATA ERR_str_reasons
[] = {
85 {ERR_R_SYS_LIB
, "system lib"},
86 {ERR_R_BN_LIB
, "BN lib"},
87 {ERR_R_RSA_LIB
, "RSA lib"},
88 {ERR_R_DH_LIB
, "DH lib"},
89 {ERR_R_EVP_LIB
, "EVP lib"},
90 {ERR_R_BUF_LIB
, "BUF lib"},
91 {ERR_R_OBJ_LIB
, "OBJ lib"},
92 {ERR_R_PEM_LIB
, "PEM lib"},
93 {ERR_R_DSA_LIB
, "DSA lib"},
94 {ERR_R_X509_LIB
, "X509 lib"},
95 {ERR_R_ASN1_LIB
, "ASN1 lib"},
96 {ERR_R_EC_LIB
, "EC lib"},
97 {ERR_R_BIO_LIB
, "BIO lib"},
98 {ERR_R_PKCS7_LIB
, "PKCS7 lib"},
99 {ERR_R_X509V3_LIB
, "X509V3 lib"},
100 {ERR_R_ENGINE_LIB
, "ENGINE lib"},
101 {ERR_R_UI_LIB
, "UI lib"},
102 {ERR_R_OSSL_STORE_LIB
, "STORE lib"},
103 {ERR_R_ECDSA_LIB
, "ECDSA lib"},
105 {ERR_R_NESTED_ASN1_ERROR
, "nested asn1 error"},
106 {ERR_R_MISSING_ASN1_EOS
, "missing asn1 eos"},
108 {ERR_R_FATAL
, "fatal"},
109 {ERR_R_MALLOC_FAILURE
, "malloc failure"},
110 {ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
,
111 "called a function you should not call"},
112 {ERR_R_PASSED_NULL_PARAMETER
, "passed a null parameter"},
113 {ERR_R_INTERNAL_ERROR
, "internal error"},
114 {ERR_R_DISABLED
, "called a function that was disabled at compile-time"},
115 {ERR_R_INIT_FAIL
, "init fail"},
116 {ERR_R_OPERATION_FAIL
, "operation fail"},
117 {ERR_R_INVALID_PROVIDER_FUNCTIONS
, "invalid provider functions"},
118 {ERR_R_INTERRUPTED_OR_CANCELLED
, "interrupted or cancelled"},
124 static CRYPTO_ONCE err_init
= CRYPTO_ONCE_STATIC_INIT
;
125 static int set_err_thread_local
;
126 static CRYPTO_THREAD_LOCAL err_thread_local
;
128 static CRYPTO_ONCE err_string_init
= CRYPTO_ONCE_STATIC_INIT
;
129 static CRYPTO_RWLOCK
*err_string_lock
;
131 static ERR_STRING_DATA
*int_err_get_item(const ERR_STRING_DATA
*);
137 static LHASH_OF(ERR_STRING_DATA
) *int_error_hash
= NULL
;
138 static int int_err_library_number
= ERR_LIB_USER
;
140 typedef enum ERR_GET_ACTION_e
{
141 EV_POP
, EV_PEEK
, EV_PEEK_LAST
144 static unsigned long get_error_values(ERR_GET_ACTION g
,
145 const char **file
, int *line
,
146 const char **func
, const char **data
,
149 static unsigned long err_string_data_hash(const ERR_STRING_DATA
*a
)
151 unsigned long ret
, l
;
154 ret
= l
^ ERR_GET_LIB(l
);
155 return (ret
^ ret
% 19 * 13);
158 static int err_string_data_cmp(const ERR_STRING_DATA
*a
,
159 const ERR_STRING_DATA
*b
)
161 if (a
->error
== b
->error
)
163 return a
->error
> b
->error
? 1 : -1;
166 static ERR_STRING_DATA
*int_err_get_item(const ERR_STRING_DATA
*d
)
168 ERR_STRING_DATA
*p
= NULL
;
170 CRYPTO_THREAD_read_lock(err_string_lock
);
171 p
= lh_ERR_STRING_DATA_retrieve(int_error_hash
, d
);
172 CRYPTO_THREAD_unlock(err_string_lock
);
177 static void ERR_STATE_free(ERR_STATE
*s
)
183 for (i
= 0; i
< ERR_NUM_ERRORS
; i
++) {
184 err_clear_data(s
, i
, 1);
189 DEFINE_RUN_ONCE_STATIC(do_err_strings_init
)
191 if (!OPENSSL_init_crypto(0, NULL
))
193 err_string_lock
= CRYPTO_THREAD_lock_new();
194 if (err_string_lock
== NULL
)
196 int_error_hash
= lh_ERR_STRING_DATA_new(err_string_data_hash
,
197 err_string_data_cmp
);
198 if (int_error_hash
== NULL
) {
199 CRYPTO_THREAD_lock_free(err_string_lock
);
200 err_string_lock
= NULL
;
206 void err_cleanup(void)
208 if (set_err_thread_local
!= 0)
209 CRYPTO_THREAD_cleanup_local(&err_thread_local
);
210 CRYPTO_THREAD_lock_free(err_string_lock
);
211 err_string_lock
= NULL
;
212 lh_ERR_STRING_DATA_free(int_error_hash
);
213 int_error_hash
= NULL
;
217 * Legacy; pack in the library.
219 static void err_patch(int lib
, ERR_STRING_DATA
*str
)
221 unsigned long plib
= ERR_PACK(lib
, 0, 0);
223 for (; str
->error
!= 0; str
++)
228 * Hash in |str| error strings. Assumes the RUN_ONCE was done.
230 static int err_load_strings(const ERR_STRING_DATA
*str
)
232 CRYPTO_THREAD_write_lock(err_string_lock
);
233 for (; str
->error
; str
++)
234 (void)lh_ERR_STRING_DATA_insert(int_error_hash
,
235 (ERR_STRING_DATA
*)str
);
236 CRYPTO_THREAD_unlock(err_string_lock
);
240 int err_load_ERR_strings_int(void)
242 #ifndef OPENSSL_NO_ERR
243 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
))
246 err_load_strings(ERR_str_libraries
);
247 err_load_strings(ERR_str_reasons
);
252 int ERR_load_strings(int lib
, ERR_STRING_DATA
*str
)
254 if (err_load_ERR_strings_int() == 0)
258 err_load_strings(str
);
262 int ERR_load_strings_const(const ERR_STRING_DATA
*str
)
264 if (err_load_ERR_strings_int() == 0)
266 err_load_strings(str
);
270 int ERR_unload_strings(int lib
, ERR_STRING_DATA
*str
)
272 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
))
275 CRYPTO_THREAD_write_lock(err_string_lock
);
277 * We don't need to ERR_PACK the lib, since that was done (to
278 * the table) when it was loaded.
280 for (; str
->error
; str
++)
281 (void)lh_ERR_STRING_DATA_delete(int_error_hash
, str
);
282 CRYPTO_THREAD_unlock(err_string_lock
);
287 void err_free_strings_int(void)
289 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
))
293 /********************************************************/
295 void ERR_clear_error(void)
300 es
= err_get_state_int();
304 for (i
= 0; i
< ERR_NUM_ERRORS
; i
++) {
307 es
->top
= es
->bottom
= 0;
310 unsigned long ERR_get_error(void)
312 return get_error_values(EV_POP
, NULL
, NULL
, NULL
, NULL
, NULL
);
315 unsigned long ERR_get_error_all(const char **file
, int *line
,
317 const char **data
, int *flags
)
319 return get_error_values(EV_POP
, file
, line
, func
, data
, flags
);
322 #ifndef OPENSSL_NO_DEPRECATED_3_0
323 unsigned long ERR_get_error_line(const char **file
, int *line
)
325 return get_error_values(EV_POP
, file
, line
, NULL
, NULL
, NULL
);
328 unsigned long ERR_get_error_line_data(const char **file
, int *line
,
329 const char **data
, int *flags
)
331 return get_error_values(EV_POP
, file
, line
, NULL
, data
, flags
);
335 unsigned long ERR_peek_error(void)
337 return get_error_values(EV_PEEK
, NULL
, NULL
, NULL
, NULL
, NULL
);
340 unsigned long ERR_peek_error_line(const char **file
, int *line
)
342 return get_error_values(EV_PEEK
, file
, line
, NULL
, NULL
, NULL
);
345 unsigned long ERR_peek_error_func(const char **func
)
347 return get_error_values(EV_PEEK
, NULL
, NULL
, func
, NULL
, NULL
);
350 unsigned long ERR_peek_error_data(const char **data
, int *flags
)
352 return get_error_values(EV_PEEK
, NULL
, NULL
, NULL
, data
, flags
);
355 unsigned long ERR_peek_error_all(const char **file
, int *line
,
357 const char **data
, int *flags
)
359 return get_error_values(EV_PEEK
, file
, line
, func
, data
, flags
);
362 #ifndef OPENSSL_NO_DEPRECATED_3_0
363 unsigned long ERR_peek_error_line_data(const char **file
, int *line
,
364 const char **data
, int *flags
)
366 return get_error_values(EV_PEEK
, file
, line
, NULL
, data
, flags
);
370 unsigned long ERR_peek_last_error(void)
372 return get_error_values(EV_PEEK_LAST
, NULL
, NULL
, NULL
, NULL
, NULL
);
375 unsigned long ERR_peek_last_error_line(const char **file
, int *line
)
377 return get_error_values(EV_PEEK_LAST
, file
, line
, NULL
, NULL
, NULL
);
380 unsigned long ERR_peek_last_error_func(const char **func
)
382 return get_error_values(EV_PEEK_LAST
, NULL
, NULL
, func
, NULL
, NULL
);
385 unsigned long ERR_peek_last_error_data(const char **data
, int *flags
)
387 return get_error_values(EV_PEEK_LAST
, NULL
, NULL
, NULL
, data
, flags
);
390 unsigned long ERR_peek_last_error_all(const char **file
, int *line
,
392 const char **data
, int *flags
)
394 return get_error_values(EV_PEEK_LAST
, file
, line
, func
, data
, flags
);
397 #ifndef OPENSSL_NO_DEPRECATED_3_0
398 unsigned long ERR_peek_last_error_line_data(const char **file
, int *line
,
399 const char **data
, int *flags
)
401 return get_error_values(EV_PEEK_LAST
, file
, line
, NULL
, data
, flags
);
405 static unsigned long get_error_values(ERR_GET_ACTION g
,
406 const char **file
, int *line
,
408 const char **data
, int *flags
)
414 es
= err_get_state_int();
419 * Clear anything that should have been cleared earlier. We do this
420 * here because this doesn't have constant-time issues.
422 while (es
->bottom
!= es
->top
) {
423 if (es
->err_flags
[es
->top
] & ERR_FLAG_CLEAR
) {
424 err_clear(es
, es
->top
, 0);
425 es
->top
= es
->top
> 0 ? es
->top
- 1 : ERR_NUM_ERRORS
- 1;
428 i
= (es
->bottom
+ 1) % ERR_NUM_ERRORS
;
429 if (es
->err_flags
[i
] & ERR_FLAG_CLEAR
) {
431 err_clear(es
, es
->bottom
, 0);
437 /* If everything has been cleared, the stack is empty. */
438 if (es
->bottom
== es
->top
)
441 /* Which error, the top of stack (latest one) or the first one? */
442 if (g
== EV_PEEK_LAST
)
445 i
= (es
->bottom
+ 1) % ERR_NUM_ERRORS
;
447 ret
= es
->err_buffer
[i
];
450 es
->err_buffer
[i
] = 0;
454 *file
= es
->err_file
[i
];
459 *line
= es
->err_line
[i
];
461 *func
= es
->err_func
[i
];
466 *flags
= es
->err_data_flags
[i
];
469 err_clear_data(es
, i
, 0);
472 *data
= es
->err_data
[i
];
482 void ossl_err_string_int(unsigned long e
, const char *func
,
483 char *buf
, size_t len
)
485 char lsbuf
[64], rsbuf
[256];
486 const char *ls
, *rs
= NULL
;
493 ls
= ERR_lib_error_string(e
);
495 BIO_snprintf(lsbuf
, sizeof(lsbuf
), "lib(%lu)", l
);
500 * ERR_reason_error_string() can't safely return system error strings,
501 * since it would call openssl_strerror_r(), which needs a buffer for
502 * thread safety. So for system errors, we call openssl_strerror_r()
505 r
= ERR_GET_REASON(e
);
506 #ifndef OPENSSL_NO_ERR
507 if (ERR_SYSTEM_ERROR(e
)) {
508 if (openssl_strerror_r(r
, rsbuf
, sizeof(rsbuf
)))
511 rs
= ERR_reason_error_string(e
);
515 BIO_snprintf(rsbuf
, sizeof(rsbuf
), "reason(%lu)", r
);
519 BIO_snprintf(buf
, len
, "error:%08lX:%s:%s:%s", e
, ls
, func
, rs
);
520 if (strlen(buf
) == len
- 1) {
521 /* Didn't fit; use a minimal format. */
522 BIO_snprintf(buf
, len
, "err:%lx:%lx:%lx:%lx", e
, l
, 0L, r
);
527 void ERR_error_string_n(unsigned long e
, char *buf
, size_t len
)
529 ossl_err_string_int(e
, "", buf
, len
);
533 * ERR_error_string_n should be used instead for ret != NULL as
534 * ERR_error_string cannot know how large the buffer is
536 char *ERR_error_string(unsigned long e
, char *ret
)
538 static char buf
[256];
542 ERR_error_string_n(e
, ret
, (int)sizeof(buf
));
546 const char *ERR_lib_error_string(unsigned long e
)
548 ERR_STRING_DATA d
, *p
;
551 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
)) {
556 d
.error
= ERR_PACK(l
, 0, 0);
557 p
= int_err_get_item(&d
);
558 return ((p
== NULL
) ? NULL
: p
->string
);
561 #ifndef OPENSSL_NO_DEPRECATED_3_0
562 const char *ERR_func_error_string(unsigned long e
)
568 const char *ERR_reason_error_string(unsigned long e
)
570 ERR_STRING_DATA d
, *p
= NULL
;
573 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
)) {
578 * ERR_reason_error_string() can't safely return system error strings,
579 * since openssl_strerror_r() needs a buffer for thread safety, and we
580 * haven't got one that would serve any sensible purpose.
582 if (ERR_SYSTEM_ERROR(e
))
586 r
= ERR_GET_REASON(e
);
587 d
.error
= ERR_PACK(l
, 0, r
);
588 p
= int_err_get_item(&d
);
590 d
.error
= ERR_PACK(0, 0, r
);
591 p
= int_err_get_item(&d
);
593 return ((p
== NULL
) ? NULL
: p
->string
);
596 /* TODO(3.0): arg ignored for now */
597 static void err_delete_thread_state(void *arg
)
599 ERR_STATE
*state
= CRYPTO_THREAD_get_local(&err_thread_local
);
603 CRYPTO_THREAD_set_local(&err_thread_local
, NULL
);
604 ERR_STATE_free(state
);
607 #ifndef OPENSSL_NO_DEPRECATED_1_1_0
608 void ERR_remove_thread_state(void *dummy
)
613 #ifndef OPENSSL_NO_DEPRECATED_1_0_0
614 void ERR_remove_state(unsigned long pid
)
619 DEFINE_RUN_ONCE_STATIC(err_do_init
)
621 set_err_thread_local
= 1;
622 return CRYPTO_THREAD_init_local(&err_thread_local
, NULL
);
625 ERR_STATE
*err_get_state_int(void)
628 int saveerrno
= get_last_sys_error();
630 if (!OPENSSL_init_crypto(OPENSSL_INIT_BASE_ONLY
, NULL
))
633 if (!RUN_ONCE(&err_init
, err_do_init
))
636 state
= CRYPTO_THREAD_get_local(&err_thread_local
);
637 if (state
== (ERR_STATE
*)-1)
641 if (!CRYPTO_THREAD_set_local(&err_thread_local
, (ERR_STATE
*)-1))
644 if ((state
= OPENSSL_zalloc(sizeof(*state
))) == NULL
) {
645 CRYPTO_THREAD_set_local(&err_thread_local
, NULL
);
649 if (!ossl_init_thread_start(NULL
, NULL
, err_delete_thread_state
)
650 || !CRYPTO_THREAD_set_local(&err_thread_local
, state
)) {
651 ERR_STATE_free(state
);
652 CRYPTO_THREAD_set_local(&err_thread_local
, NULL
);
656 /* Ignore failures from these */
657 OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CRYPTO_STRINGS
, NULL
);
660 set_sys_error(saveerrno
);
664 #ifndef OPENSSL_NO_DEPRECATED_3_0
665 ERR_STATE
*ERR_get_state(void)
667 return err_get_state_int();
673 * err_shelve_state returns the current thread local error state
674 * and freezes the error module until err_unshelve_state is called.
676 int err_shelve_state(void **state
)
678 int saveerrno
= get_last_sys_error();
681 * Note, at present our only caller is OPENSSL_init_crypto(), indirectly
682 * via ossl_init_load_crypto_nodelete(), by which point the requested
683 * "base" initialization has already been performed, so the below call is a
684 * NOOP, that re-enters OPENSSL_init_crypto() only to quickly return.
686 * If are no other valid callers of this function, the call below can be
687 * removed, avoiding the re-entry into OPENSSL_init_crypto(). If there are
688 * potential uses that are not from inside OPENSSL_init_crypto(), then this
689 * call is needed, but some care is required to make sure that the re-entry
692 if (!OPENSSL_init_crypto(OPENSSL_INIT_BASE_ONLY
, NULL
))
695 if (!RUN_ONCE(&err_init
, err_do_init
))
698 *state
= CRYPTO_THREAD_get_local(&err_thread_local
);
699 if (!CRYPTO_THREAD_set_local(&err_thread_local
, (ERR_STATE
*)-1))
702 set_sys_error(saveerrno
);
707 * err_unshelve_state restores the error state that was returned
708 * by err_shelve_state previously.
710 void err_unshelve_state(void* state
)
712 if (state
!= (void*)-1)
713 CRYPTO_THREAD_set_local(&err_thread_local
, (ERR_STATE
*)state
);
716 int ERR_get_next_error_library(void)
720 if (!RUN_ONCE(&err_string_init
, do_err_strings_init
))
723 CRYPTO_THREAD_write_lock(err_string_lock
);
724 ret
= int_err_library_number
++;
725 CRYPTO_THREAD_unlock(err_string_lock
);
729 static int err_set_error_data_int(char *data
, size_t size
, int flags
,
734 es
= err_get_state_int();
738 err_clear_data(es
, es
->top
, deallocate
);
739 err_set_data(es
, es
->top
, data
, size
, flags
);
744 void ERR_set_error_data(char *data
, int flags
)
747 * This function is void so we cannot propagate the error return. Since it
748 * is also in the public API we can't change the return type.
750 * We estimate the size of the data. If it's not flagged as allocated,
751 * then this is safe, and if it is flagged as allocated, then our size
752 * may be smaller than the actual allocation, but that doesn't matter
753 * too much, the buffer will remain untouched or will eventually be
754 * reallocated to a new size.
756 * callers should be advised that this function takes over ownership of
757 * the allocated memory, i.e. they can't count on the pointer to remain
760 err_set_error_data_int(data
, strlen(data
) + 1, flags
, 1);
763 void ERR_add_error_data(int num
, ...)
767 ERR_add_error_vdata(num
, args
);
771 void ERR_add_error_vdata(int num
, va_list args
)
774 int flags
= ERR_TXT_MALLOCED
| ERR_TXT_STRING
;
778 /* Get the current error data; if an allocated string get it. */
779 es
= err_get_state_int();
785 * If err_data is allocated already, re-use the space.
786 * Otherwise, allocate a small new buffer.
788 if ((es
->err_data_flags
[i
] & flags
) == flags
) {
789 str
= es
->err_data
[i
];
790 size
= es
->err_data_size
[i
];
793 * To protect the string we just grabbed from tampering by other
794 * functions we may call, or to protect them from freeing a pointer
795 * that may no longer be valid at that point, we clear away the
796 * data pointer and the flags. We will set them again at the end
799 es
->err_data
[i
] = NULL
;
800 es
->err_data_flags
[i
] = 0;
801 } else if ((str
= OPENSSL_malloc(size
= 81)) == NULL
) {
809 arg
= va_arg(args
, char *);
817 p
= OPENSSL_realloc(str
, size
);
824 OPENSSL_strlcat(str
, arg
, (size_t)size
);
826 if (!err_set_error_data_int(str
, size
, flags
, 0))
830 int ERR_set_mark(void)
834 es
= err_get_state_int();
838 if (es
->bottom
== es
->top
)
840 es
->err_marks
[es
->top
]++;
844 int ERR_pop_to_mark(void)
848 es
= err_get_state_int();
852 while (es
->bottom
!= es
->top
853 && es
->err_marks
[es
->top
] == 0) {
854 err_clear(es
, es
->top
, 0);
855 es
->top
= es
->top
> 0 ? es
->top
- 1 : ERR_NUM_ERRORS
- 1;
858 if (es
->bottom
== es
->top
)
860 es
->err_marks
[es
->top
]--;
864 int ERR_clear_last_mark(void)
869 es
= err_get_state_int();
874 while (es
->bottom
!= top
875 && es
->err_marks
[top
] == 0) {
876 top
= top
> 0 ? top
- 1 : ERR_NUM_ERRORS
- 1;
879 if (es
->bottom
== top
)
881 es
->err_marks
[top
]--;
885 void err_clear_last_constant_time(int clear
)
890 es
= err_get_state_int();
897 * Flag error as cleared but remove it elsewhere to avoid two errors
898 * accessing the same error stack location, revealing timing information.
900 clear
= constant_time_select_int(constant_time_eq_int(clear
, 0),
902 es
->err_flags
[top
] |= clear
;