summaryrefslogtreecommitdiffstats
path: root/doc/manpages/gnutls_alert_send_appropriate.3
blob: 3aa03c29c39eb13104c7fc6cab92836e4e91e973 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_alert_send_appropriate" 3 "3.7.9" "gnutls" "gnutls"
.SH NAME
gnutls_alert_send_appropriate \- API function
.SH SYNOPSIS
.B #include <gnutls/gnutls.h>
.sp
.BI "int gnutls_alert_send_appropriate(gnutls_session_t " session ", int " err ");"
.SH ARGUMENTS
.IP "gnutls_session_t session" 12
is a \fBgnutls_session_t\fP type.
.IP "int err" 12
is an error code returned by another GnuTLS function
.SH "DESCRIPTION"
Sends an alert to the peer depending on the error code returned by
a gnutls function. This function will call \fBgnutls_error_to_alert()\fP
to determine the appropriate alert to send.

This function may also return \fBGNUTLS_E_AGAIN\fP, or
\fBGNUTLS_E_INTERRUPTED\fP.

This function historically was always sending an alert to the
peer, even if  \fIerr\fP was inappropriate to respond with an alert
(e.g., \fBGNUTLS_E_SUCCESS\fP). Since 3.6.6 this function returns
success without transmitting any data on error codes that
should not result to an alert.
.SH "RETURNS"
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise
an error code is returned.
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.br
Home page: https://www.gnutls.org

.SH COPYRIGHT
Copyright \(co 2001- Free Software Foundation, Inc., and others.
.br
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
.SH "SEE ALSO"
The full documentation for
.B gnutls
is maintained as a Texinfo manual.
If the /usr/share/doc/gnutls/
directory does not contain the HTML form visit
.B
.IP https://www.gnutls.org/manual/
.PP