gnutls_record_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_record_set_timeout 💖

okay bestie, welcome to the gnutls manual page for gnutls_record_set_timeout — it's an API function, she's from the gnutls family, and she's here to control how long the record layer waits before it gives up. let's get into it 🫶

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void gnutls_record_set_timeout(gnutls_session_t session, unsigned int ms);

like, that's the whole vibe. two args, one function, no return value because she's void and she knows it 💅

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie this is literally just a gnutls_session_t type. that's the whole description. she is what she is. iconic.
  • unsigned int ms — the timeout value, measured in milliseconds. yes, milli. tiny little units. plan accordingly ⏱️

🌸 DESCRIPTION 🌸

so what she actually does: this function sets the receive timeout for the record layer to whatever value you hand her. that's it, that's the job, and she does it flawlessly.

now here's the tea on the values 👀

  • pass an ms value of zero to disable the timeout — and ngl, that's also the default, so if you do nothing you already live in the zero-timeout timeline.
  • or pass GNUTLS_INDEFINITE_TIMEOUT to set an indefinite timeout. yes, indefinite. she will wait. forever. main character patience 🧚
⚠️ but listen — this function requires you to set a pull timeout callback. no callback, no party. see gnutls_transport_set_pull_timeout_function() for that, bestie, don't skip this step 😭

⭐ SINCE ⭐

3.1.7 — she's been around a minute, lowkey a legacy queen 👑

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it 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.

(translation: share her, remix her, 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, then bestie, go visit:

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

okay that's the whole page, you ate it, you understood it, periodt ✨ this was gnutls_record_set_timeout(3) from the gnutls manual, version 3.8.13 — mwah, go set some timeouts responsibly 💜🦋🎀

📦 where this page comes from