gnutls_hash_copy(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_hash_copy(3) ✨

okay bestie, pull up a chair 💖 this one lives in the gnutls manual (the 3.8.13 era, we'll get to that at the end) and it's genuinely so useful. let's go 🫶

🎀 NAME 🎀

gnutls_hash_copy — and it is literally an API function, no cap 💅

🌸 SYNOPSIS 🌸

#include <gnutls/crypto.h>

gnutls_hash_hd_t gnutls_hash_copy(gnutls_hash_hd_t handle);

like... that's it. one include, one function, one lil handle going in and one lil handle coming out 🦋

🍓 ARGUMENTS 🍓

  • gnutls_hash_hd_t handle — bestie this is a gnutls_hash_hd_t type. that's the whole description. the manpage said what it said and we respect it 🙈

💜 DESCRIPTION 💜

okay so here's the vibe: this function creates a copy of a Message Digest context, and the copy contains all its current state. like, the whole snapshot. the energy, the progress, everything. icon status ⭐

but — and this is the important part, don't skip it — copying contexts for Message Digests that were registered using gnutls_crypto_register_digest() is not supported and will always result in an error. periodt. 💀

and on top of that? some of the Message Digest implementations just... don't support this operation either. so it's giving "it depends". 😭

so applications should check the return value and provide a proper fallback. fr fr, do not skip the check. that's not a suggestion, that's the whole assignment. 👑

🔥 RETURNS 🔥

a new Message Digest context ✨ — or NULL in case of an error. that's it, that's the return. check it. love it. handle it. 💅

🌈 SINCE 🌈

3.6.9 — so it's been around a minute, it's a classic, it ate 🎀

🦋 REPORTING BUGS 🦋

found something cursed? tell the devs, they wanna 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.

💖 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 🧚 mwah 💋 this was the gnutls manual, version 3.8.13, and gnutls_hash_copy(3) says bye 👋💕

📦 where this page comes from