gnutls_aead_cipher_encryptv2(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_aead_cipher_encryptv2 💖

okay bestie, welcome to the gnutls manual, this page is all about gnutls_aead_cipher_encryptv2(3) — yes the whole manual name is right there in the title, we're not hiding it, it's giving main character energy fr fr 🌸

✨ NAME ✨

gnutls_aead_cipher_encryptv2 — an API function, and no that's not a typo, that's literally what it is 🫶

🌈 SYNOPSIS 🌈

#include <gnutls/crypto.h>

int gnutls_aead_cipher_encryptv2(gnutls_aead_cipher_hd_t handle, const
void * nonce, size_t nonce_len, const giovec_t * auth_iov, int
auth_iovcnt, const giovec_t * iov, int iovcnt, void * tag, size_t *
tag_size);

like look at all those params, she's got a lot going on but she handles it 💅

🎀 ARGUMENTS 🎀

  • gnutls_aead_cipher_hd_t handle — bestie this is a gnutls_aead_cipher_hd_t type, that's the whole vibe.
  • const void * nonce — the nonce you wanna set.
  • size_t nonce_len — the length of that nonce. yes we need it, don't skip it 🙈
  • const giovec_t * auth_iov — additional data that's gonna get authenticated.
  • int auth_iovcnt — how many buffers are chilling in auth_iov.
  • const giovec_t * iov — the data that's getting encrypted ✨
  • int iovcnt — how many buffers are in iov.
  • void * tag — the authentication tag.
  • size_t * tag_size — the size of the tag you wanna use (and if you pass zero, you get the default, iconic).

💫 DESCRIPTION 💫

so this one is similar to gnutls_aead_cipher_encrypt(), except — and this is the whole point — it does in-place encryption on the data buffers you hand it. like, it's encrypting right there in the buffers you gave it, no cap 🔥

⭐ RETURNS ⭐

zero, or a negative error code if things went wrong 😭 periodt.

🦋 SINCE 🦋

3.6.10 — she's been around, she's established 💜

🍓 REPORTING BUGS 🍓

found a bug? not cute. tell the people:

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: you can copy and share this file, modified or not, in any medium, no royalty needed — just keep the copyright notice and this notice with it 💖)

🌸 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/

and that's the whole page bestie, you ate that 🫶 this was gnutls version 3.8.13, brought to you by the gnutls manual, mwah 💅✨

📦 where this page comes from