GNUTLS_TRANSPORT_SET_VEC_PUSH_FUNCTION(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

💖 NAME 💖

gnutls_transport_set_vec_push_function — okay bestie, this is an API function, and it's the one that lets you take over how gnutls pushes bytes out. It lives in the gnutls manual (section 3, the library-functions girlies), so if you were looking for it under some other name, that's why. 🦋

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void gnutls_transport_set_vec_push_function(gnutls_session_t session,
                                            gnutls_vec_push_func vec_func);

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie. it's literally a gnutls_session_t type. that's the whole vibe of this argument. 💅
  • gnutls_vec_push_func vec_func — a callback function, and it's the sibling-coded one, similar to writev(). 🌸

👑 DESCRIPTION 👑

okay so here's the tea: with this function you can override the default writev(2) function that gnutls uses to send data. You're the main character now, you pick how the bytes leave the building. 💫

And listen — setting this callback instead of using gnutls_transport_set_push_function() is recommended, because it introduces less overhead in the TLS handshake process. Less overhead, more slay. ✨

vec_func is of the form, and I'm gonna write it out exactly so nothing gets twisted:

ssize_t (*gnutls_vec_push_func)
   (gnutls_transport_ptr_t, const giovec_t * iov, int iovcnt);

⭐ SINCE ⭐

2.12.0 — she's been iconic since 2.12.0, no cap. 🫶

🐛 REPORTING BUGS 🐛

Found a bug? Not me manifesting, but if you did — report bugs 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. (Translation: yes you can copy it, just keep the receipt. 🧾)

🌈 SEE ALSO 🌈

The full documentation for gnutls is maintained as a Texinfo manual. So if the /usr/share/doc/gnutls/ directory does not contain the HTML form, bestie, visit:

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

and that's the whole page, periodt. 💖 this cutie came to you from gnutls 3.8.13, so go forth and push those vectors, you absolute icon. mwah! 💅✨

📦 where this page comes from