gnutls_psk_set_server_credentials_function3(3)

gnutls_psk_set_server_credentials_function33

Api function

Usage

#include <gnutls/gnutls.h>

void gnutls_psk_set_server_credentials_function3(gnutls_psk_server_credentials_t cred, gnutls_psk_server_credentials_function3 func);

Arguments

gnutls_psk_server_credentials_t cred

is a gnutls_psk_server_credentials_t type.

gnutls_psk_server_credentials_function3 func

is the callback function

Overview

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 gnutls_datum_t* username, gnutls_datum_t* key, gnutls_psk_key_flags *flags);

This callback function has the same semantics as that of gnutls_psk_set_server_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().

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.

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Reporting bugs

Report bugs to <[email protected]>.
Home page: https://www.gnutls.org

From gnutls 3.8.13-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.