diff options
| author | Richard Levitte <levitte@openssl.org> | 2020-11-20 22:13:11 +0100 |
|---|---|---|
| committer | Pauli <paul.dale@oracle.com> | 2020-11-28 15:28:46 +1000 |
| commit | af2f14ace581d30b186429cb3f9f5d14c0b5b4ec (patch) | |
| tree | 7b2fc7268982869c2505d331f96568c96d8d3113 /CHANGES.md | |
| parent | b8fa02e8a4a4a9c274aafdb4fc834ba051301afb (diff) | |
ERR: Drop or deprecate dangerous or overly confusing functions
ERR_get_error_line() is deprecated, and ERR_get_error_func() and
ERR_get_error_data() are removed in favor of ERR_get_error_all(),
since they pop the error record, leaving the caller with only partial
error record data and no way to get the rest if the wish.
If it's desirable to retrieve data piecemeal, the caller should
consider using the diverse ERR_peek functions and finish off with
ERR_get_error().
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Paul Dale <paul.dale@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/13466)
Diffstat (limited to 'CHANGES.md')
| -rw-r--r-- | CHANGES.md | 19 |
1 files changed, 11 insertions, 8 deletions
diff --git a/CHANGES.md b/CHANGES.md index aad59a862b..e3ab1c5562 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -863,14 +863,17 @@ OpenSSL 3.0 * Added ERR functionality to give callers access to the stored function names that have replaced the older function code based functions. - New functions are 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(). - - These functions have become deprecated: ERR_get_error_line_data(), - ERR_peek_error_line_data(), ERR_peek_last_error_line_data() and - ERR_func_error_string(). + New functions are ERR_peek_error_func(), ERR_peek_last_error_func(), + ERR_peek_error_data(), ERR_peek_last_error_data(), ERR_get_error_all(), + ERR_peek_error_all() and ERR_peek_last_error_all(). + + These functions have become deprecated: ERR_get_error_line(), + ERR_get_error_line_data(), ERR_peek_error_line_data(), + ERR_peek_last_error_line_data() and ERR_func_error_string(). + + Users are recommended to use ERR_get_error_all(), or to pick information + with ERR_peek functions and finish off with getting the error code by using + ERR_get_error(). *Richard Levitte* |