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 <[email protected]>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/

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.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.