gnutls_crypto_register_digest(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_crypto_register_digest — API function 🎀

okay so bestie, this one lives in the gnutls manual and it's literally called gnutls_crypto_register_digest. she's giving "let me plug my own hash into the crypto stack" energy, and honestly? iconic. let's get into it 💖

✨ NAME ✨

gnutls_crypto_register_digest — API function. yeah that's it, that's the whole vibe. 🦋

🌸 SYNOPSIS 🌸

#include <gnutls/crypto.h>

int gnutls_crypto_register_digest(gnutls_digest_algorithm_t algorithm,
int priority, gnutls_digest_init_func init, gnutls_digest_hash_func
hash, gnutls_digest_output_func output, gnutls_digest_deinit_func
deinit, gnutls_digest_fast_func hash_fast);

💜 ARGUMENTS 💜

  • gnutls_digest_algorithm_t algorithm — the gnutls digest identifier, aka which digest you're claiming. no cap. 🔥
  • int priority — the priority of the algorithm. yes queen, she has a rank.
  • gnutls_digest_init_func init — a function which initializes the digest. warm-up era. ✨
  • gnutls_digest_hash_func hash — perform the hash operation. the main character moment. 👑
  • gnutls_digest_output_func output — provide the output of the digest. serving results, periodt.
  • gnutls_digest_deinit_func deinit — a function which deinitializes the digest. she's logging off, respectfully. 🫶
  • gnutls_digest_fast_func hash_fast — perform the digest operation in one go. speedrun mode fr fr. ⭐

🌈 DESCRIPTION 🌈

so basically this function will register a digest algorithm to be used by gnutls. your algorithm, your rules, your moment 💅

any algorithm you register will override the included algorithms — and by convention, kernel implemented algorithms have a priority of 90 and CPU-assisted have a priority of 80. noting that down, bestie, because it matters:

the algorithm with the lowest priority will be used by gnutls. lowest = winner. yes it's backwards from what you'd expect and yes it's still the rule. 🧚

😭 DEPRECATED 😭

not me having to tell you this… since 3.7.0 it is no longer possible to override cipher implementation. 💀

read that again, bestie. deprecated. the override door? closed. 🙈

⭐ RETURNS ⭐

GNUTLS_E_SUCCESS on success, otherwise a negative error code. so if you see a negative number, that's not a vibe check you passed. 😭

🦋 SINCE 🦋

3.4.0 — she's been around a minute, an OG. 🎀

🐛 REPORTING BUGS 🐛

found a bug? spill it, don't sit on it:

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. free as in go off, 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/

iykyk. go read the whole manual, she's long but she's worth it. 🌸

okay that's the whole page, bestie — every flag, every default, every warning, all of it, nothing skipped. and for the cute sign-off: this was gnutls version 3.8.13, serving gnutls_crypto_register_digest(3) realness. mwah. 💅✨

📦 where this page comes from