NAME

SHA3_Selftest — NIST FIPS PUB 202: SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions

LIBRARY

Message Digest (MD4, MD5, etc.) Support Library (libmd, -lmd)

SYNOPSIS

#include <sha3.h>

int
SHA3_Selftest(void);

DESCRIPTION

The SHA3_Selftest function automatically tests a number of SHA-3 computations on fixed inputs with with known outputs to make sure the sha3(3) library is not catastrophically broken. Applications should call SHA3_Selftest() and confirm that it succeeded before using the sha3(3), or shake(3) functions.

SHA3_Selftest() returns 0 if successful, or -1 if the self-test failed.

The SHA3_Selftest() function costs a few hundred thousand cycles on most CPUs, since it involves a little over a hundred calls to the Keccak permutation, which usually take one or two thousand cycles each.

SEE ALSO

sha3(3), shake(3)

STANDARDS

National Institute of Standards and Technology, SHA-3 Standard: Permutation-Based Hash and Extendable-Output Functions, August 2015, FIPS PUB 202.

AUTHORS

Taylor R Campbell ⟨campbell+sha3@mumble.net⟩