gnutls_error_to_alert(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_error_to_alert ✨

okay bestie, welcome to gnutls_error_to_alert(3) — it's a page from the gnutls manual and honestly it's a little chaotic but we're gonna get through it together 💖

🌸 NAME 🌸

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

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

int gnutls_error_to_alert(int err, int * level);

🦋 ARGUMENTS 🦋

  • int err — a negative integer, bestie. negative. that's the vibe check it has to pass.
  • int * level — the alert level is gonna get stored right there in this pointer, so make sure it's pointing somewhere real 👑

🌈 DESCRIPTION 🌈

So here's the tea: this function takes the error code that some gnutls function handed you and gives you back the matching alert. that's it, that's the job 🫶

⚠️ big important note: all alerts sent by this function should be considered FATAL. like, all of them. no cap.

the one single exception — the only one, the main character of exceptions — is when err is GNUTLS_E_REHANDSHAKE. in that one case, a warning alert should be sent to the peer, and the warning is basically saying "bestie, no renegotiation is happening, don't even ask" 😭

and if there's literally no mapping to a valid alert? then you get the alert that signals an internal error: GNUTLS_A_INTERNAL_ERROR. that's the fallback, periodt 💀

⭐ RETURNS ⭐

the alert code you should use for a particular error code. that's the return value, slay ✨

🐛 REPORTING BUGS 🐛

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

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.

like... iconic of them 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, then go visit:

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

and that's the whole page fr fr 🌸 this was gnutls_error_to_alert(3) from the gnutls manual, version 3.8.13, brought to you by the gnutls peeps. mwah, go ship something secure 💖💅🦋

📦 where this page comes from