gnutls_protocol_set_enabled(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_protocol_set_enabled — the gnutls manual, bestie edition 💖

okay so real talk, this is a page from the gnutls manual (section 3, the library-call girlies) and it's about gnutls_protocol_set_enabled(3) — the function that lets you flip a TLS protocol version on or off before everything else wakes up. let's get into it 🫶

✨ NAME ✨

gnutls_protocol_set_enabled — it's an API function, that's the whole vibe. no cap.

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_protocol_set_enabled(gnutls_protocol_t version, unsigned int
enabled);

there she is 💅

🎀 ARGUMENTS 🎀

  • gnutls_protocol_t version — bestie this is a (gnutls) version number. like, which protocol version we're talking about.
  • unsigned int enabled — and this one is literally just whether to enable the protocol or not. yes/no energy. 🦋

💜 DESCRIPTION 💜

so what does it do? it controls the previous system-wide setting that marked version as enabled or disabled. think of it as reaching back and editing the defaults your system already decided on. ✨

but — and this is the important part, don't skip it — calling this function is allowed only if allowlisting mode is set in the configuration file, and only if the system-wide TLS priority string has not been initialized yet. both conditions. no exceptions. 🙈

the intended usage is to give applications a way to expressly deviate from the distribution or site defaults that they inherited from the configuration file. you're not fighting the config, you're just... respectfully disagreeing with it. and the modification is composable with further modifications performed through the priority string mechanism, so it plays nice with the other knobs. 👑

🚨 ok this one matters: this function is not thread-safe and is intended to be called in the main thread at the beginning of the process execution. not in some random worker thread halfway through your app's life. main thread, top of main, that's the moment. periodt.

⭐ RETURNS ⭐

0 on success or negative error code otherwise. zero means slay, negative means something went sideways. 🔥

🦋 SINCE 🦋

3.7.3 — been here since then, iconic behavior. 🎀

💀 REPORTING BUGS 💀

found a bug? don't suffer in silence, tell the people:

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. (yes bestie, keep the notice, that's the deal 🫶)

👑 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/

that's the whole page, fr fr. this one came from gnutls 3.8.13 — thanks for reading, go call it from your main thread at the start of the process like a good little main character 💖✨🌸

📦 where this page comes from