gnutls_cipher_add_auth(3)

πŸ’– gnutls_cipher_add_auth(3) πŸ’–

okay bestie, so this one lives in the gnutls manual section β€” it's an API function, and yes it's exactly as niche and exactly as powerful as it sounds 🫢


✨ NAME ✨

gnutls_cipher_add_auth β€” API function, aka the little guy who does the "authenticate this please" job πŸ”₯


🌸 SYNOPSIS 🌸

#include <gnutls/crypto.h>

int gnutls_cipher_add_auth(gnutls_cipher_hd_t handle, const void *
ptext, size_t ptext_size);

πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_cipher_hd_t handle β€” it's a gnutls_cipher_hd_t type. that's the whole vibe. your handle, your main character πŸ‘‘
  • const void * ptext β€” the data to be authenticated. the actual content getting the vibe check πŸ’…
  • size_t ptext_size β€” the length of the data. how many bytes we're talking about, fr fr πŸ“

πŸ’« DESCRIPTION πŸ’«

So here's the tea: this function operates on authenticated encryption with associated data (AEAD) ciphers, and it authenticates the input data. that's it. that's the job. no encryption happening here, just authentication ✨

⚠️ bestie, listen β€” this function can only be called once, and it has to happen before any encryption operations. once. before. that's the rule and it's not negotiable 😭

🌈 RETURNS 🌈

Zero, or a negative error code on error. that's it. zero = slay, negative = something went wrong πŸ’€


⭐ SINCE ⭐

3.0 β€” she's been around, she's a legacy icon πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

Found a bug? don't suffer in silence, tell the people:

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. (yes, legal stuff, but it's giving generous πŸ’œ)


πŸ“ 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!! go forth and authenticate responsibly πŸ§šπŸ’–

this was gnutls_cipher_add_auth(3) from gnutls 3.8.13 β€” sending u love from the man pages, mwah πŸ’…βœ¨

πŸ“¦ where this page comes from