gnutls_session_get_desc(3)

πŸ’– gnutls_session_get_desc(3) πŸ’–

okay bestie, so this is a page from the gnutls manual (section 3, the library-functions girlies ✨) and we're gonna talk about one very specific little function. it's giving "tell me about my session" energy and honestly? we're obsessed.


✨ NAME ✨

gnutls_session_get_desc β€” API function πŸ’…


🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

char * gnutls_session_get_desc(gnutls_session_t session);

πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_session_t session β€” bestie. it's a gnutls session. that's the vibe. πŸ¦‹

πŸ’– DESCRIPTION πŸ’–

so this function hands you back a string that describes the current session. like, it literally narrates what's going on in there. ✨

the string is null terminated and it's allocated using gnutls_malloc(). so yes, it's yours to deal with β€” the memory is allocated with gnutls_malloc(), no cap. 🫢

⚠️ important!! if initial negotiation is not complete when this function is called, NULL will be returned. no negotiation, no description, periodt. πŸ’€

πŸ”₯ RETURNS πŸ”₯

a description of the protocols and algorithms in the current session. iconic, truly. πŸ‘‘


⭐ SINCE ⭐

3.1.10 β€” she's been here a while and she's still slaying. πŸ’œ


πŸ› REPORTING BUGS πŸ›

found a bug? don't be shy, tell the gnutls girlies:


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. (so like, free real estate, just keep the receipts bestie 🧾✨)


πŸ‘€ 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, go visit:

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

and that's the whole page, bestie β€” go forth and describe your sessions πŸ’…βœ¨

this was brought to you by gnutls version 3.8.13, and yes, the manual footer says gnutls_session_get_desc(3) down there too. mwah. πŸŽ€πŸ’œ

πŸ“¦ where this page comes from