|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_bye" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_bye \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/gnutls.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_bye(gnutls_session_t " session ", gnutls_close_request_t " how ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_session_t session" 12
|
|
Packit Service |
4684c1 |
is a \fBgnutls_session_t\fP type.
|
|
Packit Service |
4684c1 |
.IP "gnutls_close_request_t how" 12
|
|
Packit Service |
4684c1 |
is an integer
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
Terminates the current TLS/SSL connection. The connection should
|
|
Packit Service |
4684c1 |
have been initiated using \fBgnutls_handshake()\fP. \fIhow\fP should be one
|
|
Packit Service |
4684c1 |
of \fBGNUTLS_SHUT_RDWR\fP, \fBGNUTLS_SHUT_WR\fP.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
In case of \fBGNUTLS_SHUT_RDWR\fP the TLS session gets
|
|
Packit Service |
4684c1 |
terminated and further receives and sends will be disallowed. If
|
|
Packit Service |
4684c1 |
the return value is zero you may continue using the underlying
|
|
Packit Service |
4684c1 |
transport layer. \fBGNUTLS_SHUT_RDWR\fP sends an alert containing a close
|
|
Packit Service |
4684c1 |
request and waits for the peer to reply with the same message.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
In case of \fBGNUTLS_SHUT_WR\fP the TLS session gets terminated
|
|
Packit Service |
4684c1 |
and further sends will be disallowed. In order to reuse the
|
|
Packit Service |
4684c1 |
connection you should wait for an EOF from the peer.
|
|
Packit Service |
4684c1 |
\fBGNUTLS_SHUT_WR\fP sends an alert containing a close request.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Note that not all implementations will properly terminate a TLS
|
|
Packit Service |
4684c1 |
connection. Some of them, usually for performance reasons, will
|
|
Packit Service |
4684c1 |
terminate only the underlying transport layer, and thus not
|
|
Packit Service |
4684c1 |
distinguishing between a malicious party prematurely terminating
|
|
Packit Service |
4684c1 |
the connection and normal termination.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
This function may also return \fBGNUTLS_E_AGAIN\fP or
|
|
Packit Service |
4684c1 |
\fBGNUTLS_E_INTERRUPTED\fP; cf. \fBgnutls_record_get_direction()\fP.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
\fBGNUTLS_E_SUCCESS\fP on success, or an error code, see
|
|
Packit Service |
4684c1 |
function documentation for entire semantics.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|