gnutls_handshake_write(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_handshake_write ✨

okay bestie, we're in the gnutls manual (that's the manual name, cute right? the whole family lives there) and today's main character is gnutls_handshake_write — an API function. yes. an actual function. let's go 💅

🎀 NAME 🎀

gnutls_handshake_write — API function

lowkey that's the whole name section. short. iconic. she said what she said.

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int gnutls_handshake_write(gnutls_session_t session,
gnutls_record_encryption_level_t level, const void * data, size_t
data_size);

there she is. the whole signature. no notes ✨

💖 ARGUMENTS 💖

  • gnutls_session_t session — is a gnutls_session_t type. yeah bestie, the type is the type, that's just how it is 💀
  • gnutls_record_encryption_level_t level — the current encryption level for reading a handshake message. like, which layer of the outfit we're working with rn.
  • const void * data — the (const) handshake data to be processed. it's const, so hands off, we're just looking 👀
  • size_t data_size — the size of data. how much data. the data-ness of it. slay.

🌸 DESCRIPTION 🌸

so this function processes a handshake message in the encryption level you specified with level. that's the vibe. that's the assignment.

⚠️ but before you call this — and this part is not optional, bestie — a handshake read callback must be set on session. do it with gnutls_handshake_set_read_function(). if you don't set it first, you're just out here raw-dogging a handshake and we don't do that 🙈

so like: callback first, then this function. order matters. periodt.

⭐ SINCE ⭐

3.7.0

she's been around since 3.7.0, an elder stateswoman, we respect her 🫶

🌈 REPORTING BUGS 🌈

found a bug? not you being the detective 🔍 report it to <bugs@gnutls.org>.

home page: https://www.gnutls.org

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 like, take it, share it, 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/
and that's the whole page bestie, every option, every argument, every default, all of it, nothing skipped, no cap 💅✨

this has been gnutls_handshake_write, page 3, from gnutls 3.8.13 — mwah, bye, go set that read callback first 😭💜

📦 where this page comes from