gnutls_handsha...vate_extensions(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_handshake_set_private_extensions — the manual page bestie 💖

okay so you're reading the gnutls manual, section gnutls_handsha...vate_extensions(3), and we're gonna talk about gnutls_handshake_set_private_extensions — yes it's an API function, yes the name is long, no we are not scared of it 🫶

✨ NAME ✨

gnutls_handshake_set_private_extensions — an API function, bestie. that's the whole name. it's giving "long but iconic" 💅

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

void gnutls_handshake_set_private_extensions(gnutls_session_t session,
       int allow);

that's it. that's the whole thing. no return value, no drama (well, some drama, see DESCRIPTION 👀).

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie this is a gnutls_session_t type. it's your session. your main character. 🌟
  • int allow — an integer, and it's literally just 0 or 1. binary queen. no in-between, no "maybe", no "it's complicated" 💀

🦋 DESCRIPTION 🦋

so what does this actually do. this function turns the use of private cipher suites on or off — and by "private cipher suites" we mean the ones that start with 0xFF. iykyk. 🔥

by default, OR if allow is 0, those cipher suites will not be advertised and will not be used. so the chill, do-nothing, default vibe is: they're off. periodt. 💅

now for the part where i have to be real with you: currently GnuTLS does not include such cipher-suites or compression algorithms. so like... the feature exists, the switch exists, but the actual private cipher suites and compression algorithms? not in the box. not me finding out it's a feature flag for nothing 😭

⚠️ and here's the big one, bestie: enabling the private ciphersuites when talking to other than gnutls servers and clients may cause interoperability problems. like, handshake go brrr in a bad way. so don't just flip it to 1 for funsies. 🌈

🙈 REPORTING BUGS 🙈

found a bug? spill it. report bugs to bugs@gnutls.org.

home page: https://www.gnutls.org — go say hi, it's cute over there 🏠✨

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, take it, share it, remix it — 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, visit:

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

go forth and read. the docs are there, the lore is deep 📚🦋

and that's the whole page, no cap. this was gnutls version 3.8.13, page gnutls_handsha...vate_extensions(3), and honestly? ate. go set your extensions responsibly, babe 💅🌸✨

📦 where this page comes from