gnutls_record_send_range(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_send_range — the API function ✨

okay bestie, so this is a page from the gnutls manual, and it's all about gnutls_record_send_range(3). Sit down, hydrate, let's get into it 🫶

🌸 NAME 🌸

gnutls_record_send_range — it's an API function, periodt.

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

ssize_t gnutls_record_send_range(gnutls_session_t session, const void *
data, size_t data_size, const gnutls_range_st * range);

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — it's a gnutls_session_t type, literally what it says on the tin 💅
  • const void * data — this holds the data you wanna send, that's the whole vibe
  • size_t data_size — the length of that data, yes we're counting
  • const gnutls_range_st * range — the range of lengths that the real data length has to hide inside. like a little disguise for your byte count 🥸

🦋 DESCRIPTION 🦋

So here's the tea. This function works like gnutls_record_send() does — but — and this is the part that ate, honestly — while gnutls_record_send() only slaps minimal padding onto every TLS record, this one uses the TLS extra-padding feature to hide the actual real data size inside that range of lengths you handed it. length hiding, we love to see it 😌

⚠️ heads up though: some TLS sessions just do NOT support extra padding — think stream ciphers in standard TLS, or SSL3 sessions. so rude of them.

If you wanna know whether your current session supports extra padding (and therefore length hiding), go check the gnutls_record_can_use_length_hiding() function. iykyk 🌈

💀 NOTE 💀

This function is currently limited to blocking sockets only. that's it. that's the note. don't come for me, i don't make the rules 🫠

👑 RETURNS 👑

The number of bytes sent — which is, on a successful invocation, literally data_size — or a negative error code if it went sideways. no in-between, bestie.

🍓 REPORTING BUGS 🍓

Found a bug? Tell the gnutls girlies about it:

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, that's the actual license text, i'm not paraphrasing legal stuff, i'm not reckless 😭)

🌈 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, go visit:

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

gnutls 3.8.13 — that's the version and the source, and this lil page is gnutls_record_send_range(3). mwah, go forth and hide those lengths responsibly 💅✨🦋

📦 where this page comes from