gnutls_cipher_suite_get_name(3)

💖 gnutls_cipher_suite_get_name(3) 💖

okay bestie, so this one lives in the gnutls manual (section 3, the library-calls girlies) and it's genuinely such a cute little lookup helper. let's get into it ✨

---

🌸 NAME 🌸

gnutls_cipher_suite_get_name — an API function, and yes she does exactly what her name says, no cap 🎀

---

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

const char * gnutls_cipher_suite_get_name(gnutls_kx_algorithm_t
kx_algorithm, gnutls_cipher_algorithm_t cipher_algorithm,
gnutls_mac_algorithm_t mac_algorithm);

---

✨ ARGUMENTS ✨

• gnutls_kx_algorithm_t kx_algorithm — bestie this is a Key exchange algorithm, like the handshake's opening move 💅
• gnutls_cipher_algorithm_t cipher_algorithm — and this one is a cipher algorithm, the actual scrambling of the tea 🔐
• gnutls_mac_algorithm_t mac_algorithm — and this is a MAC algorithm, the integrity-checking bestie that makes sure nobody messed with your messages 🫶

---

💜 DESCRIPTION 💜

so basically: you hand her three separate algorithms and she hands you back the ciphersuite name — but only for TLS1.2 or earlier versions, okay? that's the whole vibe check here, periodt.

and listen, the full cipher suite name must be prepended by TLS or SSL depending on the protocol in use. she gives you the name, you gotta put the prefix on top yourself. it's giving "i did my part, now do yours" 😭

now, if what you actually want is a description of the current ciphersuite across versions — not just the old-school TLS1.2-and-earlier situation — it is recommended to use gnutls_session_get_desc() instead. fr fr, that's the one you want for that job. 👑

---

⭐ RETURNS ⭐

she returns a string that contains the name of a TLS cipher suite, specified by the given algorithms — or NULL. that's it, that's the whole return value. simple, iconic, no notes 💖

---

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, 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. slay, that's a very chill license 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/

---

ngl the way this whole page is just "give me algorithms, i give you a name" is so unbothered of her. main character energy, truly. 💅

---

and that's a wrap, bestie!! this page came from the gnutls 3.8.13 release and it's the gnutls_cipher_suite_get_name(3) manual page — mwah, go forth and look up ciphersuites 🎀🦋💖