gnutls_session_get_id2(3)

💖 gnutls_session_get_id2(3) 💖

okay bestie, welcome to the gnutls manual, this one's a lil function from the gnutls library and it's lowkey iconic. sit down, hydrate, let's get into it ✨

---

🌸 NAME 🌸

gnutls_session_get_id2 — literally just an API function, that's the whole vibe 🫶

---

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_session_get_id2(gnutls_session_t session, gnutls_datum_t *
session_id);

---

🎀 ARGUMENTS 🎀

• gnutls_session_t session — bestie this is a gnutls_session_t type, that's it, that's the arg 💅
• gnutls_datum_t * session_id — this one's gonna point to the session ID, it's the output girlie 🌸

---

🦋 DESCRIPTION 🦋

So this function returns the TLS session identifier. Not me explaining the whole lore but here we go:

The session ID is picked by the server, and in older versions of TLS it was a unique identifier shared between client and server that was persistent across resumption. adorable, right? 💖 But in the latest version of TLS (1.3) or TLS 1.2 with session tickets, the notion of session identifiers is undefined and you cannot rely on it for uniquely identifying sessions across client and server. yeah. it's giving chaos. 😭

On the client side, this function returns the identifier returned by the server, and it cannot be assumed to have any relation to session resumption. periodt.

On the server side, this function is guaranteed to return a persistent identifier of the session since GnuTLS 3.6.4, which may not necessarily map into the TLS session ID value. Prior to that version, the value could only be considered a persistent identifier under TLS1.2 or earlier, and only when no session tickets were in use. the way that caveat is doing the most fr fr 💀

The session identifier value returned is always less than GNUTLS_MAX_SESSION_ID_SIZE and should be treated as constant. no cap. 🔥

---

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned 🎉 otherwise an error code is returned. sad girl hours if it's the latter 🙈

---

💜 SINCE 💜

3.1.4 — vintage, but make it slay 👑

---

🍓 REPORTING BUGS 🍓

Found a bug? spill it, report bugs to <bugs@gnutls.org>.

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

---

🌈 COPYRIGHT 🌈

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. iconic behavior honestly 💅

---

👑 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, you ate that. go forth and get those session IDs responsibly 🫶✨

gnutls version 3.8.13, page for gnutls_session_get_id2(3) — mwah, bye babes 💖🎀🦋