GNUTLS_SESSION_SUPPLEMENTAL_REGISTER(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_session_supplemental_register(3) ✨

okay bestie, welcome to the gnutls manual 💅 this is the page for gnutls_session_supplemental_register, and yes the title got cropped to gnutls_session_...mental_register(3) which is giving "my name is too long for this terminal" energy 😭 but we move.

🌸 NAME 🌸

gnutls_session_supplemental_register — an API function, periodt ✨

🎀 SYNOPSIS 🎀

#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 you're registering this for, like the specific group chat this whole thing lives in 💬
  • const char * name — the name of the supplemental data you're registering, its little government name fr
  • gnutls_supplemental_data_format_type_t type — the type of the supplemental data format, iykyk
  • gnutls_supp_recv_func recv_func — the function that receives the data 📥
  • gnutls_supp_send_func send_func — the function that sends the data 📤
  • unsigned flags — must be zero. zero. not one, not a vibe, ZERO 🙅‍♀️

💖 DESCRIPTION 💖

so this function will register a new supplemental data type (rfc4680) ✨ the registered supplemental functions will be used for that specific session — so like, this session only, no spilling into other sessions, main character energy only.

the type you hand over must be an unassigned type in gnutls_supplemental_data_format_type_t. no stealing a type that's already taken bestie.

if the type is already registered, or if it's handled by GnuTLS internally, you get GNUTLS_E_ALREADY_REGISTERED back. not a slay, just a fact.

⚠️ and listen — since supplemental data are not defined under TLS 1.3, this function will disable TLS 1.3 support for the given session. like, full-on off. so if you were counting on 1.3 for that session... you're not anymore 💀

🌈 RETURNS 🌈

GNUTLS_E_SUCCESS on success 🎉 otherwise a negative error code 😭

⭐ SINCE ⭐

3.5.5 — she's been iconic since day one 🫶

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it to <bugs@gnutls.org>. 💌

Home page: https://www.gnutls.org

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

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. (basically: share it, just keep the receipts 🧾💖)

🔥 SEE ALSO 🔥

the full documentation for gnutls is maintained as a Texinfo manual 📚 if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

and that's the whole page bestie, no cap 🎀 stay registered, stay unassigned, and stay off TLS 1.3 for that one session 💅

gnutls 3.8.13 — that's the version, that's the vibe, bye ✨🦋🌸

📦 where this page comes from