gnutls_psk_set_client_credentials_function33
Api function
Usage
#include <gnutls/gnutls.h>
void gnutls_psk_set_client_credentials_function3(gnutls_psk_client_credentials_t cred, gnutls_psk_client_credentials_function3 * func);
Arguments
gnutls_psk_client_credentials_t cred
|
is a |
|---|---|
gnutls_psk_client_credentials_function3 * func
|
is the callback function |
Overview
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, gnutls_datum_t* username, gnutls_datum_t* key, gnutls_datum_t* context, gnutls_psk_key_flags *flags);
This callback function has the same semantics as that of gnutls_psk_set_client_credentials_function2(), but it returns flags associated with the key. The callback may import external PSK using the method described in RFC 9258 by using gnutls_psk_format_imported_identity().
The data field of username , key , and context must be allocated using gnutls_malloc(). The username should be an ASCII string or UTF-8 string. In case of a UTF-8 string it is recommended to be following the PRECIS framework for usernames (rfc8265).
The callback function will be called once per handshake.
The callback function should return 0 on success. -1 indicates an error.
Releases
2 releases since Debian 13 (Trixie); the text changed 1 time.