gnutls_srp_set_client_credentials_function

Langue: en

Autres versions - même langue

Version: 1.6.1 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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

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.