Latest update.
This commit is contained in:
@@ -4,8 +4,11 @@
|
||||
|
||||
ERR_get_error, ERR_peek_error, ERR_peek_last_error,
|
||||
ERR_get_error_line, ERR_peek_error_line, ERR_peek_last_error_line,
|
||||
ERR_get_error_line_data, ERR_peek_error_line_data,
|
||||
ERR_peek_last_error_line_data - obtain error code and data
|
||||
ERR_get_error_func, ERR_peek_error_func, ERR_peek_last_error_func,
|
||||
ERR_get_error_data, ERR_peek_error_data, ERR_peek_last_error_data,
|
||||
ERR_get_error_all, ERR_peek_error_all, ERR_peek_last_error_all,
|
||||
ERR_get_error_line_data, ERR_peek_error_line_data, ERR_peek_last_error_line_data
|
||||
- obtain error code and data
|
||||
|
||||
=head1 SYNOPSIS
|
||||
|
||||
@@ -19,6 +22,26 @@ ERR_peek_last_error_line_data - obtain error code and data
|
||||
unsigned long ERR_peek_error_line(const char **file, int *line);
|
||||
unsigned long ERR_peek_last_error_line(const char **file, int *line);
|
||||
|
||||
unsigned long ERR_get_error_func(const char **func);
|
||||
unsigned long ERR_peek_error_func(const char **func);
|
||||
unsigned long ERR_peek_last_error_func(const char **func);
|
||||
|
||||
unsigned long ERR_get_error_data(const char **data, int *flags);
|
||||
unsigned long ERR_peek_error_data(const char **data, int *flags);
|
||||
unsigned long ERR_peek_last_error_data(const char **data, int *flags);
|
||||
|
||||
unsigned long ERR_get_error_all(const char **file, int *line,
|
||||
const char *func,
|
||||
const char **data, int *flags);
|
||||
unsigned long ERR_peek_error_all(const char **file, int *line,
|
||||
const char *func,
|
||||
const char **data, int *flags);
|
||||
unsigned long ERR_peek_last_error_all(const char **file, int *line,
|
||||
const char *func,
|
||||
const char **data, int *flags);
|
||||
|
||||
Deprecated since OpenSSL 3.0:
|
||||
|
||||
unsigned long ERR_get_error_line_data(const char **file, int *line,
|
||||
const char **data, int *flags);
|
||||
unsigned long ERR_peek_error_line_data(const char **file, int *line,
|
||||
@@ -44,15 +67,31 @@ L<ERR_error_string(3)> for human-readable error
|
||||
messages.
|
||||
|
||||
ERR_get_error_line(), ERR_peek_error_line() and
|
||||
ERR_peek_last_error_line() are the same as the above, but they
|
||||
ERR_peek_last_error_line() are the same as ERR_get_error(),
|
||||
ERR_peek_error() and ERR_peek_last_error(), but they
|
||||
additionally store the file name and line number where
|
||||
the error occurred in *B<file> and *B<line>, unless these are B<NULL>.
|
||||
|
||||
ERR_get_error_func(), ERR_peek_error_func() and
|
||||
ERR_peek_last_error_func() are the same as ERR_get_error(),
|
||||
ERR_peek_error() and ERR_peek_last_error(), but they
|
||||
additionally store the name of the function where the error in *B<func>,
|
||||
unless it is B<NULL>.
|
||||
|
||||
ERR_get_error_data(), ERR_peek_error_data() and
|
||||
ERR_peek_last_error_data() are the same as ERR_get_error(),
|
||||
ERR_peek_error() and ERR_peek_last_error(), but they
|
||||
additionally store additional data and flags associated with the error
|
||||
code in *B<data> and *B<flags>, unless these are B<NULL>.
|
||||
*B<data> contains a string if *B<flags>&B<ERR_TXT_STRING> is true.
|
||||
|
||||
ERR_get_error_all(), ERR_peek_error_all() and
|
||||
ERR_peek_last_error_all() are combinations of all of the above.
|
||||
|
||||
ERR_get_error_line_data(), ERR_peek_error_line_data() and
|
||||
ERR_peek_last_error_line_data() store additional data and flags
|
||||
associated with the error code in *B<data>
|
||||
and *B<flags>, unless these are B<NULL>. *B<data> contains a string
|
||||
if *B<flags>&B<ERR_TXT_STRING> is true.
|
||||
ERR_peek_last_error_line_data() are older variants of ERR_get_error_all(),
|
||||
ERR_peek_error_all() and ERR_peek_last_error_all(), and should no longer
|
||||
be used.
|
||||
|
||||
An application B<MUST NOT> free the *B<data> pointer (or any other pointers
|
||||
returned by these functions) with OPENSSL_free() as freeing is handled
|
||||
@@ -67,6 +106,17 @@ The error code, or 0 if there is no error in the queue.
|
||||
L<ERR_error_string(3)>,
|
||||
L<ERR_GET_LIB(3)>
|
||||
|
||||
=head1 HISTORY
|
||||
|
||||
ERR_get_error_func(), ERR_peek_error_func(), ERR_peek_last_error_func(),
|
||||
ERR_get_error_data(), ERR_peek_error_data(), ERR_peek_last_error_data(),
|
||||
ERR_get_error_all(), ERR_peek_error_all() and ERR_peek_last_error_all()
|
||||
were added in OpenSSL 3.0.
|
||||
|
||||
ERR_get_error_line_data(), ERR_peek_error_line_data() and
|
||||
ERR_peek_last_error_line_data() became deprecated in OpenSSL 3.0.
|
||||
|
||||
|
||||
=head1 COPYRIGHT
|
||||
|
||||
Copyright 2000-2017 The OpenSSL Project Authors. All Rights Reserved.
|
||||
|
||||
Reference in New Issue
Block a user