Sha256: 9003629e5a1f4147c2b30f6a1176374e10ee62b1506eedd2239164ce99b27c28

Contents?: true

Size: 1.89 KB

Versions: 3

Compression:

Stored size: 1.89 KB

Contents

.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_rehandshake" 3 "3.2.17" "gnutls" "gnutls"
.SH NAME
gnutls_rehandshake \- API function
.SH SYNOPSIS
.B #include <gnutls/gnutls.h>
.sp
.BI "int gnutls_rehandshake(gnutls_session_t " session ");"
.SH ARGUMENTS
.IP "gnutls_session_t session" 12
is a \fBgnutls_session_t\fP structure.
.SH "DESCRIPTION"
This function will renegotiate security parameters with the
client.  This should only be called in case of a server.

This message informs the peer that we want to renegotiate
parameters (perform a handshake).

If this function succeeds (returns 0), you must call the
\fBgnutls_handshake()\fP function in order to negotiate the new
parameters.

Since TLS is full duplex some application data might have been
sent during peer's processing of this message. In that case
one should call \fBgnutls_record_recv()\fP until GNUTLS_E_REHANDSHAKE
is returned to clear any pending data. Care must be taken if
rehandshake is mandatory to terminate if it does not start after
some threshold.

If the client does not wish to renegotiate parameters he will
should with an alert message, thus the return code will be
\fBGNUTLS_E_WARNING_ALERT_RECEIVED\fP and the alert will be
\fBGNUTLS_A_NO_RENEGOTIATION\fP.  A client may also choose to ignore
this message.
.SH "RETURNS"
\fBGNUTLS_E_SUCCESS\fP on success, otherwise a negative error code.
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.br
Home page: http://www.gnutls.org

.SH COPYRIGHT
Copyright \(co 2001-2014 Free Software Foundation, Inc.
.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 http://www.gnutls.org/manual/
.PP

Version data entries

3 entries across 3 versions & 1 rubygems

Version Path
glib2-2.2.3-x86-mingw32 vendor/local/share/man/man3/gnutls_rehandshake.3
glib2-2.2.2-x86-mingw32 vendor/local/share/man/man3/gnutls_rehandshake.3
glib2-2.2.1-x86-mingw32 vendor/local/share/man/man3/gnutls_rehandshake.3