1 /* 2 * Copyright 2019-2025 The OpenSSL Project Authors. All Rights Reserved. 3 * 4 * Licensed under the Apache License 2.0 (the "License"). You may not use 5 * this file except in compliance with the License. You can obtain a copy 6 * in the file LICENSE in the source distribution or at 7 * https://www.openssl.org/source/license.html 8 */ 9 10 #ifndef OPENSSL_SELF_TEST_H 11 #define OPENSSL_SELF_TEST_H 12 #pragma once 13 14 #include <openssl/core.h> /* OSSL_CALLBACK */ 15 16 #ifdef __cplusplus 17 extern "C" { 18 #endif 19 20 /* The test event phases */ 21 #define OSSL_SELF_TEST_PHASE_NONE "None" 22 #define OSSL_SELF_TEST_PHASE_START "Start" 23 #define OSSL_SELF_TEST_PHASE_CORRUPT "Corrupt" 24 #define OSSL_SELF_TEST_PHASE_PASS "Pass" 25 #define OSSL_SELF_TEST_PHASE_FAIL "Fail" 26 27 /* Test event categories */ 28 #define OSSL_SELF_TEST_TYPE_NONE "None" 29 #define OSSL_SELF_TEST_TYPE_MODULE_INTEGRITY "Module_Integrity" 30 #define OSSL_SELF_TEST_TYPE_INSTALL_INTEGRITY "Install_Integrity" 31 #define OSSL_SELF_TEST_TYPE_CRNG "Continuous_RNG_Test" 32 #define OSSL_SELF_TEST_TYPE_PCT "Conditional_PCT" 33 #define OSSL_SELF_TEST_TYPE_PCT_KAT "Conditional_KAT" 34 #define OSSL_SELF_TEST_TYPE_PCT_IMPORT "Import_PCT" 35 #define OSSL_SELF_TEST_TYPE_KAT_INTEGRITY "KAT_Integrity" 36 #define OSSL_SELF_TEST_TYPE_KAT_CIPHER "KAT_Cipher" 37 #define OSSL_SELF_TEST_TYPE_KAT_ASYM_CIPHER "KAT_AsymmetricCipher" 38 #define OSSL_SELF_TEST_TYPE_KAT_ASYM_KEYGEN "KAT_AsymmetricKeyGeneration" 39 #define OSSL_SELF_TEST_TYPE_KAT_KEM "KAT_KEM" 40 #define OSSL_SELF_TEST_TYPE_KAT_DIGEST "KAT_Digest" 41 #define OSSL_SELF_TEST_TYPE_KAT_SIGNATURE "KAT_Signature" 42 #define OSSL_SELF_TEST_TYPE_PCT_SIGNATURE "PCT_Signature" 43 #define OSSL_SELF_TEST_TYPE_KAT_KDF "KAT_KDF" 44 #define OSSL_SELF_TEST_TYPE_KAT_KA "KAT_KA" 45 #define OSSL_SELF_TEST_TYPE_DRBG "DRBG" 46 47 /* Test event sub categories */ 48 #define OSSL_SELF_TEST_DESC_NONE "None" 49 #define OSSL_SELF_TEST_DESC_INTEGRITY_HMAC "HMAC" 50 #define OSSL_SELF_TEST_DESC_PCT_RSA "RSA" 51 #define OSSL_SELF_TEST_DESC_PCT_RSA_PKCS1 "RSA" 52 #define OSSL_SELF_TEST_DESC_PCT_ECDSA "ECDSA" 53 #define OSSL_SELF_TEST_DESC_PCT_EDDSA "EDDSA" 54 #define OSSL_SELF_TEST_DESC_PCT_DH "DH" 55 #define OSSL_SELF_TEST_DESC_PCT_DSA "DSA" 56 #define OSSL_SELF_TEST_DESC_PCT_ML_DSA "ML-DSA" 57 #define OSSL_SELF_TEST_DESC_PCT_ML_KEM "ML-KEM" 58 #define OSSL_SELF_TEST_DESC_PCT_SLH_DSA "SLH-DSA" 59 #define OSSL_SELF_TEST_DESC_CIPHER_AES_GCM "AES_GCM" 60 #define OSSL_SELF_TEST_DESC_CIPHER_AES_ECB "AES_ECB_Decrypt" 61 #define OSSL_SELF_TEST_DESC_CIPHER_TDES "TDES" 62 #define OSSL_SELF_TEST_DESC_ASYM_RSA_ENC "RSA_Encrypt" 63 #define OSSL_SELF_TEST_DESC_ASYM_RSA_DEC "RSA_Decrypt" 64 #define OSSL_SELF_TEST_DESC_MD_SHA1 "SHA1" 65 #define OSSL_SELF_TEST_DESC_MD_SHA2 "SHA2" 66 #define OSSL_SELF_TEST_DESC_MD_SHA3 "SHA3" 67 #define OSSL_SELF_TEST_DESC_SIGN_DSA "DSA" 68 #define OSSL_SELF_TEST_DESC_SIGN_RSA "RSA" 69 #define OSSL_SELF_TEST_DESC_SIGN_ECDSA "ECDSA" 70 #define OSSL_SELF_TEST_DESC_SIGN_EDDSA "EDDSA" 71 #define OSSL_SELF_TEST_DESC_SIGN_ML_DSA "ML-DSA" 72 #define OSSL_SELF_TEST_DESC_SIGN_SLH_DSA "SLH-DSA" 73 #define OSSL_SELF_TEST_DESC_KEM "KEM" 74 #define OSSL_SELF_TEST_DESC_DRBG_CTR "CTR" 75 #define OSSL_SELF_TEST_DESC_DRBG_HASH "HASH" 76 #define OSSL_SELF_TEST_DESC_DRBG_HMAC "HMAC" 77 #define OSSL_SELF_TEST_DESC_KA_DH "DH" 78 #define OSSL_SELF_TEST_DESC_KA_ECDH "ECDH" 79 #define OSSL_SELF_TEST_DESC_KDF_HKDF "HKDF" 80 #define OSSL_SELF_TEST_DESC_KDF_SSKDF "SSKDF" 81 #define OSSL_SELF_TEST_DESC_KDF_X963KDF "X963KDF" 82 #define OSSL_SELF_TEST_DESC_KDF_X942KDF "X942KDF" 83 #define OSSL_SELF_TEST_DESC_KDF_PBKDF2 "PBKDF2" 84 #define OSSL_SELF_TEST_DESC_KDF_SSHKDF "SSHKDF" 85 #define OSSL_SELF_TEST_DESC_KDF_TLS12_PRF "TLS12_PRF" 86 #define OSSL_SELF_TEST_DESC_KDF_KBKDF "KBKDF" 87 #define OSSL_SELF_TEST_DESC_KDF_KBKDF_KMAC "KBKDF_KMAC" 88 #define OSSL_SELF_TEST_DESC_KDF_TLS13_EXTRACT "TLS13_KDF_EXTRACT" 89 #define OSSL_SELF_TEST_DESC_KDF_TLS13_EXPAND "TLS13_KDF_EXPAND" 90 #define OSSL_SELF_TEST_DESC_RNG "RNG" 91 #define OSSL_SELF_TEST_DESC_KEYGEN_ML_DSA "ML-DSA" 92 #define OSSL_SELF_TEST_DESC_KEYGEN_ML_KEM "ML-KEM" 93 #define OSSL_SELF_TEST_DESC_KEYGEN_SLH_DSA "SLH-DSA" 94 #define OSSL_SELF_TEST_DESC_ENCAP_KEM "KEM_Encap" 95 #define OSSL_SELF_TEST_DESC_DECAP_KEM "KEM_Decap" 96 #define OSSL_SELF_TEST_DESC_DECAP_KEM_FAIL "KEM_Decap_Reject" 97 98 void OSSL_SELF_TEST_set_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK *cb, 99 void *cbarg); 100 void OSSL_SELF_TEST_get_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK **cb, 101 void **cbarg); 102 103 OSSL_SELF_TEST *OSSL_SELF_TEST_new(OSSL_CALLBACK *cb, void *cbarg); 104 void OSSL_SELF_TEST_free(OSSL_SELF_TEST *st); 105 106 void OSSL_SELF_TEST_onbegin(OSSL_SELF_TEST *st, const char *type, 107 const char *desc); 108 int OSSL_SELF_TEST_oncorrupt_byte(OSSL_SELF_TEST *st, unsigned char *bytes); 109 void OSSL_SELF_TEST_onend(OSSL_SELF_TEST *st, int ret); 110 111 #ifdef __cplusplus 112 } 113 #endif 114 #endif /* OPENSSL_SELF_TEST_H */ 115