Provided by: gnutls-doc_3.0.11+really2.12.14-5ubuntu3_all bug

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

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 will should 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 an error.

REPORTING BUGS

       Report       bugs       to       <bug-gnutls@gnu.org>.        GnuTLS       home      page:
       http://www.gnu.org/software/gnutls/     General     help     using      GNU      software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright © 2008 Free Software Foundation.
       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  info  and
       gnutls programs are properly installed at your site, the command

              info gnutls

       should give you access to the complete manual.