gnutls_est_record_overhead_size(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_est_record_overhead_size ✨

okay bestie, so this is a page from the gnutls manual — the TLS/SSL library that does the whole "keep your secrets safe" thing 💖 — and today we're talking about gnutls_est_record_overhead_size(3), which is literally the "how much extra baggage does every single record carry" calculator. no cap.

🌸 NAME 🌸

gnutls_est_record_overhead_size — it's an API function, periodt. 💅

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

size_t gnutls_est_record_overhead_size(gnutls_protocol_t version,
gnutls_cipher_algorithm_t cipher, gnutls_mac_algorithm_t mac,
gnutls_compression_method_t comp, unsigned int flags);

like, that's the whole vibe. five args, one size_t back. slay. ✨

🦋 ARGUMENTS 🦋

  • gnutls_protocol_t version — bestie this is a gnutls_protocol_t value. which protocol era are we in, babe?
  • gnutls_cipher_algorithm_t cipher — a gnutls_cipher_algorithm_t value, aka the cipher you're repping.
  • gnutls_mac_algorithm_t mac — a gnutls_mac_algorithm_t value, the MAC doing its thing.
  • gnutls_compression_method_t comp — a gnutls_compression_method_t value, and ngl… it's ignored. the function literally does not care. 🙈
  • unsigned int flags — must be zero. not "should be", not "we'd prefer", it MUST be. zero. that's the vibe check and you will pass it. 💀

👑 DESCRIPTION 👑

so this function hands you back the set size in bytes — the overhead, the extra — that TLS (or DTLS, hi DTLS ily) adds on a per-record basis. every record pays this tax, bestie, and now you know how much it costs. 💸

⚠️ heads up though: this function may give you inaccurate values when TLS extensions that modify the record format get negotiated. it's not lying on purpose, it just doesn't know about your extension era. in those cases, a more accurate value can be obtained using gnutls_record_overhead_size() after a completed handshake. so like… after the handshake actually finishes, then ask. iykyk. 🫶

⭐ SINCE ⭐

3.2.2 — she's been around, she's iconic, she's been serving since way back. 🌈

😭 REPORTING BUGS 😭

found a bug? don't be shy, report bugs to <bugs@gnutls.org>. home page: https://www.gnutls.org — go say hi. 💜

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. (yes bestie, free is free, 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/

like, go read the whole thing, it's giving main character energy. 📚✨

and that's the whole page, bestie! 🎀 this was gnutls_est_record_overhead_size(3) from the gnutls manual, version 3.8.13 — mwah, go forth and calculate your overhead, ily 🫶💅

periodt. 🌈

📦 where this page comes from