NAME
ERR_print_errors
,
ERR_print_errors_fp
,
ERR_print_errors_cb
—
print OpenSSL error messages
SYNOPSIS
#include
<openssl/err.h>
void
ERR_print_errors
(BIO *bp);
void
ERR_print_errors_fp
(FILE
*fp);
void
ERR_print_errors_cb
(int (*cb)(const
char *str, size_t len, void *u), void *u);
DESCRIPTION
ERR_print_errors
()
is a convenience function that prints the error strings for all errors that
OpenSSL has recorded to bp, thus emptying the error
queue.
ERR_print_errors_fp
()
is the same, except that the output goes to a
FILE.
ERR_print_errors_cb
()
is the same, except that the callback function, cb, is
called for each error line with the string, length, and userdata
u as the callback parameters.
The error strings have the following format:
[pid]:error:[error code]:[library name]:[function name]:[reason string]: [file name]:[line]:[optional text message]
The error code is an 8-digit hexadecimal number. The library name, the function name, and the reason string are ASCII text, as is the optional text message if one was set for the respective error code.
If there is no text string registered for the given error code, the error string will contain the numeric code.
RETURN VALUES
ERR_print_errors
() and
ERR_print_errors_fp
() return no values.
SEE ALSO
ERR(3), ERR_error_string(3), ERR_get_error(3), ERR_load_crypto_strings(3), SSL_load_error_strings(3)
HISTORY
ERR_print_errors
() first appeared in
SSLeay 0.4.5. ERR_print_errors_fp
() first appeared
in SSLeay 0.6.0. Both functions have been available since
OpenBSD 2.4.
ERR_print_errors_cb
() first appeared in
OpenSSL 0.9.7 and has been available since OpenBSD
3.2.