Add liberror_pop_error and liberror_set_error_existing

Signed-off-by: Mattias Andrée <maandree@kth.se>

1 files changed, 61 insertions, 0 deletions

diff --git a/liberror_set_error_existing.3 b/liberror_set_error_existing.3
new file mode 100644
index 0000000..30c726d
--- /dev/null
+++ b/liberror_set_error_existing.3
@@ -0,0 +1,61 @@
+.TH LIBERROR_SET_ERROR_EXISTING 3 2020-06-09 liberror
+.SH NAME
+liberror_set_error_existing \- set the current error for the thread to a saved error
+.SH SYNOPSIS
+.nf
+#include <liberror.h>
+
+void liberror_set_error_existing(struct liberror_error *\fIerror\fP);
+.fi
+.PP
+Link with
+.IR \-lerror .
+.SH DESCRIPTION
+The
+.BR liberror_set_error_existing ()
+function assigns the error specified in the
+.I error
+parameter to the thread. If
+.I error
+is
+.BR NULL ,
+the current error will be removed without being
+replaces.
+.PP
+The pointer for the specified error will become
+invalid. The pointer for the specified error
+.B must not
+be the pointer returned by the
+.BR liberror_get_error (3)
+function.
+.SH RETURN VALUE
+None.
+.SH ERRORS
+Failure to set the error is impossible.
+.I errno
+will not be changed.
+.SH EXAMPLES
+None.
+.SH APPLICATION USAGE
+None.
+.SH RATIONALE
+None.
+.SH FUTURE DIRECTIONS
+None.
+.SH NOTES
+None.
+.SH SEE ALSO
+.BR liberror (7),
+.BR liberror.h (0),
+.BR liberror_copy_error (3),
+.BR liberror_end (3),
+.BR liberror_free_error (3),
+.BR liberror_get_error (3),
+.BR liberror_pop_error (3),
+.BR liberror_print_backtrace (3),
+.BR liberror_print_error (3),
+.BR liberror_reset_error (3),
+.BR liberror_save_backtrace (3),
+.BR liberror_set_error (3),
+.BR liberror_set_error_errno (3),
+.BR liberror_start (3)