gnutls_session_set_id(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_set_id — ok bestie, listen up

so this is a page from the gnutls manual, and we're talking about gnutls_session_set_id, which is lowkey a ✨specialist✨ function. iykyk.

🌸 NAME 🌸

gnutls_session_set_id — API function. that's it, that's the name, she's giving exactly what she says on the tin 💖

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

int gnutls_session_set_id(gnutls_session_t session, const gnutls_datum_t
*sid);

🦋 ARGUMENTS 🦋

  • gnutls_session_t session — bestie this is a gnutls_session_t type. that's the whole vibe.
  • const gnutls_datum_t * sid — the session identifier, aka the little name tag your session wears 👑

✨ DESCRIPTION ✨

okay so what does she do. this function sets the session ID that gets used in a client hello. periodt. 💅

but real talk — this is a function intended for exceptional uses. do not use this function unless you are implementing a custom protocol. like, genuinely. this is not a casual lil function, it's giving "i am building something very specific and i know exactly what i'm doing" energy.

if what you actually want is to set session resumption parameters, use gnutls_session_set_data() instead. that's the one you want, bestie. don't come for this one 🙈

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise, an error code is returned. so like, check your return values, fr fr.

🌈 SINCE 🌈

3.2.1 — she's been here a minute, an icon, a legend 👑

🫶 REPORTING BUGS 🫶

found a bug? not me gatekeeping — 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. slay, and also legally binding 🎀

👑 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/

ok that's the whole page, you ate that 🍓 go forth and set your session ids responsibly (or don't, unless you're implementing a custom protocol, remember!!)

signing off with love from gnutls 3.8.13 — mwah, bye bestie 💖✨🦋

📦 where this page comes from