gnutls_cipher_tag(3)

✨ gnutls_cipher_tag(3) ✨

okay bestie, welcome to the gnutls manual 💖 this one lives in section 3 of the manual pages (that's the "library functions" section, iykyk) and it's all about grabbing the authentication tag off an AEAD cipher. let's get into it 🫶

---

🌸 NAME 🌸

gnutls_cipher_tag — literally just an API function, that's the whole name, no notes 💅

---

🦋 SYNOPSIS 🦋

#include <gnutls/crypto.h>

int gnutls_cipher_tag(gnutls_cipher_hd_t handle, void * tag, size_t
tag_size);

like, that's the whole vibe. three args, one int coming back at you ✨

---

🎀 ARGUMENTS 🎀

• gnutls_cipher_hd_t handle — bestie this is a gnutls_cipher_hd_t type. your cipher handle. the main character of this function fr fr 👑
• void * tag — this lil guy is gonna hold the tag. it's the destination. the tag goes in here 🍓
• size_t tag_size — the length of the tag you want returned. how many bytes of tag you're asking for 💫

---

💜 DESCRIPTION 💜

so here's the tea ☕ this function operates on authenticated encryption with associated data (AEAD) ciphers — you know, the fancy ones that do confidentiality and integrity — and it will return the output tag.

that's it. that's the function. it hands you the tag. no cap 🧚

ngl if you're not using an AEAD cipher, this is not your moment — the description is very clear that this is AEAD territory only 💀

---

🌈 RETURNS 🌈

Zero on success, or a negative error code on error. so like, check your return value, bestie, please 😭

---

⭐ SINCE ⭐

3.0 — she's been iconic since 3.0, we love a long-running queen 👑

---

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, report it to <bugs@gnutls.org> 🐛

Home page: https://www.gnutls.org — go say hi 🫶

---

💖 COPYRIGHT 💖

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, copy away, 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/

like, the whole manual is right there, go read it, it's giving ✨ educated ✨ 💅

---

and that's the page bestie!! this one's from gnutls version 3.8.13, gnutls_cipher_tag(3), section 3, library functions, periodt 💖🎀🦋✨