gnutls_handshake_set_timeout(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_handshake_set_timeout(3) ✨

okay bestie, so this one lives in the gnutls manual, and it's genuinely one of those little functions that saves your whole vibe. it's an API function, and it's here to stop your TLS handshake from just... hanging forever like a text you never got a reply to. 💅

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

void gnutls_handshake_set_timeout(gnutls_session_t session, unsigned int
ms);

like, yes, that's the whole thing. short. iconic. does exactly one job.

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie, this is a gnutls_session_t type. it's your session. your main character. 🫶
  • unsigned int ms — this is a timeout value in milliseconds, so it's giving very precise, very "i have boundaries" energy. ⏳

💖 DESCRIPTION 💖

so what this does is it sets the timeout for the TLS handshake process to whatever value you handed it. that's it. that's the function. 🦋

and here's the tea on the values:

  • pass an ms value of zero and you disable the timeout entirely — no cap, it'll just wait forever, so know what you're doing 💀
  • pass GNUTLS_DEFAULT_HANDSHAKE_TIMEOUT instead and you get a reasonable default value, which is lowkey the move if you don't wanna think about it ✨
and for the DTLS protocol specifically, the more detailed gnutls_dtls_set_timeouts() is provided. so if you're on DTLS, that's your girl, not this one. 🧚

one more thing that is so important: this function requires you to set a pull timeout callback. see gnutls_transport_set_pull_timeout_function(). periodt. if you skip that, don't come crying to me. 😭

⭐ SINCE ⭐

3.1.0 — an elder, honestly. been holding it down since forever. 👑

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence, bestie, report it:

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 — free to share, just keep 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 set your handshake timeout, your future self will thank you. this was gnutls version 3.8.13, brought to you by the gnutls_handshake_set_timeout(3) girlies. bye bestie, love u, hydrate!! 🦋✨🌸

📦 where this page comes from