NAME

       gnutls_rehandshake - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_rehandshake(gnutls_session_t session);

ARGUMENTS

       gnutls_session_t session
                   is a gnutls_session_t type.

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 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.

RETURNS

       GNUTLS_E_SUCCESS on success, otherwise a negative error code.

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT

       Copyright © 2001-2021 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.

SEE ALSO

       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/