self_test.h 4.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. /*
  2. * Copyright 2019-2022 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_KAT_INTEGRITY "KAT_Integrity"
  30. # define OSSL_SELF_TEST_TYPE_KAT_CIPHER "KAT_Cipher"
  31. # define OSSL_SELF_TEST_TYPE_KAT_ASYM_CIPHER "KAT_AsymmetricCipher"
  32. # define OSSL_SELF_TEST_TYPE_KAT_DIGEST "KAT_Digest"
  33. # define OSSL_SELF_TEST_TYPE_KAT_SIGNATURE "KAT_Signature"
  34. # define OSSL_SELF_TEST_TYPE_PCT_SIGNATURE "PCT_Signature"
  35. # define OSSL_SELF_TEST_TYPE_KAT_KDF "KAT_KDF"
  36. # define OSSL_SELF_TEST_TYPE_KAT_KA "KAT_KA"
  37. # define OSSL_SELF_TEST_TYPE_DRBG "DRBG"
  38. /* Test event sub categories */
  39. # define OSSL_SELF_TEST_DESC_NONE "None"
  40. # define OSSL_SELF_TEST_DESC_INTEGRITY_HMAC "HMAC"
  41. # define OSSL_SELF_TEST_DESC_PCT_RSA_PKCS1 "RSA"
  42. # define OSSL_SELF_TEST_DESC_PCT_ECDSA "ECDSA"
  43. # define OSSL_SELF_TEST_DESC_PCT_DSA "DSA"
  44. # define OSSL_SELF_TEST_DESC_CIPHER_AES_GCM "AES_GCM"
  45. # define OSSL_SELF_TEST_DESC_CIPHER_AES_ECB "AES_ECB_Decrypt"
  46. # define OSSL_SELF_TEST_DESC_CIPHER_TDES "TDES"
  47. # define OSSL_SELF_TEST_DESC_ASYM_RSA_ENC "RSA_Encrypt"
  48. # define OSSL_SELF_TEST_DESC_ASYM_RSA_DEC "RSA_Decrypt"
  49. # define OSSL_SELF_TEST_DESC_MD_SHA1 "SHA1"
  50. # define OSSL_SELF_TEST_DESC_MD_SHA2 "SHA2"
  51. # define OSSL_SELF_TEST_DESC_MD_SHA3 "SHA3"
  52. # define OSSL_SELF_TEST_DESC_SIGN_DSA "DSA"
  53. # define OSSL_SELF_TEST_DESC_SIGN_RSA "RSA"
  54. # define OSSL_SELF_TEST_DESC_SIGN_ECDSA "ECDSA"
  55. # define OSSL_SELF_TEST_DESC_DRBG_CTR "CTR"
  56. # define OSSL_SELF_TEST_DESC_DRBG_HASH "HASH"
  57. # define OSSL_SELF_TEST_DESC_DRBG_HMAC "HMAC"
  58. # define OSSL_SELF_TEST_DESC_KA_DH "DH"
  59. # define OSSL_SELF_TEST_DESC_KA_ECDH "ECDH"
  60. # define OSSL_SELF_TEST_DESC_KDF_HKDF "HKDF"
  61. # define OSSL_SELF_TEST_DESC_KDF_SSKDF "SSKDF"
  62. # define OSSL_SELF_TEST_DESC_KDF_X963KDF "X963KDF"
  63. # define OSSL_SELF_TEST_DESC_KDF_X942KDF "X942KDF"
  64. # define OSSL_SELF_TEST_DESC_KDF_PBKDF2 "PBKDF2"
  65. # define OSSL_SELF_TEST_DESC_KDF_SSHKDF "SSHKDF"
  66. # define OSSL_SELF_TEST_DESC_KDF_TLS12_PRF "TLS12_PRF"
  67. # define OSSL_SELF_TEST_DESC_KDF_KBKDF "KBKDF"
  68. # define OSSL_SELF_TEST_DESC_KDF_TLS13_EXTRACT "TLS13_KDF_EXTRACT"
  69. # define OSSL_SELF_TEST_DESC_KDF_TLS13_EXPAND "TLS13_KDF_EXPAND"
  70. # define OSSL_SELF_TEST_DESC_RNG "RNG"
  71. void OSSL_SELF_TEST_set_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK *cb,
  72. void *cbarg);
  73. void OSSL_SELF_TEST_get_callback(OSSL_LIB_CTX *libctx, OSSL_CALLBACK **cb,
  74. void **cbarg);
  75. OSSL_SELF_TEST *OSSL_SELF_TEST_new(OSSL_CALLBACK *cb, void *cbarg);
  76. void OSSL_SELF_TEST_free(OSSL_SELF_TEST *st);
  77. void OSSL_SELF_TEST_onbegin(OSSL_SELF_TEST *st, const char *type,
  78. const char *desc);
  79. int OSSL_SELF_TEST_oncorrupt_byte(OSSL_SELF_TEST *st, unsigned char *bytes);
  80. void OSSL_SELF_TEST_onend(OSSL_SELF_TEST *st, int ret);
  81. # ifdef __cplusplus
  82. }
  83. # endif
  84. #endif /* OPENSSL_SELF_TEST_H */