|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_handshake_set_post_client_hello_function" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_handshake_set_post_client_hello_function \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/gnutls.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "void gnutls_handshake_set_post_client_hello_function(gnutls_session_t " session ", gnutls_handshake_simple_hook_func " func ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "gnutls_session_t session" 12
|
|
Packit |
aea12f |
is a \fBgnutls_session_t\fP type.
|
|
Packit |
aea12f |
.IP "gnutls_handshake_simple_hook_func func" 12
|
|
Packit |
aea12f |
is the function to be called
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This function will set a callback to be called after the client
|
|
Packit |
aea12f |
hello has been received (callback valid in server side only). This
|
|
Packit |
aea12f |
allows the server to adjust settings based on received extensions.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
Those settings could be ciphersuites, requesting certificate, or
|
|
Packit |
aea12f |
anything else except for version negotiation (this is done before
|
|
Packit |
aea12f |
the hello message is parsed).
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
This callback must return 0 on success or a gnutls error code to
|
|
Packit |
aea12f |
terminate the handshake.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
Since GnuTLS 3.3.5 the callback is
|
|
Packit |
aea12f |
allowed to return \fBGNUTLS_E_AGAIN\fP or \fBGNUTLS_E_INTERRUPTED\fP to
|
|
Packit |
aea12f |
put the handshake on hold. In that case \fBgnutls_handshake()\fP
|
|
Packit |
aea12f |
will return \fBGNUTLS_E_INTERRUPTED\fP and can be resumed when needed.
|
|
Packit |
aea12f |
.SH "WARNING"
|
|
Packit |
aea12f |
You should not use this function to terminate the
|
|
Packit |
aea12f |
handshake based on client input unless you know what you are
|
|
Packit |
aea12f |
doing. Before the handshake is finished there is no way to know if
|
|
Packit |
aea12f |
there is a man\-in\-the\-middle attack being performed.
|
|
Packit |
aea12f |
.SH "REPORTING BUGS"
|
|
Packit |
aea12f |
Report bugs to <bugs@gnutls.org>.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Home page: https://www.gnutls.org
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
.SH COPYRIGHT
|
|
Packit Service |
991b93 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit |
aea12f |
.br
|
|
Packit |
aea12f |
Copying and distribution of this file, with or without modification,
|
|
Packit |
aea12f |
are permitted in any medium without royalty provided the copyright
|
|
Packit |
aea12f |
notice and this notice are preserved.
|
|
Packit |
aea12f |
.SH "SEE ALSO"
|
|
Packit |
aea12f |
The full documentation for
|
|
Packit |
aea12f |
.B gnutls
|
|
Packit |
aea12f |
is maintained as a Texinfo manual.
|
|
Packit |
aea12f |
If the /usr/share/doc/gnutls/
|
|
Packit |
aea12f |
directory does not contain the HTML form visit
|
|
Packit |
aea12f |
.B
|
|
Packit |
aea12f |
.IP https://www.gnutls.org/manual/
|
|
Packit |
aea12f |
.PP
|