NAME
gnutls_srp_set_client_credentials_function - Used to set a callback to retrieve the username and password
SYNOPSIS
#include <gnutls/gnutls.h>
I void gnutls_srp_set_client_credentials_function(gnutls_srp_client_credentials_t cred , gnutls_srp_client_credentials_function * func );
ARGUMENTS
"gnutls_srp_client_credentials_t
is a gnutls_srp_server_credentials_t structure.
"gnutls_srp_client_credentials_function
is the callback function
DESCRIPTION
This function can be used to set a callback to retrieve the username and
password for client SRP authentication.
The callback's function form is:
int (*callback)(gnutls_session_t, unsigned int times, char** username,
char** password);
The username and password must be allocated using gnutls_malloc().
times will be 0 the first time called, and 1 the second.
username and password should be ASCII strings or UTF-8 strings
prepared using the "SASLprep" profile of "stringprep".
The callback function will be called once or twice per handshake.
The first time called, is before the ciphersuite is negotiated.
At that time if the callback returns a negative error code,
the callback will be called again if SRP has been
negotiated. This uses a special TLS-SRP idiom in order to avoid
asking the user for SRP password and username if the server does
not support SRP.
The callback should not return a negative error code the second
time called, since the handshake procedure will be aborted.
The callback function should return 0 on success.
-1 indicates an error.
REPORTING BUGS
Report bugs to <bug-gnutls@gnu.org>.
COPYRIGHT
Copyright 2006 Free Software Foundation.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
SEE ALSO
The full documentation for
gnutls
is maintained as a Texinfo manual. If the
info
and
gnutls
programs are properly installed at your site, the command
info gnutls
should give you access to the complete manual.