gnutls_psk_set_server_credentials_function

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

NAME

gnutls_psk_set_server_credentials_function - Used to set a callback to retrieve the user's PSK credentials

SYNOPSIS

#include <gnutls/gnutls.h>

void gnutls_psk_set_server_credentials_function(gnutls_psk_server_credentials_t cred, gnutls_psk_server_credentials_function * func);

ARGUMENTS

gnutls_psk_server_credentials_t cred: is a gnutls_psk_server_credentials_t structure.
gnutls_psk_server_credentials_function * func: is the callback function

DESCRIPTION

This function can be used to set a callback to retrieve the user's PSK credentials. The callback's function form is: int (*callback)(gnutls_session_t, const char* username, gnutls_datum_t* key);

username contains the actual username. The key must be filled in using the gnutls_malloc().

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

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