xref: /openssl/doc/man3/ERR_GET_LIB.pod (revision da1c088f)
1=pod
2
3=head1 NAME
4
5ERR_GET_LIB, ERR_GET_REASON, ERR_FATAL_ERROR
6- get information from error codes
7
8=head1 SYNOPSIS
9
10 #include <openssl/err.h>
11
12 int ERR_GET_LIB(unsigned long e);
13
14 int ERR_GET_REASON(unsigned long e);
15
16 int ERR_FATAL_ERROR(unsigned long e);
17
18=head1 DESCRIPTION
19
20The error code returned by ERR_get_error() consists of a library
21number and reason code. ERR_GET_LIB()
22and ERR_GET_REASON() can be used to extract these.
23
24ERR_FATAL_ERROR() indicates whether a given error code is a fatal error.
25
26The library number describes where the error
27occurred, the reason code is the information about what went wrong.
28
29Each sub-library of OpenSSL has a unique library number; the
30reason code is unique within each sub-library.  Note that different
31libraries may use the same value to signal different reasons.
32
33B<ERR_R_...> reason codes such as B<ERR_R_MALLOC_FAILURE> are globally
34unique. However, when checking for sub-library specific reason codes,
35be sure to also compare the library number.
36
37ERR_GET_LIB(), ERR_GET_REASON(), and ERR_FATAL_ERROR() are macros.
38
39=head1 RETURN VALUES
40
41The library number, reason code, and whether the error
42is fatal, respectively.
43Starting with OpenSSL 3.0.0, the function code is always set to zero.
44
45=head1 NOTES
46
47Applications should not make control flow decisions based on specific error
48codes. Error codes are subject to change at any time (even in patch releases of
49OpenSSL). A particular error code can only be considered meaningful for control
50flow decisions if it is explicitly documented as such. New failure codes may
51still appear at any time.
52
53=head1 SEE ALSO
54
55L<ERR_get_error(3)>
56
57=head1 HISTORY
58
59ERR_GET_LIB() and ERR_GET_REASON() are available in all versions of OpenSSL.
60
61ERR_GET_FUNC() was removed in OpenSSL 3.0.
62
63=head1 COPYRIGHT
64
65Copyright 2000-2023 The OpenSSL Project Authors. All Rights Reserved.
66
67Licensed under the Apache License 2.0 (the "License").  You may not use
68this file except in compliance with the License.  You can obtain a copy
69in the file LICENSE in the source distribution or at
70L<https://www.openssl.org/source/license.html>.
71
72=cut
73