gnutls_record_set_max_size(3)

✨ gnutls_record_set_max_size ✨

okay bestie, welcome to the gnutls manual — yes, that gnutls, the 3.8.13 era one 💖 this little page is all about gnutls_record_set_max_size(3), an API function, and it's genuinely iconic so let's get into it.

---

🌸 NAME 🌸

gnutls_record_set_max_size — API function

---

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

ssize_t gnutls_record_set_max_size(gnutls_session_t session, size_t
size);

---

🦋 ARGUMENTS 🦋

• gnutls_session_t session — this is a gnutls_session_t type. it's giving "the session you're messing with" 💅
• size_t size — the new size, periodt. that's literally it.

---

💖 DESCRIPTION 💖

so what does this function do? it sets the maximum amount of plaintext sent and received in a record in this connection. lowkey a whole vibe-setter for your connection ngl ✨

here's the lore, because the history matters:

• Prior to 3.6.4, this function was implemented using a TLS extension called 'max fragment length', which limits the acceptable values to 512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12). yeah. four options. that's the whole menu 😭
• Since 3.6.4, the limit is also negotiated through a new TLS extension called 'record size limit', which doesn't have the limitation, as long as the value ranges between 512 and 16384. glow-up fr fr 🔥

Note that while the 'record size limit' extension is preferred, not all TLS implementations use or even understand the extension. so like… don't assume everyone's on the same page, bestie 🙈

---

👑 DEPRECATED 👑

if the client can assume that the 'record size limit' extension is supported by the server, we recommend using gnutls_record_set_max_recv_size() instead. yes this one's kinda on its way out — the recv-size one is the main character now 🫶

---

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned. so 0 = slay, negative = not slay 💀

---

🌈 REPORTING BUGS 🌈

Report bugs to <bugs@gnutls.org>. Home page: https://www.gnutls.org

---

💜 COPYRIGHT 💜

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.

---

🧚 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, no cap 🎀 this was the gnutls man page for gnutls_record_set_max_size(3), version 3.8.13, and yeah — the footer of the original literally just repeats the title and the version, so consider this your cute sign-off instead. go forth and set those record sizes responsibly, bestie 💅✨🌸