gnutls_cipher_suite_info(3)

✨ gnutls_cipher_suite_info ✨

okay bestie, welcome to the gnutls manual, section 3 πŸŽ€ this one's called gnutls_cipher_suite_info and it's literally an API function, no cap.


πŸ¦‹ NAME πŸ¦‹

gnutls_cipher_suite_info β€” API function πŸ’…


🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

const char * gnutls_cipher_suite_info(size_t idx, unsigned char * cs_id,
gnutls_kx_algorithm_t * kx, gnutls_cipher_algorithm_t * cipher,
gnutls_mac_algorithm_t * mac, gnutls_protocol_t * min_version);

πŸ’– ARGUMENTS πŸ’–

  • size_t idx β€” the index of the cipher suite you wanna get info about. starts at 0, like a real one πŸ™ˆ
  • unsigned char * cs_id β€” output buffer that needs room for 2 bytes, and it holds the cipher suite value ✨
  • gnutls_kx_algorithm_t * kx β€” output variable telling you the key exchange algorithm, or NULL.
  • gnutls_cipher_algorithm_t * cipher β€” output variable telling you the cipher, or NULL.
  • gnutls_mac_algorithm_t * mac β€” output variable telling you the MAC algorithm, or NULL.
  • gnutls_protocol_t * min_version β€” output variable telling you the TLS protocol version, or NULL.

πŸ‘‘ DESCRIPTION πŸ‘‘

so basically you're getting info about the supported cipher suites. the move is to call this function iteratively to get info about all the supported cipher suites, one by one 🫢

call it with idx=0 to get the first cipher suite, then idx=1, and so on and so on… until the function hands you back NULL and you know you're done. it's giving scrolling through a playlist until it runs out fr fr πŸ’€


🌈 RETURNS 🌈

it gives you the name of the idx cipher suite, and it sets all the info about that cipher suite in the output variables πŸ’– if idx is out of bounds, you get NULL. periodt.


πŸ› REPORTING BUGS πŸ›

found a bug? 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. iconic, 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, go visit

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


and that's the whole page bestie!! this little cutie lives in gnutls version 3.8.13 πŸ’… mwah, go slay some TLS πŸ’œπŸ¦‹βœ¨

πŸ“¦ where this page comes from