gnutls_srp_set_server_credentialsgnutls_srp_set_server_credentials_function(3)



NAME
       gnutls_srp_set_server_credentials_function  - Used to set a callback to
       retrieve the user's SRP credentials

SYNOPSIS
       #include <gnutls/gnutls.h>

       void  gnutls_srp_set_server_credentials_function(gnutls_srp_server_cre-
       dentials_t	       cred,	gnutls_srp_server_credentials_function
       * func);

ARGUMENTS
       gnutls_srp_server_credentials_t		cred

		   is a gnutls_srp_server_credentials_t structure.

       gnutls_srp_server_credentials_function	       * func

		   is the callback function

DESCRIPTION
       This function can be used to set a callback to retrieve the user's  SRP
       credentials.    The   callback's   function   form   is:   int  (*call-
       back)(gnutls_session_t, const  char*  username,	gnutls_datum_t*  salt,
       gnutls_datum_t *verifier, gnutls_datum_t* g, gnutls_datum_t* n);

       username  contains  the actual username.  The salt, verifier, generator
       and prime must be filled in using the gnutls_malloc(). For  convenience
       prime and generator may also be one of the static parameters defined in
       extra.h.

       In case the callback returned a negative number then gnutls will assume
       that the username does not exist.

       In  order to prevent attackers from guessing valid usernames, if a user
       does not exist, g and n values should  be  filled  in  using  a	random
       user's  parameters.  In	that case the callback must return the special
       value (1).

       The callback function will only be  called  once  per  handshake.   The
       callback  function  should  return  0 on success, while -1 indicates an
       error.

REPORTING BUGS
       Report	bugs   to    <bug-gnutls@gnu.org>.     GnuTLS	 home	 page:
       http://www.gnu.org/software/gnutls/  General  help  using GNU software:
       http://www.gnu.org/gethelp/


COPYRIGHT
       Copyright (C) 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.

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.



gnutls				 gnutls_srp_set_server_credentials_function(3)

NAME - SYNOPSIS - ARGUMENTS - DESCRIPTION - REPORTING BUGS - COPYRIGHT - 
SEE ALSO -