]> git.ipfire.org Git - thirdparty/openssl.git/blame - doc/man3/ERR_print_errors.pod
Fix referenses in section 3 manuals
[thirdparty/openssl.git] / doc / man3 / ERR_print_errors.pod
CommitLineData
388f2f56
UM
1=pod
2
3=head1 NAME
4
c952780c
RS
5ERR_print_errors, ERR_print_errors_fp, ERR_print_errors_cb
6- print error messages
388f2f56
UM
7
8=head1 SYNOPSIS
9
10 #include <openssl/err.h>
11
12 void ERR_print_errors(BIO *bp);
13 void ERR_print_errors_fp(FILE *fp);
c952780c
RS
14 void ERR_print_errors_cb(int (*cb)(const char *str, size_t len, void *u),
15 void *u)
16
388f2f56
UM
17
18=head1 DESCRIPTION
19
20ERR_print_errors() is a convenience function that prints the error
21strings for all errors that OpenSSL has recorded to B<bp>, thus
22emptying the error queue.
23
24ERR_print_errors_fp() is the same, except that the output goes to a
25B<FILE>.
26
c952780c
RS
27ERR_print_errors_cb() is the same, except that the callback function,
28B<cb>, is called for each error line with the string, length, and userdata
29B<u> as the callback parameters.
388f2f56
UM
30
31The error strings will have the following format:
32
33 [pid]:error:[error code]:[library name]:[function name]:[reason string]:[file name]:[line]:[optional text message]
34
35I<error code> is an 8 digit hexadecimal number. I<library name>,
36I<function name> and I<reason string> are ASCII text, as is I<optional
37text message> if one was set for the respective error code.
38
39If there is no text string registered for the given error code,
40the error string will contain the numeric code.
41
42=head1 RETURN VALUES
43
44ERR_print_errors() and ERR_print_errors_fp() return no values.
45
46=head1 SEE ALSO
47
b97fdb57 48L<err(7)>, L<ERR_error_string(3)>,
f672aee4 49L<ERR_get_error(3)>.
388f2f56 50
e2f92610
RS
51=head1 COPYRIGHT
52
53Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
54
55Licensed under the OpenSSL license (the "License"). You may not use
56this file except in compliance with the License. You can obtain a copy
57in the file LICENSE in the source distribution or at
58L<https://www.openssl.org/source/license.html>.
59
60=cut