gnutls_session_supplemental_register(3)

gnutls_session_supplemental_register3

Api function

Usage

#include <gnutls/gnutls.h>

int gnutls_session_supplemental_register(gnutls_session_t session, const char * name, gnutls_supplemental_data_format_type_t type, gnutls_supp_recv_func recv_func, gnutls_supp_send_func send_func, unsigned flags);

Arguments

gnutls_session_t session

the session for which this will be registered

const char * name

the name of the supplemental data to register

gnutls_supplemental_data_format_type_t type

the type of the supplemental data format

gnutls_supp_recv_func recv_func

the function to receive the data

gnutls_supp_send_func send_func

the function to send the data

unsigned flags

must be zero

Overview

This function will register a new supplemental data type (rfc4680). The registered supplemental functions will be used for that specific session. The provided type must be an unassigned type in gnutls_supplemental_data_format_type_t.

If the type is already registered or handled by GnuTLS internally GNUTLS_E_ALREADY_REGISTERED will be returned.

As supplemental data are not defined under TLS 1.3, this function will disable TLS 1.3 support for the given session.

Returns

GNUTLS_E_SUCCESS on success, otherwise a negative error code.

Since

3.5.5

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. 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.