gnutls_hmac_init(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_init 💖

okay bestie, we're in the gnutls manual — page gnutls_hmac_init(3) — and honestly? this one is a lil bop. it's an API function, she's been around since forever, and she's here to set you up to make MACs. let's get into it 🫶

✨ NAME ✨

gnutls_hmac_init — the API function that starts the whole MAC party 🎀

🌸 SYNOPSIS 🌸

#include <gnutls/crypto.h>

int gnutls_hmac_init(gnutls_hmac_hd_t * dig, gnutls_mac_algorithm_t
algorithm, const void * key, size_t keylen);

yes, that's the whole vibe. four args, one int back. slay 💅

🦋 ARGUMENTS 🦋

  • gnutls_hmac_hd_t * dig — this one is a gnutls_hmac_hd_t type, bestie. she's the handle, she's the one holding the state, main character energy fr.
  • gnutls_mac_algorithm_t algorithm — the HMAC algorithm you wanna use. pick your fighter 🌈
  • const void * key — the key that's gonna be used for encryption 🔑
  • size_t keylen — the length of the key. yes, you gotta tell it. no, it will not guess. periodt.

💫 DESCRIPTION 💫

So what this does is it initializes a context that you can then use to produce a Message Authentication Code (MAC) of data. and the way it does that? it uses whatever crypto backend gnutls currently has in play, or the cryptographic accelerator that's in use. like, it just taps into the current setup, no cap ✨

Important lil note, and I mean it: despite the name of this function — and yes the name says HMAC — it can be used for other MAC algorithms than HMAC. the name is not the whole story. she contains multitudes 💜

👑 RETURNS 👑

Zero, or a negative error code on error. that's it, that's the tea. 0 means we're good, anything negative means something went sideways 😭

⭐ SINCE ⭐

2.10.0 — an icon. been here since 2.10.0 and she's still thriving 🧚

🙈 REPORTING BUGS 🙈

Found something cursed? Report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org

(the devs are lovely, they wanna hear about it, fr fr)

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 to copy, just keep the receipts. respect the notice and we're all good 🫶

🌈 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 the whole thing, it's giving encyclopedic and I'm obsessed 📚

okay that's the page!! this was gnutls_hmac_init(3) from the gnutls manual, 3.8.13 energy, and yeah — she ate, no crumbs. now go initialize that context and MAC some data, bestie 💖✨🎀🦋🌸💅

📦 where this page comes from