1gnutls_rehandshake(3)               gnutls               gnutls_rehandshake(3)
2
3
4

NAME

6       gnutls_rehandshake - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int gnutls_rehandshake(gnutls_session_t session);
12

ARGUMENTS

14       gnutls_session_t session
15                   is a gnutls_session_t structure.
16

DESCRIPTION

18       This  function  will  renegotiate  security parameters with the client.
19       This should only be called in case of a server.
20
21       This message informs the peer that we want  to  renegotiate  parameters
22       (perform a handshake).
23
24       If  this  function succeeds (returns 0), you must call the gnutls_hand‐
25       shake() function in order to negotiate the new parameters.
26
27       Since TLS is full duplex some application data  might  have  been  sent
28       during  peer's processing of this message. In that case one should call
29       gnutls_record_recv() until GNUTLS_E_REHANDSHAKE is  returned  to  clear
30       any  pending  data.  Care  must be taken if rehandshake is mandatory to
31       terminate if it does not start after some threshold.
32
33       If the client does not wish to renegotiate parameters he  should  reply
34       with  an  alert  message,  thus  the return code will be GNUTLS_E_WARN‐
35       ING_ALERT_RECEIVED and the alert will be GNUTLS_A_NO_RENEGOTIATION.   A
36       client may also choose to ignore this message.
37

RETURNS

39       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
40

REPORTING BUGS

42       Report bugs to <bugs@gnutls.org>.
43       Home page: http://www.gnutls.org
44
45
47       Copyright © 2001-2014 Free Software Foundation, Inc..
48       Copying  and  distribution  of this file, with or without modification,
49       are permitted in any medium  without  royalty  provided  the  copyright
50       notice and this notice are preserved.
51

SEE ALSO

53       The  full  documentation  for gnutls is maintained as a Texinfo manual.
54       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
55       visit
56
57       http://www.gnutls.org/manual/
58
59gnutls                              3.3.29               gnutls_rehandshake(3)
Impressum