gnutls_ecc_curve_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_ecc_curve_set_enabled — the glow-up your ECC curves deserve 💖

okay bestie, this is one of those pages from the gnutls manual, and honestly? it's giving "quiet but powerful." let's get into it 🦋

✨ NAME ✨

gnutls_ecc_curve_set_enabled — it's an API function, and it's literally here to flip an ECC curve on or off before the party even starts 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_ecc_curve_set_enabled(gnutls_ecc_curve_t curve, unsigned int
enabled);

like, that's the whole entrance. short. iconic. no notes. 💅

🫶 ARGUMENTS 🫶

  • gnutls_ecc_curve_t curve — bestie, this is the ECC curve in question. the one we're about to make a decision about ✨
  • unsigned int enabled — the vibe check: are we enabling this curve or not? 👑

💜 DESCRIPTION 💜

so here's the tea. this function modifies the previous system-wide setting that marked curve as enabled or disabled. that's it, that's the job 🌈

but bestie, there are RULES. 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. no cap. 🙈

the intended usage is to give applications a way to expressly deviate from the distribution or site defaults inherited from the configuration file. so if the defaults aren't it for you, this is how you say "not me, not today." and the best part? the modification is composable with further modifications performed through the priority string mechanism — so it stacks, it plays nice, it collaborates 💖

⚠️ IMPORTANT ONE: this function is not thread-safe. it is intended to be called in the main thread at the beginning of the process execution. so like... main character energy only, at the very start of the story. do not be out here calling it from a random thread halfway through, i'm begging 😭

⭐ RETURNS ⭐

0 on success, or a negative error code otherwise. slay when it's zero, sad little negative number when it's not 💀

🎀 SINCE 🎀

3.7.3 — been here since 3.7.3, a true veteran of the game ✨

🦋 REPORTING BUGS 🦋

found a bug? don't suffer in silence, bestie, 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, that means keep the receipts. respect the receipts. 💖)

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

and that's the whole page, bestie 🫶 go forth and configure your curves responsibly.

signing off from the gnutls manual, version 3.8.13, page gnutls_ecc_curve_set_enabled(3) — mwah, take care of your main thread 💅✨

📦 where this page comes from