LIBKECCAK_STATE_DUPLICATE(3)

🌸 NAME 🌸

Okay bestie, this is the LIBKECCAK_STATE_DUPLICATE(3) page from the Library Functions Manual, and it is literally about one thing: allocating a duplicate hash state. Slay. 💅

🦋 SYNOPSIS 🦋

#include <libkeccak.h>

struct libkeccak_state *libkeccak_state_duplicate(const struct libkeccak_state *src);

Link with -lkeccakP.

✨ DESCRIPTION ✨

So libkeccak_state_duplicate() allocates a new hash state and initialises it to be identical to *src. Not similar, not "close enough" — identical identical, bestie 🫶.

That means all members of the struct libkeccak_state structure get duplicated, including the state of the sponge and the message chunk buffer. The way it copies the whole struct is highkey main character energy 👑.

🎀 RETURN VALUES 🎀

On successful completion, libkeccak_state_duplicate() returns a newly allocated struct libkeccak_state* (of one initialised element). Iconic, no notes. ✨

On error, NULL is returned and errno is set to describe the error. Sad girl hours, but at least it tells you why 😭.

💀 ERRORS 💀

The libkeccak_state_duplicate() function may fail for any reason specified for the function malloc(3). So like, malloc stuff can happen — that's the whole mood. 🫡

🔥 SEE ALSO 🔥

• libkeccak_state_copy(3)
• libkeccak_state_create(3)

Byeee from the LIBKECCAK manual — source/version LIBKECCAK, plus the footer date as printed, mwah 🎀💖✨