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, char** username, char**password);

The username and password must be allocated using gnutls_malloc(). 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 per handshake before the initial hello message is sent.

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

info gnutls

should give you access to the complete manual.

COPYRIGHT

Copyright © 2008 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.