gnutls_heartbeat_enable(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_heartbeat_enable(3) 💖

okay bestie, we're in the gnutls manual and today's main character is gnutls_heartbeat_enable — an API function, periodt. 🫶

✨ NAME ✨

gnutls_heartbeat_enable — literally an API function, that's the whole vibe 💅

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

void gnutls_heartbeat_enable(gnutls_session_t session, unsigned int
type);

look at her. she's a void, she takes two things, she doesn't return anything. unbothered. iconic. 👑

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie this is a gnutls_session_t type, that's the whole tea 🍓
  • unsigned int type — and this one is one of the GNUTLS_HB_* flags. pick your fighter ✨

🦋 DESCRIPTION 🦋

okay so here's the lore 📖

If you call this function with the GNUTLS_HB_PEER_ALLOWED_TO_SEND type, GnuTLS will allow heartbeat messages to be received. And not only that — it also requests the peer to accept heartbeat messages. the way it does both?? multi-tasking queen 💅

⚠️ real talk though: this function must be called prior to TLS handshake. do not come in late, she is not accepting tardy arrivals 🙈

If the type you used is GNUTLS_HB_LOCAL_ALLOWED_TO_SEND, then the peer will be asked to accept heartbeat messages but not send ones. so like, receiving yes, sending no. boundaries, we love to see it 🎀

And heads up — the function gnutls_heartbeat_allowed() can be used to test whether locally generated heartbeat messages can be accepted by the peer. use her for the vibe check 👀

⭐ SINCE ⭐

3.1.2 — an elder. she's been slaying since way back, no cap 🌈

💜 REPORTING BUGS 💜

found a bug? not me gatekeeping — go tell the people, fr fr:

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. so like — go ahead, share it, just keep the receipts bestie 💖

🌈 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, no crumbs left 🧚

this has been gnutls 3.8.13, manual page gnutls_heartbeat_enable(3), mwah 💋 bye bestie, go call her before the handshake iykyk 🫶✨

📦 where this page comes from