libkeccak_state_free(3)

libkeccak_state_free3

Destroys and deallocates a hash state with erasure

Usage

#include <libkeccak.h>
void libkeccak_state_free(struct libkeccak_state *state);

Link with -lkeccak.

Overview

The libkeccak_state_free() function releases the allocations stored in *state, and also release the allocation of state.

The libkeccak_state_free() function securely erases sensitive data.

Return values

The libkeccak_state_free() function does not return any value.

Errors

The libkeccak_state_free() function cannot fail.

Notes

A double call to libkeccak_state_free() will either result in a double free, which is must likely to crash the process, or free an allocation (that was created between the calls) that was not intended to be freed, resulting in undefined behaviour.

From libkeccak 1.4.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.