gnutls_error_is_fatal(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_is_fatal(3) 💖

okay bestie, welcome to the gnutls manual — yes the whole thing, and yes we're doing this together 🫶

✨ NAME ✨

gnutls_error_is_fatal — literally just an API function, no cap

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

int gnutls_error_is_fatal(int error);

🎀 ARGUMENTS 🎀

  • int error — this is a GnuTLS error code, and it's a negative error code. negative!! like the vibes when your handshake fails 💀

🦋 DESCRIPTION 🦋

so here's the tea ☕ — if some GnuTLS function hands you back a negative error code, you can feed that value straight into this function to find out if the error condition is fatal to a TLS session. and by fatal we mean, like, the session must be terminated. it's over, it's done, periodt 💅

but listen — you might also wanna check the error code manually, bestie, because some errors that are non-fatal to the protocol (think a warning alert, or a rehandshake request 👀) can still be totally fatal for your program. the protocol said "we're fine" and your app said "actually no 💀". so keep an eye on it.

and heads up: this function is only useful if you're dealing with errors from functions that relate to a TLS session — like, record layer or handshake layer handling functions. it's giving very specific-purpose energy, iykyk ✨

⭐ RETURNS ⭐

Non-zero value on fatal errors, or zero on non-fatal. that's it, that's the whole answer 🌈

💀 REPORTING BUGS 💀

found a bug? not me being the one to tell you, but okay:

Report bugs to <bugs@gnutls.org>.

Home page: 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, honestly — that's a genuinely generous license 🫶

🧚 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, queen 👑

and that's the whole page, bestie 💜 this lil manual came to you from the gnutls manual, version 3.8.13, dated right alongside gnutls_error_is_fatal(3). mwah, take care of your sessions 🎀✨

📦 where this page comes from