gnutls_record_...e_length_hiding(3)

✨ NAME ✨

okay bestie, this is a page from the gnutls manual (you know, the TLS library? the one holding your whole internet together πŸ’…). and the function we're stanning today is gnutls_record_can_use_length_hiding β€” which is, lowkey, just an API function. that's it, that's the name. πŸ’–


πŸŽ€ SYNOPSIS πŸŽ€

#include <gnutls/gnutls.h>

unsigned gnutls_record_can_use_length_hiding(gnutls_session_t session);

that's the whole vibe. one include, one function, returns an unsigned. no cap. ✨


🌸 ARGUMENTS 🌸

  • gnutls_session_t session β€” bestie it's literally just a gnutls_session_t type. that's the entire tea. πŸ«–

πŸ’œ DESCRIPTION πŸ’œ

okay so here's the situation. if your session supports length-hiding padding, then you can go ahead and call gnutls_record_send_range() to send a message whose length is hidden inside the given range. sneaky. mysterious. iconic. πŸ‘‘

but if the session does not support length hiding padding, no worries, you've got options:

  • you can use the standard gnutls_record_send() function, or
  • you can use gnutls_record_send_range() β€” just make sure the range you pass is the same as the length of the message you're trying to send. like, exactly the same. not approximately. the same. 🎯

⭐ RETURNS ⭐

  • true (1) if the current session supports length-hiding padding πŸ’–
  • false (0) if the current session does not 😭

so basically a vibe check for your session. 🌈


πŸ› REPORTING BUGS πŸ›

found a bug? (rude of it tbh.) report it to <bugs@gnutls.org>.

home page is right here: https://www.gnutls.org β€” go be nosy, it's fine. πŸ¦‹


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. slay, that's genuinely generous of them πŸ’…


πŸ”₯ 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, then bestie, just go visit:

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

and that's the whole page, angel 🫢 this was gnutls version 3.8.13, from the gnutls_record_...e_length_hiding(3) corner of the manual. go forth and hide your lengths (or don't, that's also valid). mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from