| | 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_KAT_INTEGRITY "KAT_Integrity" |
| | 35 | # define OSSL_SELF_TEST_TYPE_KAT_CIPHER "KAT_Cipher" |
| | 36 | # define OSSL_SELF_TEST_TYPE_KAT_ASYM_CIPHER "KAT_AsymmetricCipher" |
| | 37 | # define OSSL_SELF_TEST_TYPE_KAT_ASYM_KEYGEN "KAT_AsymmetricKeyGeneration" |
| | 38 | # define OSSL_SELF_TEST_TYPE_KAT_KEM "KAT_KEM" |
| | 39 | # define OSSL_SELF_TEST_TYPE_KAT_DIGEST "KAT_Digest" |
| | 40 | # define OSSL_SELF_TEST_TYPE_KAT_SIGNATURE "KAT_Signature" |
| | 41 | # define OSSL_SELF_TEST_TYPE_PCT_SIGNATURE "PCT_Signature" |
| | 42 | # define OSSL_SELF_TEST_TYPE_KAT_KDF "KAT_KDF" |
| | 43 | # define OSSL_SELF_TEST_TYPE_KAT_KA "KAT_KA" |
| | 44 | # define OSSL_SELF_TEST_TYPE_DRBG "DRBG" |
| | 45 | |
| | 46 | /* Test event sub categories */ |
| | 47 | # define OSSL_SELF_TEST_DESC_NONE "None" |
| | 48 | # define OSSL_SELF_TEST_DESC_INTEGRITY_HMAC "HMAC" |
| | 49 | # define OSSL_SELF_TEST_DESC_PCT_RSA "RSA" |
| | 50 | # define OSSL_SELF_TEST_DESC_PCT_RSA_PKCS1 "RSA" |
| | 51 | # define OSSL_SELF_TEST_DESC_PCT_ECDSA "ECDSA" |
| | 52 | # define OSSL_SELF_TEST_DESC_PCT_EDDSA "EDDSA" |
| | 53 | # define OSSL_SELF_TEST_DESC_PCT_DSA "DSA" |
| | 54 | # define OSSL_SELF_TEST_DESC_PCT_ML_DSA "ML-DSA" |
| | 55 | # define OSSL_SELF_TEST_DESC_PCT_ML_KEM "ML-KEM" |
| | 56 | # define OSSL_SELF_TEST_DESC_PCT_SLH_DSA "SLH-DSA" |
| | 57 | # define OSSL_SELF_TEST_DESC_CIPHER_AES_GCM "AES_GCM" |
| | 58 | # define OSSL_SELF_TEST_DESC_CIPHER_AES_ECB "AES_ECB_Decrypt" |
| | 59 | # define OSSL_SELF_TEST_DESC_CIPHER_TDES "TDES" |
| | 60 | # define OSSL_SELF_TEST_DESC_ASYM_RSA_ENC "RSA_Encrypt" |
| | 61 | # define OSSL_SELF_TEST_DESC_ASYM_RSA_DEC "RSA_Decrypt" |
| | 62 | # define OSSL_SELF_TEST_DESC_MD_SHA1 "SHA1" |
| | 63 | # define OSSL_SELF_TEST_DESC_MD_SHA2 "SHA2" |
| | 64 | # define OSSL_SELF_TEST_DESC_MD_SHA3 "SHA3" |
| | 65 | # define OSSL_SELF_TEST_DESC_SIGN_DSA "DSA" |
| | 66 | # define OSSL_SELF_TEST_DESC_SIGN_RSA "RSA" |
| | 67 | # define OSSL_SELF_TEST_DESC_SIGN_ECDSA "ECDSA" |
| | 68 | # define OSSL_SELF_TEST_DESC_SIGN_EDDSA "EDDSA" |
| | 69 | # define OSSL_SELF_TEST_DESC_SIGN_ML_DSA "ML-DSA" |
| | 70 | # define OSSL_SELF_TEST_DESC_SIGN_SLH_DSA "SLH-DSA" |
| | 71 | # define OSSL_SELF_TEST_DESC_KEM "KEM" |
| | 72 | # define OSSL_SELF_TEST_DESC_DRBG_CTR "CTR" |
| | 73 | # define OSSL_SELF_TEST_DESC_DRBG_HASH "HASH" |
| | 74 | # define OSSL_SELF_TEST_DESC_DRBG_HMAC "HMAC" |
| | 75 | # define OSSL_SELF_TEST_DESC_KA_DH "DH" |
| | 76 | # define OSSL_SELF_TEST_DESC_KA_ECDH "ECDH" |
| | 77 | # define OSSL_SELF_TEST_DESC_KDF_HKDF "HKDF" |
| | 78 | # define OSSL_SELF_TEST_DESC_KDF_SSKDF "SSKDF" |
| | 79 | # define OSSL_SELF_TEST_DESC_KDF_X963KDF "X963KDF" |
| | 80 | # define OSSL_SELF_TEST_DESC_KDF_X942KDF "X942KDF" |
| | 81 | # define OSSL_SELF_TEST_DESC_KDF_PBKDF2 "PBKDF2" |
| | 82 | # define OSSL_SELF_TEST_DESC_KDF_SSHKDF "SSHKDF" |
| | 83 | # define OSSL_SELF_TEST_DESC_KDF_TLS12_PRF "TLS12_PRF" |
| | 84 | # define OSSL_SELF_TEST_DESC_KDF_KBKDF "KBKDF" |
| | 85 | # define OSSL_SELF_TEST_DESC_KDF_KBKDF_KMAC "KBKDF_KMAC" |
| | 86 | # define OSSL_SELF_TEST_DESC_KDF_TLS13_EXTRACT "TLS13_KDF_EXTRACT" |
| | 87 | # define OSSL_SELF_TEST_DESC_KDF_TLS13_EXPAND "TLS13_KDF_EXPAND" |
| | 88 | # define OSSL_SELF_TEST_DESC_RNG "RNG" |
| | 89 | # define OSSL_SELF_TEST_DESC_KEYGEN_ML_DSA "ML-DSA" |
| | 90 | # define OSSL_SELF_TEST_DESC_KEYGEN_ML_KEM "ML-KEM" |
| | 91 | # define OSSL_SELF_TEST_DESC_KEYGEN_SLH_DSA "SLH-DSA" |
| | 92 | # define OSSL_SELF_TEST_DESC_ENCAP_KEM "KEM_Encap" |
| | 93 | # define OSSL_SELF_TEST_DESC_DECAP_KEM "KEM_Decap" |
| | 94 | # define OSSL_SELF_TEST_DESC_DECAP_KEM_FAIL "KEM_Decap_Reject" |
| | 95 | |
| | 96 | void OSSL_SELF_TEST_set_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK *cb, |
| | 97 | void *cbarg); |
| | 98 | void OSSL_SELF_TEST_get_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK **cb, |
| | 99 | void **cbarg); |
| | 100 | |
| | 101 | OSSL_SELF_TEST *OSSL_SELF_TEST_new(OSSL_CALLBACK *cb, void *cbarg); |
| | 102 | void OSSL_SELF_TEST_free(OSSL_SELF_TEST *st); |
| | 103 | |
| | 104 | void OSSL_SELF_TEST_onbegin(OSSL_SELF_TEST *st, const char *type, |
| | 105 | const char *desc); |
| | 106 | int OSSL_SELF_TEST_oncorrupt_byte(OSSL_SELF_TEST *st, unsigned char *bytes); |
| | 107 | void OSSL_SELF_TEST_onend(OSSL_SELF_TEST *st, int ret); |
| | 108 | |
| | 109 | # ifdef __cplusplus |
| | 110 | } |
| | 111 | # endif |
| | 112 | #endif /* OPENSSL_SELF_TEST_H */ |
projects / thirdparty / openssl.git / blame_incremental