GNUTLS_HANDSHAKE_SET_MAX_PACKET_LENGTH(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

✨ NAME ✨

gnutls_handshake_set_max_packet_length — bestie, this is the API function that puts a cap on how big your handshake messages are allowed to get 💅

(oh and hi, you're reading the gnutls manual, section 3, and this page is lowkey iconic 🎀)

🌸 SYNOPSIS 🌸

#include <gnutls/gnutls.h>

void gnutls_handshake_set_max_packet_length(gnutls_session_t session,
                                            size_t max);

🦋 ARGUMENTS 🦋

  • gnutls_session_t session — okay so this is literally just a gnutls_session_t type. Your session. Your girl. 🫶
  • size_t max — and this one? This is the maximum number. The ceiling. The limit. The "no more than this, periodt" value. ⭐

💖 DESCRIPTION 💖

So the way that this function works is: it sets the maximum size of all handshake messages. If a handshake tries to come through over that size, it gets rejected — with the GNUTLS_E_HANDSHAKE_TOO_LARGE error code. Not me being dramatic, that's literally the error. 💀

The default value is 128kb, which is, ngl, typically large enough for basically everyone. Main character default behaviour.

And if you want no upper limit at all? Set this to 0. Zero. Nada. Free-range handshakes. 🌈

The reason for restricting the handshake message sizes are to limit Denial of Service attacks. 🛡️

Which, yeah, makes total sense — this is a security vibe check, fr fr.

Also, heads up: note that the maximum handshake size was increased to 128kb from 48kb in GnuTLS 3.5.5. Glow-up era. 👑

😭 REPORTING BUGS 😭

Found a bug? Tell the girlies:

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 yes, you may absolutely copy this, 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/

okay that's the whole page, you ate that 🍓 stay safe, cap your handshakes, and don't let anybody DoS your vibe. mwah 💜

— gnutls, version 3.8.13, gnutls_handshake_set_max_packet_length(3), signing off 🎀

📦 where this page comes from