From 6653b2827cc8701360c6650865d5d2f7e8fbae88 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Tue, 9 Jun 2020 18:41:42 +0200 Subject: Update liberror.7, liberror.h.0, and README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 19 +++++++++++++------ liberror.7 | 9 ++++++++- liberror.h.0 | 11 ++++++++++- 3 files changed, 31 insertions(+), 8 deletions(-) diff --git a/README b/README index 3395d2f..9b14e0d 100644 --- a/README +++ b/README @@ -13,18 +13,25 @@ together with liberror-backtrace, backtraces. The important functions are: liberror_get_error - Get error for the calling thread + Get error for the calling thread. liberror_set_error - Set error for the calling thread + Set error for the calling thread. liberror_set_error_errno - Wrapper for liberror_set_error for errno errors + Wrapper for liberror_set_error for errno errors. + + liberror_set_error_existing + Set error for the calling thread to a saved error. + + liberror_pop_error + Set error for the calling thread to the + current error's cause. liberror_reset_error Remove error for the calling thread, needed because `liberror_set_error` otherwise stores - the error as the cause of the new error + the error as the cause of the new error. liberror_print_error Print the error for the calling thread, include @@ -33,7 +40,7 @@ The important functions are: the error for the calling thread. liberror_start - Shall be called when entering a signal handler + Shall be called when entering a signal handler. liberror_end - Shall be called when a signal handler exits + Shall be called when a signal handler exits. diff --git a/liberror.7 b/liberror.7 index be78c28..1464ac7 100644 --- a/liberror.7 +++ b/liberror.7 @@ -1,4 +1,4 @@ -.TH LIBERROR 7 2019-04-13 liberror +.TH LIBERROR 7 2020-06-09 liberror .SH NAME liberror \- single interface for custom and standard errors .SH SYNOPSIS @@ -43,6 +43,13 @@ function for .I errno errors. .TP +.BR liberror_set_error_existing(3) +Set error for the calling thread to a saved error. +.TP +.BR liberror_pop_error(3) +Set error for the calling thread to the current +error's cause. +.TP .BR liberror_reset_error (3) Remove error for the calling thread, needed because the .BR liberror_set_error (3) diff --git a/liberror.h.0 b/liberror.h.0 index e7759c5..602f482 100644 --- a/liberror.h.0 +++ b/liberror.h.0 @@ -1,4 +1,4 @@ -.TH LIBERROR.H 0 2019-04-13 liberror +.TH LIBERROR.H 0 2020-06-09 liberror .SH NAME liberror.h \- single interface for custom and standard errors .SH SYNOPSIS @@ -59,6 +59,8 @@ void liberror_print_backtrace(struct liberror_error *, FILE *, const char *); int liberror_save_backtrace(struct liberror_error *); void liberror_set_error(const char[256], const char[64], const char[64], long long int); void liberror_set_error_errno(const char[256], const char[64], int); +void liberror_set_error_existing(struct liberror_error *); +void liberror_pop_error(void); void liberror_print_error(struct liberror_error *, FILE *, int, const char *); void liberror_start(struct liberror_state *); void liberror_end(const struct liberror_state *); @@ -282,6 +284,13 @@ for errors with .I errno values. .TP +.BR liberror_set_error_existing (3) +Set error for the calling thread to a saved error. +.TP +.BR liberror_pop_error (3) +Set error for the calling thread to the current +error's cause. +.TP .BR liberror_print_error (3) Print an error, by default the calling thread's current error, if any, including description, -- cgit v1.2.3-70-g09d2