gnutls_priority_set(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_priority_set(3) 💖

okay bestie, welcome to the gnutls manual — this one's about gnutls_priority_set, an API function that decides what your TLS session is actually gonna vibe with. sit down, hydrate, let's go ✨

🌸 NAME 🌸

gnutls_priority_set — literally just an API function, that's the whole name, no notes 💅

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_priority_set(gnutls_session_t session, gnutls_priority_t priority);

like. it's right there. two args, one int coming back. iconic behavior honestly 🫶

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie this one is a gnutls_session_t type. that's it, that's the whole lore 💀
  • gnutls_priority_t priority — and this one is a gnutls_priority_t type. matching energy, we love consistency 🌈

🦋 DESCRIPTION 🦋

so what this does is set the priorities to use on the ciphers, the key exchange methods, and the macs. that's the whole assignment, and it ate 🔥

but here's the part where you gotta lock in, bestie: this function is expected to be called once per session. one time. once. like a first impression, you don't get to redo it casually 🙈

⚠️ and if you do call it multiple times — for example, before a re-handshake — the caller should make sure that any new settings are not incompatible with the original session. that's on you, not on gnutls. no cap. 😭

⭐ RETURNS ⭐

  • GNUTLS_E_SUCCESS on success 💖
  • or an error code on error, which is giving "we'll tell you that something went wrong, but the details are a whole other function" 💅

🌈 REPORTING BUGS 🌈

found a bug? not me manifesting that but okay, report it to <bugs@gnutls.org> 🐛

home page, for when you wanna scroll instead: 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. (slay, no royalty, we love a generous license 🫶)

💜 SEE ALSO 💜

the full documentation for gnutls is maintained as a Texinfo manual. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, go visit:

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

it's giving "the docs are elsewhere and they're cute". iykyk 🌸

and that's the whole page, bestie!! this was gnutls version 3.8.13, and no, the manual page footer didn't leave a date, so we're just gonna say it dropped sometime after 2023's copyright line — take it up with the Free Software Foundation fr fr 💖✨🦋

📦 where this page comes from