selftest.h File Reference

Symmetric functions self-test. More...

#include "common.h"

Go to the source code of this file.

Functions
QSC_EXPORT_API bool	qsc_selftest_aes_test (void)
	Tests the AES cipher for correct operation.
QSC_EXPORT_API bool	qsc_selftest_chacha_test (void)
	Tests the ChaCha cipher for correct operation.
QSC_EXPORT_API bool	qsc_selftest_csx_test (void)
	Tests the CSX cipher for correct operation.
QSC_EXPORT_API bool	qsc_selftest_rcs_test (void)
	Tests the RCS cipher for correct operation.
QSC_EXPORT_API bool	qsc_selftest_sha2_test (void)
	Tests the SHA2 digests, HKDF and HMAC for correct operation.
QSC_EXPORT_API bool	qsc_selftest_sha3_test (void)
	Tests the SHA3 digests, SHAKE, cSHAKE, and KMAC for correct operation.
QSC_EXPORT_API bool	qsc_selftest_symmetric_run (void)
	Runs the library self tests.

Detailed Description

Symmetric functions self-test.

This header provides self-test functions for the cryptographic library's symmetric primitives including AES, ChaCha, CSX, RCS, SHA2, and SHA3 implementations. These tests perform known-answer tests (KATs) to verify correct operation of the implementations.

Function Documentation

qsc_selftest_aes_test()

QSC_EXPORT_API bool qsc_selftest_aes_test

(

void

)

Tests the AES cipher for correct operation.

Returns

[bool] Returns true if the AES test passes.

qsc_selftest_chacha_test()

QSC_EXPORT_API bool qsc_selftest_chacha_test

(

void

)

Tests the ChaCha cipher for correct operation.

Returns

[bool] Returns true if the ChaCha test passes.

qsc_selftest_csx_test()

QSC_EXPORT_API bool qsc_selftest_csx_test

(

void

)

Tests the CSX cipher for correct operation.

Returns

[bool] Returns true if the CSX test passes.

qsc_selftest_rcs_test()

QSC_EXPORT_API bool qsc_selftest_rcs_test

(

void

)

Tests the RCS cipher for correct operation.

Returns

[bool] Returns true if the RCS test passes.

qsc_selftest_sha2_test()

QSC_EXPORT_API bool qsc_selftest_sha2_test

(

void

)

Tests the SHA2 digests, HKDF and HMAC for correct operation.

Returns

[bool] Returns true if the SHA2 test passes.

qsc_selftest_sha3_test()

QSC_EXPORT_API bool qsc_selftest_sha3_test

(

void

)

Tests the SHA3 digests, SHAKE, cSHAKE, and KMAC for correct operation.

Returns

[bool] Returns true if the SHA3 test passes.

qsc_selftest_symmetric_run()

QSC_EXPORT_API bool qsc_selftest_symmetric_run

(

void

)

Runs the library self tests.

Tests the symmetric primitives with a set of known-answer tests.

Returns

[bool] Returns true if all tests pass successfully.