Name
gnutls_srp_set_client_credentials_function — Used to
set a callback to retrieve the username and password
Synopsis
#include <gnutls/gnutls.h>
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
cred
-
is a gnutls_srp_server_credentials_t
structure.
- gnutls_srp_client_credentials_function *
func
-
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>.
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
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.
|
