gnutls_psk_set_client_credentials_function

Section: gnutls (3)
Updated: 2.8.5
Index Return to Main Contents

NAME

gnutls_psk_set_client_credentials_function - Used to set a callback to retrieve the username and key

SYNOPSIS

#include <gnutls/gnutls.h>

void gnutls_psk_set_client_credentials_function(gnutls_psk_client_credentials_t cred, gnutls_psk_client_credentials_function * func);

ARGUMENTS

gnutls_psk_client_credentials_t cred: is a gnutls_psk_server_credentials_t structure.
gnutls_psk_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 PSK authentication. The callback's function form is: int (*callback)(gnutls_session_t, char** username, gnutls_datum_t* key);

The username and key->data must be allocated using gnutls_malloc(). username should be ASCII strings or UTF-8 strings prepared using the "SASLprep" profile of "stringprep".

The callback function will be called once per handshake.

The callback function should return 0 on success. -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 © 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.