gnutls_hmac_deinit(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_hmac_deinit(3) — the gnutls girlie's guide 💖

okay bestie, this page lives in the gnutls manual, and it's about the one thing nobody wants to do but everybody gotta do: cleaning up after yourself ✨

🎀 NAME 🎀

gnutls_hmac_deinit — it's an API function, and it's the goodbye kiss for your HMAC context 💋

✨ SYNOPSIS ✨

#include <gnutls/crypto.h>

void gnutls_hmac_deinit(gnutls_hmac_hd_t handle, void * digest);

no cap, that's the whole thing. she takes two things and returns absolutely nothing (void girlies stay unbothered 💅).

🫶 ARGUMENTS 🫶

  • gnutls_hmac_hd_t handle — this is a gnutls_hmac_hd_t type. that's it, that's the description, that's literally what the manpage says. she's a handle, she's your context, she's the main character of this function 🌸
  • void * digest — this is the output value of the MAC. so when you deinit, the MAC result lands here, bestie. don't forget to point her somewhere valid 🦋

💜 DESCRIPTION 💜

so here's the tea: this function will deinitialize all resources occupied by the given hmac context. like, all of them. the hmac context has been holding onto stuff this whole time and this is where you let it go, gently, with love 🕊️

think of it as the "thanks for coming to my TED talk" moment. you built the context, you used it, you got your MAC out, and now you free the resources so nothing leaks. it's giving responsible memory management. it's giving adulting. obsessed 😭

bestie note: the MAC output goes into the digest argument, so make sure that's a real place to write before you call this. no dangling pointers in this house 🙈

⭐ SINCE ⭐

2.10.0 — so she's been around a minute. vintage, but make it iconic 👑

🔥 REPORTING BUGS 🔥

found something cursed? spill to the devs, they actually want to know:

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. like, free real estate, but 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/

go read it, it's lowkey a whole library and it's highkey worth it 📚✨

and that's the vibe check for today, bestie 💅 this page came to you courtesy of gnutls 3.8.13 — go forth, deinit your contexts, and hydrate. mwah 🫶🎀🦋

📦 where this page comes from