1gnutls_handshake_set_post_cligennutt_lhse_lhlgaonn_udftsulhnsacktei_osne(t3_)post_client_hello_function(3)
2
3
4

NAME

6       gnutls_handshake_set_post_client_hello_function - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       void   gnutls_handshake_set_post_client_hello_function(gnutls_session_t
12       session, gnutls_handshake_post_client_hello_func       func);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t structure.
17
18       gnutls_handshake_post_client_hello_func       func
19                   is the function to be called
20

DESCRIPTION

22       This function will set a callback to be called after the  client  hello
23       has been received (callback valid in server side only). This allows the
24       server to adjust settings based on received extensions.
25
26       Those settings could be ciphersuites, requesting certificate,  or  any‐
27       thing  else  except  for  version  negotiation (this is done before the
28       hello message is parsed).
29
30       This callback must return 0 on success or a gnutls error code to termi‐
31       nate the handshake.
32
33       Since  GnuTLS 3.3.5 the callback is allowed to return GNUTLS_E_AGAIN or
34       GNUTLS_E_INTERRUPTED to  put  the  handshake  on  hold.  In  that  case
35       gnutls_handshake()  will return GNUTLS_E_INTERRUPTED and can be resumed
36       when needed.
37

WARNING

39       You should not use this function to terminate the  handshake  based  on
40       client  input  unless you know what you are doing. Before the handshake
41       is finished there is no way to know if  there  is  a  man-in-the-middle
42       attack being performed.
43

REPORTING BUGS

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

SEE ALSO

56       The  full  documentation  for gnutls is maintained as a Texinfo manual.
57       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
58       visit
59
60       http://www.gnutls.org/manual/
61
62gnutls                      gnutls_h3a.n3d.s2h9ake_set_post_client_hello_function(3)
Impressum