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

NAME

6       gnutls_rehandshake - renegotiate security parameters
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       If the client does not wish to renegotiate parameters  he  will  should
28       with  an  alert  message,  thus  the return code will be GNUTLS_E_WARN‐
29       ING_ALERT_RECEIVED and the alert will be GNUTLS_A_NO_RENEGOTIATION.   A
30       client may also choose to ignore this message.
31

RETURNS

33       GNUTLS_E_SUCCESS on success, otherwise an error.
34

REPORTING BUGS

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

41       Copyright © 2008 Free Software Foundation.
42       Copying  and  distribution  of this file, with or without modification,
43       are permitted in any medium  without  royalty  provided  the  copyright
44       notice and this notice are preserved.
45

SEE ALSO

47       The  full  documentation  for gnutls is maintained as a Texinfo manual.
48       If the info and gnutls programs are properly installed  at  your  site,
49       the command
50
51              info gnutls
52
53       should give you access to the complete manual.
54
55
56
57gnutls                               2.8.6               gnutls_rehandshake(3)
Impressum