|
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON |
gnutls_rehandshake(3) gnutls gnutls_rehandshake(3)
gnutls_rehandshake - API function
#include <gnutls/gnutls.h>
int gnutls_rehandshake(gnutls_session_t session);
gnutls_session_t session
is a gnutls_session_t type.
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
gnutls_handshake() 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 gnutls_record_recv() 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 should reply
with an alert message, thus the return code will be
GNUTLS_E_WARNING_ALERT_RECEIVED and the alert will be
GNUTLS_A_NO_RENEGOTIATION. A client may also choose to ignore this
message.
GNUTLS_E_SUCCESS on success, otherwise a negative error code.
Report bugs to <bugs@gnutls.org>.
Home page: http://www.gnutls.org
Copyright © 2001-2017 Free Software Foundation, Inc., and others.
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.
The full documentation for gnutls is maintained as a Texinfo manual.
If the /usr/share/doc/gnutls/ directory does not contain the HTML
form visit
http://www.gnutls.org/manual/
This page is part of the GnuTLS (GnuTLS Transport Layer Security
Library) project. Information about the project can be found at
⟨http://www.gnutls.org/⟩. If you have a bug report for this manual
page, send it to bugs@gnutls.org.. This page was obtained from the
tarball gnutls-3.5.9.tar.xz fetched from
⟨http://www.gnutls.org/download.html⟩ on 2017-07-05. If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
gnutls 3.5.9 gnutls_rehandshake(3)