doc/manpages/gnutls_handshake_set_post_client_hello_function.3

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
   2 .TH "gnutls_handshake_set_post_client_hello_function" 3 "2.12.6.1" "gnutls" "gnutls"
   3 .SH NAME
   4 gnutls_handshake_set_post_client_hello_function \- API function
   5 .SH SYNOPSIS
   6 .B #include <gnutls/gnutls.h>
   7 .sp
   8 .BI "void gnutls_handshake_set_post_client_hello_function(gnutls_session_t " session ", gnutls_handshake_post_client_hello_func                                                  " func ");"
   9 .SH ARGUMENTS
  10 .IP "gnutls_session_t session" 12
  11 is a \fBgnutls_session_t\fP structure.
  12 .IP "gnutls_handshake_post_client_hello_func                                                  func" 12
  13 is the function to be called
  14 .SH "DESCRIPTION"
  15 This function will set a callback to be called after the client
  16 hello has been received (callback valid in server side only). This
  17 allows the server to adjust settings based on received extensions.
  18
  19 Those settings could be ciphersuites, requesting certificate, or
  20 anything else except for version negotiation (this is done before
  21 the hello message is parsed).
  22
  23 This callback must return 0 on success or a gnutls error code to
  24 terminate the handshake.
  25 .SH "WARNING"
  26 You should not use this function to terminate the
  27 handshake based on client input unless you know what you are
  28 doing. Before the handshake is finished there is no way to know if
  29 there is a man\-in\-the\-middle attack being performed.
  30 .SH "REPORTING BUGS"
  31 Report bugs to <bug-gnutls@gnu.org>.
  32 GnuTLS home page: http://www.gnu.org/software/gnutls/
  33 General help using GNU software: http://www.gnu.org/gethelp/
  34 .SH COPYRIGHT
  35 Copyright \(co 2008 Free Software Foundation.
  36 .br
  37 Copying and distribution of this file, with or without modification,
  38 are permitted in any medium without royalty provided the copyright
  39 notice and this notice are preserved.
  40 .SH "SEE ALSO"
  41 The full documentation for
  42 .B gnutls
  43 is maintained as a Texinfo manual.  If the
  44 .B info
  45 and
  46 .B gnutls
  47 programs are properly installed at your site, the command
  48 .IP
  49 .B info gnutls
  50 .PP
  51 should give you access to the complete manual.