Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 196 insertions, 0 deletions

diff --git a/upstream/debian-unstable/man3/ERR_get_error.3ssl b/upstream/debian-unstable/man3/ERR_get_error.3ssl
new file mode 100644
index 00000000..fd7d37d1
--- /dev/null
+++ b/upstream/debian-unstable/man3/ERR_get_error.3ssl
@@ -0,0 +1,196 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
+.ie n \{\
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds C`
+.    ds C'
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is >0, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
+..
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{\
+.    if \nF \{\
+.        de IX
+.        tm Index:\\$1\t\\n%\t"\\$2"
+..
+.        if !\nF==2 \{\
+.            nr % 0
+.            nr F 2
+.        \}
+.    \}
+.\}
+.rr rF
+.\" ========================================================================
+.\"
+.IX Title "ERR_GET_ERROR 3SSL"
+.TH ERR_GET_ERROR 3SSL 2024-02-03 3.1.5 OpenSSL
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH NAME
+ERR_get_error, ERR_peek_error, ERR_peek_last_error,
+ERR_get_error_line, ERR_peek_error_line, ERR_peek_last_error_line,
+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, 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
+.SH SYNOPSIS
+.IX Header "SYNOPSIS"
+.Vb 1
+\& #include <openssl/err.h>
+\&
+\& unsigned long ERR_get_error(void);
+\& unsigned long ERR_peek_error(void);
+\& unsigned long ERR_peek_last_error(void);
+\&
+\& 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_peek_error_func(const char **func);
+\& unsigned long ERR_peek_last_error_func(const char **func);
+\&
+\& 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);
+.Ve
+.PP
+The following functions have been deprecated since OpenSSL 3.0, and can be
+hidden entirely by defining \fBOPENSSL_API_COMPAT\fR with a suitable version value,
+see \fBopenssl_user_macros\fR\|(7):
+.PP
+.Vb 7
+\& unsigned long ERR_get_error_line(const char **file, int *line);
+\& 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,
+\&                                        const char **data, int *flags);
+\& unsigned long ERR_peek_last_error_line_data(const char **file, int *line,
+\&                                             const char **data, int *flags);
+.Ve
+.SH DESCRIPTION
+.IX Header "DESCRIPTION"
+\&\fBERR_get_error()\fR returns the earliest error code from the thread's error
+queue and removes the entry.  This function can be called repeatedly
+until there are no more error codes to return.
+.PP
+\&\fBERR_peek_error()\fR returns the earliest error code from the thread's
+error queue without modifying it.
+.PP
+\&\fBERR_peek_last_error()\fR returns the latest error code from the thread's
+error queue without modifying it.
+.PP
+See \fBERR_GET_LIB\fR\|(3) for obtaining further specific information
+such as the reason of the error,
+and \fBERR_error_string\fR\|(3) for human-readable error messages.
+.PP
+\&\fBERR_get_error_all()\fR is the same as \fBERR_get_error()\fR, but on success it
+additionally stores the filename, line number and function where the error
+occurred in *\fIfile\fR, *\fIline\fR and *\fIfunc\fR, and also extra text and flags
+in *\fIdata\fR, *\fIflags\fR.  If any of those parameters are NULL, it will not
+be changed.
+An unset filename is indicated as "", i.e. an empty string.
+An unset line number is indicated as 0.
+An unset function name is indicated as "", i.e. an empty string.
+.PP
+A pointer returned this way by these functions and the ones below
+is valid until the respective entry is overwritten in the error queue.
+.PP
+\&\fBERR_peek_error_line()\fR and \fBERR_peek_last_error_line()\fR are the same as
+\&\fBERR_peek_error()\fR and \fBERR_peek_last_error()\fR, but on success they additionally
+store the filename and line number where the error occurred in *\fIfile\fR and
+*\fIline\fR, as far as they are not NULL.
+An unset filename is indicated as "", i.e., an empty string.
+An unset line number is indicated as 0.
+.PP
+\&\fBERR_peek_error_func()\fR and \fBERR_peek_last_error_func()\fR are the same as
+\&\fBERR_peek_error()\fR and \fBERR_peek_last_error()\fR, but on success they additionally
+store the name of the function where the error occurred in *\fIfunc\fR, unless
+it is NULL.
+An unset function name is indicated as "".
+.PP
+\&\fBERR_peek_error_data()\fR and \fBERR_peek_last_error_data()\fR are the same as
+\&\fBERR_peek_error()\fR and \fBERR_peek_last_error()\fR, but on success they additionally
+store additional data and flags associated with the error code in *\fIdata\fR
+and *\fIflags\fR, as far as they are not NULL.
+Unset data is indicated as "".
+In this case the value given for the flag is irrelevant (and equals 0).
+*\fIdata\fR contains a string if *\fIflags\fR&\fBERR_TXT_STRING\fR is true.
+.PP
+\&\fBERR_peek_error_all()\fR and \fBERR_peek_last_error_all()\fR are combinations of all
+of the above.
+.PP
+\&\fBERR_get_error_line()\fR, \fBERR_get_error_line_data()\fR, \fBERR_peek_error_line_data()\fR
+and \fBERR_peek_last_error_line_data()\fR are older variants of \fBERR_get_error_all()\fR,
+\&\fBERR_peek_error_all()\fR and \fBERR_peek_last_error_all()\fR, and may give confusing
+results.  They should no longer be used and are therefore deprecated.
+.PP
+An application \fBMUST NOT\fR free the *\fIdata\fR pointer (or any other pointers
+returned by these functions) with \fBOPENSSL_free()\fR as freeing is handled
+automatically by the error library.
+.SH "RETURN VALUES"
+.IX Header "RETURN VALUES"
+The error code, or 0 if there is no error in the queue.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fBERR_error_string\fR\|(3),
+\&\fBERR_GET_LIB\fR\|(3)
+.SH HISTORY
+.IX Header "HISTORY"
+\&\fBERR_peek_error_func()\fR, \fBERR_peek_last_error_func()\fR,
+\&\fBERR_peek_error_data()\fR, \fBERR_peek_last_error_data()\fR,
+\&\fBERR_peek_error_all()\fR and \fBERR_peek_last_error_all()\fR
+were added in OpenSSL 3.0.
+.PP
+\&\fBERR_get_error_line()\fR, \fBERR_get_error_line_data()\fR, \fBERR_peek_error_line_data()\fR
+and \fBERR_peek_last_error_line_data()\fR became deprecated in OpenSSL 3.0.
+.SH COPYRIGHT
+.IX Header "COPYRIGHT"
+Copyright 2000\-2022 The OpenSSL Project Authors. All Rights Reserved.
+.PP
+Licensed under the Apache License 2.0 (the "License").  You may not use
+this file except in compliance with the License.  You can obtain a copy
+in the file LICENSE in the source distribution or at
+<https://www.openssl.org/source/license.html>.