self_test.h 4.7 KB

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