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
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 firstname.lastname@example.org.. This page was obtained from the
tarball gnutls-3.5.9.tar.xz fetched from
⟨http://www.gnutls.org/download.html⟩ on 2017-03-13. 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
gnutls 3.5.9 gnutls_rehandshake(3)