gnutls_srp_set_client_credentials_function — Used to set a callback to retrieve the username and password
#include <gnutls/gnutls.h>
void
gnutls_srp_set_client_credentials_function( |
gnutls_srp_client_credentials_t | cred, |
gnutls_srp_client_credentials_function * | func) ; |
is a gnutls_srp_server_credentials_t
structure.
is the callback function
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.
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.
COPYRIGHT |
---|
Copyright © 2006, 2007 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. |